On Mon, Jun 11, 2007 at 03:55:01PM +0000, Henrik Grubbstr�m (Lysator) @ Pike (-) developers forum wrote:
because then i'd need to parse the xml and turn it back into text, whereas this way the text for the most part can be displayed as is.
? As far as I can see, reading the autodoc syntax has the same problem.
no, because the AutoDoc module already does it for me:
object docs = master()->show_doc(module); write("%{%s\n%}\n", docs->objects->print()); write(docs->documentation->text);
most of the docs can be displayed just like that.
xml would need some xml->text conversion.
keep in mind that one of the points is to display docs for classes that are not part of the pike distribution. the autodoc blob generated during build won't get to see those. to make this generic, parsing at runtime is the easiest option.
greetings, martin.