AminetAminet
Search:
84736 packages online
About
Recent
Browse
Search
Upload
Setup
Services

dev/misc/getdoc_aros.lha

Mirror:Random
Showing: m68k-amigaos iconppc-amigaos iconppc-morphos iconi386-aros iconi386-amithlon iconppc-warpup iconppc-powerup icongeneric icon
No screenshot available
Short:A Tool to extract source code docs
Author:Fabio Falcucci
Type:dev/misc
Version:1.0
Architecture:i386-aros
Date:2008-07-03
Download:dev/misc/getdoc_aros.lha - View contents
Readme:dev/misc/getdoc_aros.readme
Downloads:854

 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>