[Mono-docs-list] [PATCH] Generics Support for monodoc/tools

Joshua Tauberer jit at occams.info
Wed Oct 4 17:28:44 EDT 2006


Another thing... I wonder if it would make sense to rename the index.xml
Name and File attributes to DisplayName and Signature to make what they
represent clearer, and, I think, because the File attribute is used not
just for file locations but also for matching signatures in crefs.

And the File attribute should be mandatory (i.e. inserted on update)
since monodocs2html assumes a File attribute is present on all type nodes.

Also, do you know of a reason for *sticking* with +'s in nested types?
crefs don't use +'s, right?  (A quick Google search shows someone
reporting +'s aren't/weren't used by VS.NET, but I don't know for sure
if that's right.)  If that's the case, it seems like things can be
simplified if we just drop +'s everywhere.  OTOH, if we stick with +'s
in the File attribute, we could change the conventions for crefs so they
are easier to parse (albeit breaking from Microsoft, which isn't so bad
actually because we can handle the difference in the /doc import/export
tools).

-- 
- Joshua Tauberer

http://razor.occams.info

"Strike up the klezmer and start acting like a man. You're
about to have a truth-mitzvah."  -- The Colbert Report


More information about the Mono-docs-list mailing list