[Mono-docs-list] xml files: <see cref="!:Class.Message">??

[Jonathan Pryor]

The full standard can be downloaded from ECMA at:

	ftp://ftp.ecma.ch/ecma-st/Ecma-334.pdf

It's a 1.8MB Download.

Other formats can be found at:

	http://www.ecma.ch/ecma1/STAND/ecma-334.htm

As for `cref="!:..."', the standard says:

	Error string; the rest of the string provides information about
	the error. For example, the documentation generator generates
	error information for links that cannot be resolved.

In particular, see page 461 of the PDF file (labeled page 447, due to
table of contents and other leading pages).

 - Jon

On Sun, 2002-10-27 at 13:50, Scott Bronson wrote:
> Scattered around the xml documentation, I see constructs like the
> following:
> 
>     <see cref="!:System.UnauthorizedAccessException.Message">
> 
> All the other cref types are obvious, but what the heck does that bang
> mean?  Does it just specify the message field for the given exception?
> 
> 
> >From http://dotnet.di.unipi.it/EcmaSpec/PartitionIV/cont7.html
> 
>   <!ATTLIST see
> 
>   cref CDATA #IMPLIED
> 
>    (Informative) cref specifies the fully-qualified name of the type or
>    member to link to. [Note: In this specification, CDATA matches the
>    documentation comment format specified in Appendix E of the C#
>    Language specification.] 
> 
> 
> OK, so I tried to find Appendix E of the C# Language Specification
> online.  It's nowhere to be found!  The C# Language Specs that I've
> managed to turn up all end at Appendix D.
> 
> 
> Can anyone tell me what the cref='!:' means specifically?  Or, better
> yet, can anyone either send me a copy of Appendix E or tell me where to
> download it?  Thanks,
> 
>     - Scott
> 
> 
> 
> 
> _______________________________________________
> Mono-docs-list maillist  -  Mono-docs-list@ximian.com
> http://lists.ximian.com/mailman/listinfo/mono-docs-list