|
84736 packages online
|
|
|
|
dev/misc/getdoc_aros.lha |
|
No screenshot available
|
|
APP_NAME GetDoc
APP_VERSION 1.0
APP_AUTHOR Fabio Falcucci aka Allanon (hijoe()tin.it)
APP_RELEASE 13.06.2008
-----------------------------------------------------------------------------
+--------------+
| 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.
You can get more info and updates here:
http://sdb.freeforums.org/
Comments and suggestions are welcome! Please report any bugs you may encounter.
This program is free, please give me credits if you are using this tool
to build your own documentation.
This software is provided "as is", I'm not responsible for any data loss
GetDoc may cause.
---------------------------------------------------------------------------
Fabio Falcucci aka Allanon
hijoe()tin.it
---------------------------------------------------------------------------
Uploaded using: archives.aros-exec.org
|
Contents of dev/misc/getdoc_aros.lha
PERMSSN UID GID PACKED SIZE RATIO METHOD CRC STAMP NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic] 43 524 8.2% -lh5- a0b2 Jun 13 16:38 GetDocTmp/AROS/Fonts/diamond.font
[generic] 2054 3884 52.9% -lh5- d7fb Jun 13 16:38 GetDocTmp/AROS/Fonts/diamond/12
[generic] 3080 7188 42.8% -lh5- ea10 Jun 13 16:38 GetDocTmp/AROS/Fonts/diamond/20
[generic] 71 1564 4.5% -lh5- ded8 Jun 13 16:38 GetDocTmp/AROS/Fonts/helvetica.font
[generic] 1633 3000 54.4% -lh5- 8a6c Jun 13 16:38 GetDocTmp/AROS/Fonts/helvetica/11
[generic] 1799 3392 53.0% -lh5- 6fbd Jun 13 16:38 GetDocTmp/AROS/Fonts/helvetica/13
[generic] 2122 3936 53.9% -lh5- 7932 Jun 13 16:38 GetDocTmp/AROS/Fonts/helvetica/15
[generic] 2884 5228 55.2% -lh5- 08c6 Jun 13 16:38 GetDocTmp/AROS/Fonts/helvetica/18
[generic] 4057 7796 52.0% -lh5- ab8c Jun 13 16:38 GetDocTmp/AROS/Fonts/helvetica/24
[generic] 1328 2652 50.1% -lh5- 643a Jun 13 16:38 GetDocTmp/AROS/Fonts/helvetica/9
[generic] 29 264 11.0% -lh5- 2c13 Jun 13 16:38 GetDocTmp/AROS/Fonts/topaz.font
[generic] 1582 3192 49.6% -lh5- a059 Jun 13 16:38 GetDocTmp/AROS/Fonts/topaz/11
[generic] 498204 1272372 39.2% -lh5- 1ba6 Jun 13 16:38 GetDocTmp/AROS/GetDoc_AROS
---------- ----------- ------- ------- ------ ---------- ------------ -------------
Total 13 files 518886 1314992 39.5% Jul 3 15:55
|
|
|
|
Page generated in 0.02 seconds |
Aminet © 1992-2024 Urban
Müller and the Aminet team.
Aminet contact address: <aminetaminet net> |