zorba-coders team mailing list archive
-
zorba-coders team
-
Mailing list archive
-
Message #04604
[Bug 867338] Re: improve xqdoc documentation
We already have this in Zorba.
** Changed in: zorba
Status: Unknown => Triaged
** Changed in: zorba
Status: Triaged => Invalid
** Changed in: zorba
Assignee: Matthias Brantner (matthias-brantner) => Sorin Marian Nasoi (sorin.marian.nasoi)
--
You received this bug notification because you are a member of Zorba
Coders, which is the registrant for Zorba.
https://bugs.launchpad.net/bugs/867338
Title:
improve xqdoc documentation
Status in Zorba - The XQuery Processor:
Invalid
Bug description:
We should have a method similar to the \include option provided by doxygen
in order to include files/tests into the xqdoc documentation.
Details:
- in Doxygen if you made sure that in the doc/zorba/doxy.config.in you set the:
EXAMPLE_PATH at line 501 and EXAMPLE_PATTERNS at line 510 in the doxy
documentation you could use
\include file.xml and get the content of the file.xml
the result of the XHTML code was a DIV and PRE containers that were
added to the actual code in the file, see for example
http://www.zorba-xquery.com/doc/zorba-latest/zorba/html/converters.html
the test shown after the text "The following XQuery (taken from John
Snelson's article mentioned above) demonstrates the usage of the parse
function."
There you see that <div class="fragment"><pre class="fragment"> are
added before the content of the actual file \included. Off course
class="fragment" should be implemented in the CSS, but that is besides
the point.
A simpler solution, for starters would be to add some links like this:
<a href="file:///file.xml" target="_blank">file.xml</a> and then you
put the file.xml in a path recognized by xqdoc (I think the same thing
is done the links to the actual modules pages, in xhtml/index.html,
right?)
In this case I think the question is in which folder should we store the file.xml.
To manage notifications about this bug go to:
https://bugs.launchpad.net/zorba/+bug/867338/+subscriptions