You have to follow simple rules to comment your code and with this tool you can easily build Amigaguide files with the documentation extracted from the soruce code.
At the bottom of this post you can download the appropriate distribution, you can choice from:
+--------------+
| INSTALLATION |----------------------------------------------------------
+--------------+
To install the program, uncompress in a drawer of your choice and ensure
that the provided fonts are installed on your system, if you wish, you can
put the provided fonts in the program drawer.
+--------------+
| INTRODUCTION |-----------------------------------------------------------
+--------------+
<GetDoc> is a tool that can be used to extract documentation stored in
a source code file.
The result of this operation is an AmigaGuide file with an index of all
nodes defined inside the source code.
You have to follow some simple rules described below:
| SINGLE LINE TAGS |
+------------------+
GetDoc supports the following tags to define some global informations:
<APP_NAME> Define the application's name
<APP_VERSION> Define the application's version
<APP_AUTHOR> Define the application's author
| MULTILINE TAGS |
+----------------+
Multiline tags are used to define the starting position of a new section (node)
all subsequent lines will be included in the defined node unless another
node is defined or the current one is explicitly terminated.
Here are the tags provided:
<NODE> Define a new node
<-8<---> Terminate the current node
| LINKS |
+-------+
Inside a node section you can define links with the tag LINK followed by
the name of a valid node.
These links will be listed all together at the end of the node.
+-------+
| NOTES |-----------------------------------------------------------------
+-------+
The -8<--- tag is usefull when you are documenting functions because you
can close the current node leaving out all code comments.
Actually this tool is written with Hollywood in mind but can handle all
languages that support single line comments.
Default is <;> but you can switch the comment type using the interface
of GetDoc.
+------------------+
| GETDOC INTERFACE |------------------------------------------------------
+------------------+
The interface is minimalist, there is a box for the source file and one for
the destination file, where your Amigaguide file will be saved.
There are three more options:
<Auto Open Guide> If you select this switch, when the process is terminated
the guide will be opened.
Remmber that if you select this option the program will
try to open the guide with Multiview (SYS:utilities/Multiview)
so this option is valid only for system that support/have
Multiview.
<Sort Master Index> This switch is used to alphabetically sort the master
index of all available nodes.
<Comment Type> Select here which type of single line comment you
want to parse in the selected source code.
When all is in place press the button <Extract Docs> and your Amigaguide file
will be generated.
+-------------+
| FINAL NOTES |------------------------------------------------------------
+-------------+
This tool was born because my need to have a simple tool to build documention
for ScuiLib.
Finally, GetDoc is written using Hollywood 3.1 and ScuiLib for the GUI.
