[Mono-dev] monodocs2html help with source

[Joshua Tauberer]

Pedro Sobota wrote:
> Hi
>> See tools/stylesheet.xsl.  If a cref attribute is specified, then the
>> value of the cref attribute is used.  If a langword attribute is used,
>> then the value of the langword attribute is used.
>>   
> Right. I hadn't seen the langword match. From what I gather, the cref
> attribute makes for a link with the full type or member name as the
> text, whereas the langword is just output with no link. They seem to be
> mutually exclusive, so I can't link and specify text as well. Maybe for
> the Monodoc format they aren't, in which case this could be repaired for
> monodocs2html?

They have different uses.  langword is used to tag language keywords,
like "null", "true", "false", etc.  cref is to make a link to another
section of the documentation.

The thing to do would be to improve the method for how the text for <see
cref=>'s are generated automatically, rather than add a way for the user
to provide his own text.

-- 
- Josh Tauberer

http://razor.occams.info

"Yields falsehood when preceded by its quotation!  Yields
falsehood when preceded by its quotation!" Achilles to
Tortoise (in "Gödel, Escher, Bach" by Douglas Hofstadter)