Re: [Bug-apl] Formal format for function documentation

[Elias Mårtenson]

Well, that would be great too. My parsing of the comments right now is very simple, and I can easily change it if a different approach is proposed.

If anything more complex than just a simple block of text is decided upon, I can add features to the Emacs mode to provide syntax highlighting and structural edit features for the documentation.

Regards,

Elias

On 16 July 2014 23:27, Juergen Sauermann <address@hidden> wrote:

Hi,

sorry, I sent this one to the wrong topic..,

/// Jürgen


On 07/14/2014 08:14 PM, Juergen Sauermann wrote:

Hi,

my favourite for code documentation is Doxygen. It does not currently
support APL comments but we might be able to change that. Or use one
of the existing tags like --- for VHDL or %%% for Erlang.

It would need some changes in GNU APL - multi-line comments and
proper storage of documentation information in the function so that it
can de )DUMPed without loosing that information.

/// Jürgen