Re: [Bug-apl] Free APL reference documentation, any takers?

[Juergen Sauermann]

Hi Fred, the ⍝⍝ was a proposal to mark Doxygen descriptions in APL. For example in C/C++ you have normal comments starting with // and Doxygen comments starting with ///. Or /* for normal comments and /** for Doxygen comments. Best Regards, Jürgen On 04/17/2017 09:36 PM, Fred Weigel wrote: Elias, Juergen I use the "Toronto Toolkit" convention, which looks like this: ∇y←x adjust d;⎕IO;ex;i;line;lmrg;pw;w  ⍝adjust each row of matrix <d> according to parameters <x>  ⍝.e ('/' ∆box 'please do not  / enter') = 15 adjust 'please do not enter'  ⍝.k formatting  ⍝.n rml  ⍝.t 1992.4.24.14.4.17  ⍝.v 1.0 / 05jan82  ⍝.v 2.0 / 05apr88 / change order of <x>, use subroutines  ⍝.v 2.1 / 24apr92 / using signalerror  ⍝ x[1] width of result in columns  ⍝ x[2] width of left margin (i.e. number of blank columns)  ⍝ x[3] number of blank lines to insert between each row  ⎕IO←1 ...and more of the function... I suspect that if the first line is a lamp line, that can be taken as the description, and a double-lamp taken as a single lamp. This lamp line may be indented, and could then be the "help" for the function. The "Toronto Toolkit" format then has lamp lines with ".x" (. followed by letter) and data .e is example, .t is timestamp, .v is version, .k for keywords, .n for name/initials and more. Then there are function in the Toolkit that handle this data. But, again, the first lamp-line gives the overview. Just food for thought. FredW