Differences between revisions 14 and 29 (spanning 15 versions)
Revision 14 as of 2011-05-29 07:43:39
Size: 2884
Editor: KaiJaeger
Comment: Download changed to zip file
Revision 29 as of 2015-04-04 08:48:55
Size: 560
Editor: KaiJaeger
Comment: New version
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from UserCommand_Adoc
## page was renamed from UserCommandAdoc
= User Command ADOC (Dyalog) =
= User Command "Fire" =
Line 5: Line 4:
[[ADOC]] is a utility useful to generate documentation (semi-) automatically from class scripts as well as namespace scripts. Fire is a powerful utility designed to search and replace strings in a workspace. Fire stands for FInd and REplace.
Line 7: Line 6:
Obviously it makes sense to make ADOC's services available as a User Command.

This page offers a small class script `ADOC` which is designed to do exactly that.

== Assumptions ==
When User Commands got introduced in Dyalog with version 12.1, the User Commands where expected to reside in a sub folder `Salt\Spice` inside the Dyalog installation folder. This means that the script `ADOC.dyalog` attached to this page must go into this directory. Only then the User Commd "ADOC" is recognized. Note that this script only deal with two issues:

 * Figure out what command the user want to invoke, "Browse" or "List".
 * Find the real work horse and call it, see below.

That script which represents the ADOC User Command assumes that there is a sibling folder of your APL installation folder available named `UserCommands`. Please make sure that the real [[ADOC]] script is copied into this folder `UserCommands`. This enables the User Command script to address the real ADOC script `{MyDyalogInstallationFolder}..\UserCommands\ADOC`.

For example, in case your version of Dyalog APL 32bit is installed in `C:\Program Files (x86)\Dyalog\Dyalog APL 12.1 Unicode` which is the default on Windows 7 64 bit, then the folder `UserCommands` is supposed to be located at `C:\Program Files (x86)\Dyalog\UserCommands`.

== 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.zip | Download]] the script.
Fire is designed to be used as a User Command. Therefore the User Command script is part of the download of Fire itself. See [[Fire]] for details.
Line 60: Line 9:
The script is version 1.0.3 from 2011-01-24
You can download just the script from this page: [[attachment:Fire_UC.dyalog]]

This is version 1.2.0 from 2015-040-04.
Line 64: Line 16:
-- KaiJaeger <<DateTime(2012-03-21T09:03:31Z)>>

User Command "Fire"

Overview

Fire is a powerful utility designed to search and replace strings in a workspace. Fire stands for FInd and REplace.

Fire is designed to be used as a User Command. Therefore the User Command script is part of the download of Fire itself. See Fire for details.

Version

You can download just the script from this page: Fire_UC.dyalog

This is version 1.2.0 from 2015-040-04.

Author: KaiJaeger

-- KaiJaeger 2012-03-21 09:03:31


CategoryDyalogUserCommands

UserCommands/fire (last edited 2019-05-30 07:57:07 by KaiJaeger)