[Mono-dev] monodocs2html help with source

Joshua Tauberer jit at occams.info
Thu Mar 1 10:00:14 EST 2007

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


"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)

More information about the Mono-devel-list mailing list