ADOC

(Hide table-of-contents)

ADOC is part of the CategoryAplTree project.

ADOC is discussed in detail in this article on Vector from 2012.

1. Overview

With OO in Dyalog APL, the demand for documentation is increasing.

How's that? Well, objects are designed to act as 'black boxes'. They offer methods and properties and fields that let the user manipulate data without understanding all (or even any) details of the implementation.

But how to find out what can be used? Looking into the script, or using the Tracer when using a class is definitely not a good idea: you won't see the forest for trees. In order to take advantage of OO you should look only at the public stuff.

All fields, properties and methods of type Instance remain invisible until you create an instance; in order to create an instance you might need the documentation...

ADOC extracts all sorts of information from a class or interface no matter whether they are of type Instance or Shared and compiles an HTML page from them.

2. How to get ADOC

At the end of this page you can find the download links.

3. How to use ADOC

It is strongly recommended to use ADOC as a user command; a user command script is part of the download.

See UserCommands/WhereShouldTheyGo for details how to make ADOC available as a user command.

4. Process #.ADOC with #.ADOC

In the following examples we assume that you have loaded the ADOC workspace. That allows us to use ADOC on itself.

4.1. The "List" Command

You can ask ADOC to document itself. To get a short list of the public interface:

      ADOC.List ADOC
*** ADOC (Class) ***

Constructors:
  make_1(fullDocName)
  make_2(fullDocName caption)
  ...
Instance Properties:
  htmlFinalised (ReadOnly)
  ...
Shared Properties:
  BrowserName
  ...
Shared Fields:
  _Caption
  ...
Instance Methods:
  Analyze
  ...
Shared Methods:
  Browse
  ...

4.2. The "'Full' List" Command

You can ask ADOC about the syntax of the methods by specifying a left argument:

      'full' ADOC.List ADOC
*** ADOC (Class) ***

Constructors:
  make_1(fullDocName)
  make_2(fullDocName caption)
  ...
Instance Properties:
  htmlFinalised (ReadOnly)
  ...
Shared Properties:
  BrowserName
  ...
Shared Fields:
  _Caption
  ...
Instance Methods:
  {embeddedClassName} Analyze scriptName
  ...
Shared Methods:
  {x} Browse scriptRef
  ...

4.3. The "Browse" Command

To display the fully-fledged documentation as an HTML page with your default browser:

ADOC.Browse ADOC

5. An Example

Look here for an example of what ADOC is generating then:

ADOC.HTML

You need to download the HTML file and then view it with your browser.

Notes:

6. Project Page

For bug reports, future enhancements and a full version history see ADOC/ProjectPage

7. Version Information

Original author:

KaiJaeger

Responsible:

KaiJaeger

Email:

kai@aplteam.com

8. APLTree downloads

8.1. Using an APLTree member

  1. If you just want to consume (use) an APLTree member then you have several choices:
    • Note that accessing it via ftp allows you to download older versions as well while the dedicated download page offers just the most current version.

8.2. Contributing

If you want to contribute to an APLTree project see HowToContributeToTheAPLTreeProject for details.

8.3. Get the full project

If for some reason you need access to, say, the test cases then you need to get more then just the script (or application) itself.

HowToContributeToTheAPLTreeProject explains how to get a project onto your local machine. Just ignore any additional steps.

8.4. Create a new APLTree sub project

In order to create a new APLTree project you need some advice. Ask KaiJaeger for help: mailto:kai@aplteam.com


CategoryAplTree

ADOC (last edited 2017-02-16 13:48:58 by KaiJaeger)