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