[Mono-docs-list] MonoDoc helpsource improvement

[Joshua Tauberer]

Miguel de Icaza wrote:
> The code is awesome!  I really like to get this into CVS.

Great, thanks.

> 	  Although the code is great, I wonder if am going to be able
> 	  to maintain it (or whether you are interested in maintaining
> 	  this moving forward, for say a few months).

For a few months, sure.

> 	* The tables that render data use the full width of the screen,
> 	  because the different sizes for properties, constructors,
> 	  methods look ugly (this was a bug previously as well).

Hmm, yes, ok.  I added width=100% to the tables.

> 	* I would like all the text inside a section to be "indented".
> 	  That was previously done by adding a table I believe.

It is, at least for me.  What do you mean by section?

> Also, we got a few patches recently: one of them sorted members

In the tree, right?  That shouldn't involve/interfere with my files.

> Rachel added support for bulleted lists

I noticed this in CVS.  I had already put that into my mono-ecma.xsl 
file, so you don't need to integrate that patch with my file.  (Sorry, 
Rachel.)  I added it slightly differently.

The new stylesheet already includes a lot of missing formatting 
transformations.  I looked at the ECMA DTD that was mentioned on this 
list a while back (I looked through the list archive) and added XSL 
templates for all of the missing formatting, unless I missed something.

There are two open issues with the stylesheet:

	Delegates lack sufficient information in the XML docs to hyperlink 
their signatures, unless their C# signatures are parsed. Instead, 
they're displayed as they are in the docs as plain text.

	Ref and out parameters are not distinguished in the docs, except in the 
textual method signatures.  So, again, without parsing the signatures, 
out parameters can only be listed as ref.

	I don't know where the ECMA docs come from, so I don't know if it's 
feasible to add more information to them.

Looking forward to seeing it eventually in CVS. :)

-- 
- Joshua Tauberer

http://taubz.for.net

** Nothing Unreal Exists **