Hi Andreas,

You can now omit the colon in comments. A new snapshot is available [1].

Hope this helps, Christian

[1] https://files.basex.org/releases/latest/

On Mon, Aug 24, 2020 at 4:41 PM Andreas Mixich mixich.andreas@gmail.com wrote:

Hello,

when using `inspect:xqdoc#1` on a module, where the lines of doc comments do not start with a leading colon, as shown by the following example:

(:~
  Description

  @comment-token
:)

the output will be missing the element for the @comment-tokens (i.e.:`xqdoc:function/xqdoc:comment/xqdoc:param`). They only get provided, if the leading colons are set, as in:

(:~
 : Description
 :
 : @comment-token
 :)

Since I dislike to add the leading colons I opened up an issue at [1], but according to Loren Cahlander the parser does not seem to require them. Therefore I assume, that this could be implementation dependent.

The spec does not require the leading ':', but it seems, that BaseX does. Could the lack of leading colons be tolerated? That would be nice! Thank you.

-- Goody Bye, Minden jót, Mit freundlichen Grüßen, Andreas Mixich