Differences between revisions 21 and 34 (spanning 13 versions)
Revision 21 as of 2011-08-05 12:04:48
Size: 1724
Editor: KaiJaeger
Comment: Tidied up
Revision 34 as of 2019-05-30 07:31:15
Size: 298
Editor: KaiJaeger
Comment:
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
== Overview ==
[[ADOC]] is a utility useful to generate documentation (semi-) automatically from class scripts as well as namespace scripts.
Line 5: Line 3:
Obviously it makes sense to make ADOC's services available as a User Command. Note that the ADOC user command project has relocated to !GitHub: https://github.com/aplteam/ADOC
Line 7: Line 5:
This page offers a small class script `ADOC` which is designed to do exactly that.

Refer to UserCommands/WhereShouldTheyGo for advice how to organize your User Commands.

== Samples ==
Given that the two different ADOC scripts went into the right folders, this would be a sample session:

{{{
      ]?ADOC
"??" for general help, "?CMD" for more specific info on command CMD

 Group Name Description
 ===== ==== ===========
 ADOC ADOC.Browse Creates full documentation and displayes it in the default browser.
        ADOC.HELP Displays help regarding ADOC.
        ADOC.List Prints syntax of all public stuff to the session.

      ]?ADOC.Browse
Command "ADOC.Browse". Syntax: 1 arguments; accepts switches -b=
Script location: ........\....\....\ADOC

Gathers information from a class script, compiles
an HTML page with these pieces of information
and displays it in your default browser.

      ]?ADOC.List
Command "ADOC.List".
Script location: ........\...\...\ADOC

Prints a list with all sorts of information to the session
about all public stuff given in the script specified in the right argument

]ADOC.Help
Watch your browser

Shows extensive information about ADOC. It's basically doing `ADOC.Browse ADOC`.
}}}

== Download ==

[[attachment:ADOC_UC.zip | Download]] the script.

== Version ==
The script is version 1.2.0 from 2011-08-04

Author: KaiJaeger
Since version 16.0 it became an official Dyalog user command and is therefore available with any standard installation of Dyalog APL.

User Command ADOC

Note that the ADOC user command project has relocated to GitHub: https://github.com/aplteam/ADOC

Since version 16.0 it became an official Dyalog user command and is therefore available with any standard installation of Dyalog APL.


CategoryDyalogUserCommands

UserCommands/Adoc (last edited 2019-05-30 07:31:15 by KaiJaeger)