xqDoc annotations

[christianforster]

In the master branch, commit 7ba4f551eedf82ed75357992bf6bd1aecf638839, some xqDoc annotation functionality seems to be broken:
In the code below, @see is not working as I expect. The following code produces the attached documentation, where @see is omitted.

(:~
 : This module …
 : 
 : @see http://www.example.org/
 : @author Christian Forster
 : @version 0.1
 :)

Other issues occur in the functx documentation. The comment in its source code contains an email address and everything from the "@" part on does not appear in the generated documentation.
Also, within that module @author, @version, and @see annotations in function comments are ignored.

[duncdrum]

yup ran into this as well with in eXist 3.1.1, Java 8, macOS 10.12.4

(:~
: this …
: @return taxonomy[@type = "sexa"]
:)

becomes:

 <returns type="item()" cardinality="zero or more"> taxonomy[</returns>

according to inspect:inspect-module($module)

workaround:

(:~
: this …
: @return <taxonomy type = "sexa">…</taxonomy>
:)

exist-db main ticket is at eXist-db/exist#1386