Sorry for following up to my own email, but I forgot to mention one thing:
I have absolutely no particular attachment to the choice of using ⍝⍝. I'm
OK with any format, but the important part is that it's clearly distinct
from any normally occurring comments or code.
If I remember correctly, this
Hello David,
Having a standardised format is what makes this so useful. The whole point
of this is to make sure that everybody uses the same convention so
third-party tools can integrate with the system. If everybody “adopts the
convention they prefer”, as you suggest, such a system would not be v
Thank you to everyone who contributed to the recent extension to )HELP. This'll
be far more convenient that flipping between APL and two PDF references.
Regarding help for user-defined functions, I'd like to offer a suggestion:
I've noticed quite a bit of talk about adopting syntax and/or semant
Ö (the APL symbol, which I don't have access to on this keyboard) was used in
Sharp APL as the composition operator (equivalent to @ in modern J). It might
still be used for the same purpose in NARS.
Cheers,
Louis
> On 17 Apr 2017, at 17:31, Juergen Sauermann
> wrote:
>
> Hi Xiao-Yong,
>
>
If you haven't added those, the quads are missing too, ⌷ ⎕ ⍞.
In addition, the result of "]HELP ." is not good.
Perhaps describing it as a dyadic operator with a special left operand of ∘
works better.
> On Apr 17, 2017, at 4:31 PM, Juergen Sauermann
> wrote:
>
> Hi Xiao-Yong,
>
> thanks, I h
Hi Xiao-Yong,
thanks, I have added *⍤*, *⍣*, and *⍬* to *)HELP* in *SVN 923*.
No Idea what *⍥* is, and GNU APL seems not to support it. Nor does ISO
or APL2.
What I do know is *ö* and *Ö* (German Umlaute: *ö* is lower-case and *Ö*
is upper-case).
I suppose *⍥* is German middle-case then :-)
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.
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 according to parameters
⍝.e ('/' ∆box 'please do not / enter') = 15 adjust 'please do not
enter'
⍝.k formatting
⍝.n rml
⍝.t 1992.4.24.14.4.17
⍝.v
Hi,
My bad, apparently I've accidentally modified the source file while
browsing around the code.
Thanks, looks like it (help) works now!
Juergen Sauermann writes:
> Hi Alexey,
>
> that string appears nowhere in my code:
>
> eedjsa@server66:~/projects/juergen/apl-1.7$ grep -r
> doFooWithExten
> On Apr 17, 2017, at 1:06 PM, Juergen Sauermann
> wrote:
>
> dyadic function: Z ← A ⌹ B (Matrix divide)
> Solution to system of linear equations Ax = B
That should be "A = Bx"
It seems that ⍤ and ⍣ are not in the list.
I guess that's because they are not in APL2?
Hi Alexey,
that string appears nowhere in my code:
eedjsa@server66:~/projects/juergen/apl-1.7$
grep -r doFooWithExtendedMarkupLanguageSoon .
eedjsa@server66:~/projects/juergen/apl-1.7$
And QuadFunction.cc:120 simply reads:
Hi,
Thanks! This is awesome.
I can't build this version however:
QuadFunction.cc:120:2: error: 'doFooWithExtendedMarkupLanguageSoon' does not
name a type
}doFooWithExtendedMarkupLanguageSoon
^
Juergen Sauermann writes:
> Hi,
>
> I have integrated Alexey's help texts into GNU APL. SVN 921.
Hi Elias,
the API to the APL help texts is the help_def()
macro. See e.g. Command.cc line 778.
Showing )HELP for defined function seems to be a cool idea,
but I need a little more time
for that.
Best Regards,
/// Jürgen
On 04/17/20
Hi,
I have integrated Alexey's help texts into GNU APL. SVN 921.
To display help for an APL primitive say e.g.
]HELP ⌹
monadic function: Z ← ⌹ B (Matrix inverse)
Inverse of matrix B
dyadic function: Z ← A ⌹ B (Mat
Hello Jürgen,
What is the API provided to programmatically access the documentation for a
given function?
Whatever the API is, may I suggest that this function also accepts any
defined function? The text returned should of course be the content of the
comment header (i.e. the comments at the begi
Hi Alexey,
thanks a lot, I will integrate it into GNU APL.
I will also fix the typos reported by Louis.
/// Jürgen
On 04/16/2017 10:19 PM, Alexey
Veretennikov wrote:
Hi Juergen, Elias,
I've converted documentation fro
16 matches
Mail list logo
