[Mono-docs-list] MonoDoc helpsource improvement

Ben Maurer bmaurer@users.sourceforge.net
21 May 2003 21:42:09 -0400


On Wed, 2003-05-21 at 21:17, Joshua Tauberer wrote:

> I think I had copied what used to be used, and since I don't know the 
> capabilities of the HTML widget, I didn't touch it.  I'll fix it up with 
> CSS if it works.
Dunno if that will work. Although I think Evo can parse it, and that
uses GtkHTML. Miguel, comments on this?
> 
> >       * I think the XSLT file is _way_ too big.
> 
> Yes, absolutely.  Will xsl:includes work since it's a resource file?
Hmm, don't know. Gonzalo: can that be made to work somehow? We could
always copy the xslt files to a temp folder, but that is such a hack.
> 
> >       * I think each language stuff should not be in xslt.
> 
> What stuff?
Even if it is minimal, it should be separated. If not taken out of xslt
all together, at the least, put into a separate xslt file.

> What is missing from the stylesheet that could be reused from NDoc?
NDoc is a bit more polished. It also generates its signatures at
runtime, rather than when the docs are compiled. And frankly, if we want
maintainability, the best way to do it is to latch on to code from
somewhere like NDoc.