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.

[1]: https://github.com/xqdoc/xqdoc/issues/4

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