[Mono-docs-list] Updating class library docs
Hector E. Gomez Morales
hgomez_36@flashmail.com
Thu, 04 Mar 2004 20:34:05 -0600
Doh 0x10 is tab so it is a well formed XML, but the case is that the
ECMA documentation uses space for it IdentChar.
On Thu, 2004-03-04 at 20:26, Hector E. Gomez Morales wrote:
> One question is that style of indentation in the docs intentional?
> because the ECMA docs and the Mono Docs use a 2 space indentation.
> mainly because is more readable and tries to maintain the wrapping of
> the lines to a minimum.
> (mainly because the Indentation property has a default of 2 IndentChars
> for each level).
>
> Oh I see that it was intentional (from stub.cs):
>
> private static void WriteXml(XmlElement element,
> System.IO.TextWriter output) {
> XmlTextWriter writer = new XmlTextWriter(output);
> writer.Formatting = Formatting.Indented; //this one fine
> writer.Indentation = 1; //should be 2
> writer.IndentChar = '\t'; //should be space
> element.WriteTo(writer);
> output.WriteLine();
> }
>
> First please the docs don't use tab for the IdentChar it uses space,
> second from Microsoft documentation:
>
> To ensure valid XML, you must specify a valid whitespace character, 0x9,
> 0x10, 0x13 or 0x20.
>
> On Thu, 2004-03-04 at 15:17, Joshua Tauberer wrote:
> > Miguel de Icaza wrote:
> > > Please apply your new patches to CVS.
> >
> > Done.
> >
> > Just as a correction to myself, actually two documented methods were
> > initially lost: System/Math.xml DivRem (two overloads). The problem was
> > they had the wrong parameter types for out parameters (lacking the & at
> > the end and the RefType attribute). I corrected this before committing.
>
> _______________________________________________
> Mono-docs-list maillist - Mono-docs-list@lists.ximian.com
> http://lists.ximian.com/mailman/listinfo/mono-docs-list