Re: [PATCH] Generics Support for monodoc/tools

Joshua Tauberer <[email protected]> Wed, 04 Oct 2006 17:28:44 -0400
Newsgroups gmane.comp.gnome.mono.documentation
Message-ID <[email protected]>
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
_______________________________________________
Mono-docs-list maillist  -  [email protected]
http://lists.ximian.com/mailman/listinfo/mono-docs-list