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