[Mono-docs-list] Handbook Xhtmlified

Miguel de Icaza miguel@ximian.com
09 May 2003 16:56:59 -0400


Hello,

> > > What I have now is very basic, and there's an obvious bug (see the
> > > screenshot at http://www.fonicmonkey.net/monodoc.png ). 
> > > The tree nodes are sorted alphabetically, rather than using the ordering of the handbook xml file.
> > > I'm not sure if it's my code doing that or the browser/assembler.
> > 
> > The browser/assembler is probably at fault here.  I forget where I sort
> > the nodes in a generic way, but we can fix this.
> 
> It must have been the end of the day when I was coding last time...
> assembler.cs calls:
> 
> hs.Tree.Sort()
> 
> If I comment that out, the handbook provider builds the tree correctly.
> Is that a valid fix for all providers though?

Mhm.  This is trickier than I expected to do "cleanly"

For now, lets just add an option --nosort, and pass that flag to the
assembler.

> At the moment, in my local copy I have just added another command-line
> option to assembler.cs to handle my handbook provider, (as it is still
> in alpha).
> 
> It looks like we need to move to some sort of extensible way of
> "registering" providers so that the assembler and browser can pick up
> whatever is installed. Any thoughts so far on that?

I would just compile it in for now, it is not worth splitting things out until 
the Monodoc browser is more robust.

Miguel