[Mono-docs-list] MonoDoc helpsource improvement

Joshua Tauberer tauberer@for.net
Wed, 21 May 2003 23:36:25 -0400


Miguel de Icaza wrote:
> I would like the table which has been captioned with "Classes" to be 
> more indented than the few characters it is now

Ahha, I just forgot to indent namespace type listings.

> Notice that "GType" comes after "Vadjustment".

I experimented with putting static members at the end - thought maybe it 
would be easier to view.  That wasn't an alphabetical sorting problem. 
I removed that, so it's all sorted only alphabetically now.

>>	Ref and out parameters are not distinguished in the docs, except in the 
>>textual method signatures
> How hard is to perform this parsing with XSLT?

That's not something I would ever want to attempt in XSLT, if it's possible.

 > We could use a C# function to perform some of the work.

Seems like a backwards way to do it.  The information should have been 
present in the docs to begin with, really.

> We could add more docs by writing a program that merges the ECMA 
> documentation with the actual assemblies we have on disk.  But I would 
> like to avoid that if possible.

I find this to be the best approach (though I'm not sure I have time to 
implement it).  After doing that, the docs would have an entirely 
machine-readable description of the classes.

> I should set you up with an account, so you can work directly with the 
> code on CVS. 

Nifty, tho it might be a while before I get the chance to figure out how 
to get myself set up with that.

-- 
- Joshua Tauberer

http://taubz.for.net

** Nothing Unreal Exists **