[Mono-list] Monodoc & Co.

Giuseppe Greco giuseppe.greco@agamura.com
18 Jul 2003 19:18:53 +0200

On Fri, 2003-07-18 at 18:43, Miguel de Icaza wrote:
> Hello,

Hi Miguel,

First of all, thank you very much for your answer...

> > I was able to successfully generate the files
> > monodoc requires (*.source, *.tree, and *.zip).
> > Now the question is: is there a way to automatically
> > update the monodoc.xml file? To see my document I
> > had to manually add an entry into monodoc.xml...
> It is an common mistake (that I should fix) to have all the
> documentation use a new node.  Documentation should hook up to the best
> node.  In your case it might be "various".
> To do this, edit your .source file to point to the node.
> That is the "path" component in your .source file.

I know. In fact, my path is gekkota, and I've added a line like the
following to monodoc.xml:

<node label="Gekkota Libraries" name="gekkota"/>

By the way, why doesn't browser.exe automatically create a new node
for each *.source file it finds in the sources directory? Eventually,
*.source could also contain a label element...

> > Second question:
> > How can I generate plain HTML with assembler.exe?
> the assembler only compiles the data, but it wont render it;  To do
> that, you have to use the browser.exe (or its dll).  Look at the `mod'
> script, it is just a front-end to it. 

I'd like to generate also plain HTML documentation, so I can publish it
on our web site. Actually, to do that, I've to convert the XML files
generated with updater.exe to a single XML file (see the utility
written by Jarek), and then I can generate either plain HTML or 
LaTeX source with NDoc.

I hope not to bore you, Miguel.

> miguel
> _______________________________________________
> Mono-list maillist  -  Mono-list@lists.ximian.com
> http://lists.ximian.com/mailman/listinfo/mono-list
Giuseppe Greco


phone:  +41 (0)91 604 67 65
mobile: +41 (0)76 390 60 32
email:  giuseppe.greco@agamura.com
web:    www.agamura.com