Note, the sample file has been modified to show the two different uses of the <code> tag.
JBA -----Original Message----- From: Miguel de Icaza [mailto:[EMAIL PROTECTED]] Sent: Thursday, 20 February 2003 3:47 PM To: John BouAntoun Subject: Sample XML file.
mono-ecma.xsl
Description: mono-ecma.xsl
<Type Name="Int64" FullName="System.Int64" FullNameSP="System_Int64" Maintainer="ecma">
<TypeSignature Language="ILASM" Value=".class public sequential sealed serializable Int64 extends System.ValueType implements System.IComparable, System.IFormattable" />
<TypeSignature Language="C#" Value="public struct Int64 : IComparable, IFormattable" />
<MemberOfLibrary>BCL</MemberOfLibrary>
<AssemblyInfo>
<AssemblyName>mscorlib</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey>
<AssemblyVersion>1.0.x.x</AssemblyVersion>
<AssemblyCulture>none</AssemblyCulture>
<Attributes>
<Attribute>
<AttributeName>CLSCompliantAttribute(true)</AttributeName>
<Excluded>0</Excluded>
</Attribute>
</Attributes>
</AssemblyInfo>
<ThreadingSafetyStatement>All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.</ThreadingSafetyStatement>
<Docs>
<summary>
<para>Represents a 64-bit signed integer.</para>
</summary>
<remarks>
<para>The <see cref="T:System.Int64" /> data type represents integer values ranging from
negative 9,223,372,036,854,775,808 to positive 9,223,372,036,854,775,807; that
is, hexadecimal 0X8000000000000000 to 0X7FFFFFFFFFFFFFFF.</para>
</remarks>
</Docs>
<Base>
<BaseTypeName>System.ValueType</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.IComparable</InterfaceName>
<Excluded>0</Excluded>
</Interface>
<Interface>
<InterfaceName>System.IFormattable</InterfaceName>
<Excluded>0</Excluded>
</Interface>
</Interfaces>
<Members>
<Member MemberName="MaxValue">
<MemberSignature Language="ILASM" Value=".field public static literal int64 MaxValue = 9223372036854775807" />
<MemberSignature Language="C#" Value="public const long MaxValue = 9223372036854775807;" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Int64</ReturnType>
</ReturnValue>
<Parameters />
<MemberValue>9223372036854775807</MemberValue>
<Docs>
<summary>
<para>Contains the maximum value for the <see cref="T:System.Int64" /> type.</para>
</summary>
<remarks>
<para>The value of this constant is 9,223,372,036,854,775,807 (hexadecimal
0X7FFFFFFFFFFFFFFF).</para>
</remarks>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="MinValue">
<MemberSignature Language="ILASM" Value=".field public static literal int64 MinValue = -9223372036854775808" />
<MemberSignature Language="C#" Value="public const long MinValue = -9223372036854775808;" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Int64</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>
<para>Contains the minimum value for the <see cref="T:System.Int64" /> type.</para>
</summary>
<remarks>
<para>The value of this constant is -9,223,372,036,854,775,808 (hexadecimal
0X8000000000000000).</para>
</remarks>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="ToString">
<MemberSignature Language="ILASM" Value=".method public final hidebysig virtual string ToString(class System.IFormatProvider provider)" />
<MemberSignature Language="C#" Value="public string ToString(IFormatProvider provider);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="provider" Type="System.IFormatProvider" />
</Parameters>
<Docs>
<summary>
<para>Returns a <see cref="T:System.String" /> representation of the value of the current instance.</para>
</summary>
<param name=" provider">A <see cref="T:System.IFormatProvider" /> that supplies a <see cref="T:System.Globalization.NumberFormatInfo" /> containing culture-specific formatting information.</param>
<returns>
<para>A <see cref="T:System.String" /> representation of the current instance formatted using
the general format specifier, ("G"). The string takes into account the
formatting information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by
<paramref name="provider" /> .</para>
</returns>
<remarks>
<para>This version of <see cref="M:System.Int64.ToString" /> is equivalent to <see cref="M:System.Int64.ToString" />("G",
<paramref name="provider" />).</para>
<para>If <paramref name="provider" /> is
<see langword="null" /> or a <see cref="T:System.Globalization.NumberFormatInfo" /> cannot
be obtained from <paramref name="provider" />, the formatting information for the current
system culture is used.</para>
</remarks>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="ToString">
<MemberSignature Language="ILASM" Value=".method public final hidebysig virtual string ToString(string format, class System.IFormatProvider provider)" />
<MemberSignature Language="C#" Value="public string ToString(string format, IFormatProvider provider);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="format" Type="System.String" />
<Parameter Name="provider" Type="System.IFormatProvider" />
</Parameters>
<Docs>
<summary>
<para>Returns a <see cref="T:System.String" /> representation of the value of
the current instance. </para>
</summary>
<param name=" format">A <see cref="T:System.String" /> containing a character that specifies the format of the returned string.</param>
<param name=" provider">A <see cref="T:System.IFormatProvider" /> that supplies a <see cref="T:System.Globalization.NumberFormatInfo" /> instance containing culture-specific formatting information.</param>
<returns>
<para>A <see cref="T:System.String" /> representation of the current instance formatted as
specified by <paramref name="format" />. The string takes into account the formatting
information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by <paramref name="provider" />.</para>
</returns>
<exception cref="T:System.FormatException">
<paramref name="format" /> is invalid.</exception>
<remarks>
<para>If <paramref name="provider" /> is
<see langword="null" /> or a <see cref="T:System.Globalization.NumberFormatInfo" /> cannot be
obtained from <paramref name="provider" />, the formatting information for the current system
culture is used.</para>
<para>If <paramref name="format" /> is a null reference, the general
format specifier "G" is used.</para>
<block subset="none" type="note">
<para>For a detailed
description of formatting, see the <see cref="T:System.IFormattable" /> interface.</para>
<para> This method is implemented
to support the <see cref="T:System.IFormattable" /> interface.</para>
</block>
<para> The following table lists the characters that are valid for the <see cref="T:System.Int64" /> type.</para>
<list type="table">
<listheader>
<term>Format Characters</term>
<description>Description</description>
</listheader>
<item>
<term> "C", "c"</term>
<description>Currency format.</description>
</item>
<item>
<term> "D", "d"</term>
<description>Decimal format.</description>
</item>
<item>
<term> "E", "e"</term>
<description>Exponential notation format.</description>
</item>
<item>
<term> "F", "f"</term>
<description>Fixed-point format.</description>
</item>
<item>
<term> "G", "g"</term>
<description>General format.</description>
</item>
<item>
<term> "N", "n"</term>
<description>Number format.</description>
</item>
<item>
<term> "P", "p"</term>
<description>Percent format.</description>
</item>
<item>
<term> "X", "x"</term>
<description>Hexadecimal format.</description>
</item>
</list>
</remarks>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="CompareTo">
<MemberSignature Language="ILASM" Value=".method public final hidebysig virtual int32 CompareTo(object value)" />
<MemberSignature Language="C#" Value="public int CompareTo(object value);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="value" Type="System.Object" />
</Parameters>
<Docs>
<summary>
<para>Returns the sort order of the current instance compared to the specified
<see cref="T:System.Object" />.</para>
</summary>
<param name=" value">The <see cref="T:System.Object" /> to compare to the current instance.</param>
<returns>
<para>A <see cref="T:System.Int32" /> containing a value that reflects the sort order of the
current instance as compared to <paramref name="value" />. The following table defines the
conditions under which the return value is a negative number, zero, or a
positive number.</para>
<list type="table">
<listheader>
<term>Return Value</term>
<description>Description</description>
</listheader>
<item>
<term> Any negative number</term>
<description>Current instance < <paramref name="value" />.</description>
</item>
<item>
<term> Zero</term>
<description>Current instance == <paramref name="value" />.</description>
</item>
<item>
<term> Any positive number</term>
<description>
<para>Current instance > <paramref name="value" />, or
<paramref name="value" /> is a null reference.</para>
</description>
</item>
</list>
</returns>
<exception cref="T:System.ArgumentException">
<paramref name="value" /> is not a <see cref="T:System.Int64" /> and is not a null reference.</exception>
<remarks>
<para>
<block subset="none" type="note">This method is
implemented to support the <see cref="T:System.IComparable" />
interface.</block>
</para>
</remarks>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="GetHashCode">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual int32 GetHashCode()" />
<MemberSignature Language="C#" Value="public override int GetHashCode();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>
<para>Generates a hash code for the current instance.</para>
</summary>
<returns>
<para>A <see cref="T:System.Int32" /> containing the hash code for the current instance.</para>
</returns>
<remarks>
<para>The algorithm used to
generate the hash code is unspecified.</para>
<para>
<block subset="none" type="note">This method
overrides <see cref="M:System.Object.GetHashCode" />.</block>
</para>
</remarks>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Equals">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual bool Equals(object obj)" />
<MemberSignature Language="C#" Value="public override bool Equals(object obj);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="obj" Type="System.Object" />
</Parameters>
<Docs>
<summary>
<para>Determines whether the current instance and the specified <see cref="T:System.Object" /> represent the
same type and value.</para>
</summary>
<param name=" obj">The <see cref="T:System.Object" /> to compare to the current instance.</param>
<returns>
<para>
<see langword="true" /> if <paramref name="obj" /> represents the
same type and value as the current instance. If <paramref name="obj" /> is a null reference
or is not an instance of <see cref="T:System.Int64" />, returns <see langword="false" />.</para>
</returns>
<remarks>
<para>
<block subset="none" type="note">This method
overrides <see cref="M:System.Object.Equals(System.Object)" />.</block>
</para>
</remarks>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="ToString">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual string ToString()" />
<MemberSignature Language="C#" Value="public override string ToString();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>
<para>Returns a <see cref="T:System.String" /> representation of the value of the current instance. </para>
</summary>
<returns>
<para>A <see cref="T:System.String" /> representation of the current instance formatted using
the general format specifier ("G"). The string takes into account the current
system culture.</para>
</returns>
<remarks>
<para>This version of <see cref="M:System.Int64.ToString" /> is equivalent to <see cref="M:System.Int64.ToString" />(<see langword="null" />, <see langword="null" />).</para>
<para>
<block subset="none" type="note">This method
overrides <see cref="M:System.Object.ToString" />.</block>
</para>
</remarks>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="ToString">
<MemberSignature Language="ILASM" Value=".method public hidebysig instance string ToString(string format)" />
<MemberSignature Language="C#" Value="public string ToString(string format);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="format" Type="System.String" />
</Parameters>
<Docs>
<summary>
<para>Returns a <see cref="T:System.String" /> representation of the value of the current instance.</para>
</summary>
<param name=" format">A <see cref="T:System.String" /> that specifies the format of the returned string. <block subset="none" type="note">For a list of valid values, see <see cref="M:System.Int64.ToString" />(<see cref="T:System.String" />, <see cref="T:System.IFormatProvider" />).</block></param>
<returns>
<para>A <see cref="T:System.String" /> representation of the current instance formatted as
specified by <paramref name="format" />. The string takes into account the current system culture.</para>
</returns>
<exception cref="T:System.FormatException">
<paramref name="format" /> is invalid.</exception>
<remarks>
<para>This method is equivalent to <see cref="M:System.Int64.ToString" />
(<paramref name="format" />,
<see langword="null" />).</para>
<para>If <paramref name="format" /> is a null reference, the general
format specifier "G" is used.</para>
</remarks>
<example>
<para>This example demonstrates converting a <see cref="T:System.Int64" /> to a string.</para>
<code lang="C#" source="somesourcefile.cs" />
<code lang="C#" >using System;
public class Int64ToStringExample {
public static void Main() {
Int64 i = 64;
Console.WriteLine(i);
String[] formats = {"c", "d", "e", "f", "g", "n", "p", "x" };
foreach(String str in formats)
Console.WriteLine("{0}: {1}", str, i.ToString(str));
}
}
</code>
<para>The output is</para>
<c>
<para>64</para>
<para>c: $64.00</para>
<para>d: 64</para>
<para>e: 6.400000e+001</para>
<para>f: 64.00</para>
<para>g: 64</para>
<para>n: 64.00</para>
<para>p: 6,400.00 %</para>
<para>x: 40</para>
</c>
</example>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Parse">
<MemberSignature Language="ILASM" Value=".method public hidebysig static int64 Parse(string s)" />
<MemberSignature Language="C#" Value="public static long Parse(string s);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Int64</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="s" Type="System.String" />
</Parameters>
<Docs>
<summary>
<para>Returns the specified <see cref="T:System.String" /> converted to a <see cref="T:System.Int64" />
value.</para>
</summary>
<param name=" s">A <see cref="T:System.String" /> containing the value to convert. The string is interpreted using the <see cref="F:System.Globalization.NumberStyles.Integer" /> style.</param>
<returns>
<para>The <see cref="T:System.Int64" /> value obtained from <paramref name="s" />.</para>
</returns>
<exception cref="T:System.ArgumentNullException">
<paramref name="s" /> is a null reference.</exception>
<exception cref="T:System.FormatException">
<paramref name="s" /> is not in the correct style.</exception>
<exception cref="T:System.OverflowException">
<paramref name="s" /> represents a number greater than <see cref="F:System.Int64.MaxValue" /> or less than <see cref="F:System.Int64.MinValue" />.</exception>
<remarks>
<para>This version of <see cref="M:System.Int64.Parse(System.String)" /> is equivalent to <see cref="M:System.Int64.Parse(System.String)" />
(<paramref name="s" />, <see cref="F:System.Globalization.NumberStyles.Integer" />, <see langword="null" />).</para>
<para>The string <paramref name="s" /> is parsed using the formatting
information in a <see cref="T:System.Globalization.NumberFormatInfo" /> initialized for the current system
culture. <block subset="none" type="note"> For
more information, see <see cref="P:System.Globalization.NumberFormatInfo.CurrentInfo" />.</block></para>
</remarks>
<example>
<para>This example demonstrates parsing a string to a <see cref="T:System.Int64" />.</para>
<code lang="C#">using System;
public class Int64ParseClass {
public static void Main() {
string str = " 100 ";
Console.WriteLine("String: \"{0}\" <Int64> {1}",str,Int64.Parse(str));
}
}
</code>
<para>The output is</para>
<para>
<c>String: " 100
" <Int64> 100</c>
</para>
</example>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Parse">
<MemberSignature Language="ILASM" Value=".method public hidebysig static int64 Parse(string s, valuetype System.Globalization.NumberStyles style)" />
<MemberSignature Language="C#" Value="public static long Parse(string s, NumberStyles style);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Int64</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="s" Type="System.String" />
<Parameter Name="style" Type="System.Globalization.NumberStyles" />
</Parameters>
<Docs>
<summary>
<para>Returns the specified <see cref="T:System.String" /> converted to a <see cref="T:System.Int64" /> value.</para>
</summary>
<param name=" s">A <see cref="T:System.String" /> containing the value to convert. The string is interpreted using the style specified by <paramref name="style" />.</param>
<param name=" style">Zero or more <see cref="T:System.Globalization.NumberStyles" /> values that specify the style of <paramref name="s" />. Specify multiple values for <paramref name="style" /> using the bitwise OR operator. If <paramref name="style" /> is a null reference, the string is interpreted using the <see cref="F:System.Globalization.NumberStyles.Integer" /> style.</param>
<returns>
<para>The <see cref="T:System.Int64" /> value obtained from <paramref name="s" />.</para>
</returns>
<exception cref="T:System.ArgumentNullException">
<paramref name="s" /> is a null reference.</exception>
<exception cref="T:System.FormatException">
<paramref name="s" /> is not in the correct style.</exception>
<exception cref="T:System.OverflowException">
<paramref name="s" /> represents a number greater than <see cref="F:System.Int64.MaxValue" /> or less than <see cref="F:System.Int64.MinValue" />.</exception>
<remarks>
<para>This version of <see cref="M:System.Int64.Parse(System.String)" /> is equivalent to <see cref="M:System.Int64.Parse(System.String)" />(<paramref name="s" />, <paramref name="style" />, <see langword="null" />).</para>
<para>The string <paramref name="s" /> is parsed using the formatting
information in a <see cref="T:System.Globalization.NumberFormatInfo" /> initialized for the current system culture. <block subset="none" type="note">For more information, see <see cref="P:System.Globalization.NumberFormatInfo.CurrentInfo" />.</block></para>
</remarks>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Parse">
<MemberSignature Language="ILASM" Value=".method public hidebysig static int64 Parse(string s, class System.IFormatProvider provider)" />
<MemberSignature Language="C#" Value="public static long Parse(string s, IFormatProvider provider);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Int64</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="s" Type="System.String" />
<Parameter Name="provider" Type="System.IFormatProvider" />
</Parameters>
<Docs>
<summary>
<para>Returns the specified <see cref="T:System.String" /> converted to a <see cref="T:System.Int64" /> value.</para>
</summary>
<param name=" s">A <see cref="T:System.String" /> containing the value to convert. The string is interpreted using the <see cref="F:System.Globalization.NumberStyles.Integer" /> style.</param>
<param name=" provider">A <see cref="T:System.IFormatProvider" /> that supplies a <see cref="T:System.Globalization.NumberFormatInfo" /> containing culture-specific formatting information about <paramref name="s" />.</param>
<returns>
<para>The <see cref="T:System.Int64" /> value obtained from <paramref name="s" />.</para>
</returns>
<exception cref="T:System.ArgumentNullException">
<paramref name="s" /> is a null reference.</exception>
<exception cref="T:System.FormatException">
<paramref name="s" /> is not in the correct style.</exception>
<exception cref="T:System.OverflowException">
<paramref name="s" /> represents a number greater than <see cref="F:System.Int64.MaxValue" /> or less than <see cref="F:System.Int64.MinValue" />.</exception>
<remarks>
<para>This version of <see cref="M:System.Int64.Parse(System.String)" /> is equivalent to <see cref="M:System.Int64.Parse(System.String)" />
(<paramref name="s" />, <see cref="F:System.Globalization.NumberStyles.Integer" />, <paramref name="provider" />).</para>
<para>The string <paramref name="s" /> is parsed using the
culture-specific formatting information from the <see cref="T:System.Globalization.NumberFormatInfo" />
instance supplied by <paramref name="provider" />. If <paramref name="provider" /> is
<see langword="null" /> or a
<see cref="T:System.Globalization.NumberFormatInfo" />
cannot be obtained from <paramref name="provider" />, the formatting information for the
current system culture is used.</para>
</remarks>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Parse">
<MemberSignature Language="ILASM" Value=".method public hidebysig static int64 Parse(string s, valuetype System.Globalization.NumberStyles style, class System.IFormatProvider provider)" />
<MemberSignature Language="C#" Value="public static long Parse(string s, NumberStyles style, IFormatProvider provider);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Int64</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="s" Type="System.String" />
<Parameter Name="style" Type="System.Globalization.NumberStyles" />
<Parameter Name="provider" Type="System.IFormatProvider" />
</Parameters>
<Docs>
<summary>
<para>Returns the specified <see cref="T:System.String" /> converted to a <see cref="T:System.Int64" /> value.</para>
</summary>
<param name=" s">A <see cref="T:System.String" /> containing the value to convert. The string is interpreted using the style specified by <paramref name="style" />.</param>
<param name=" style">Zero or more <see cref="T:System.Globalization.NumberStyles" /> values that specify the style of <paramref name="s" />. Specify multiple values for <paramref name="style" /> using the bitwise OR operator. If <paramref name="style" /> is a null reference, the string is interpreted using the <see cref="F:System.Globalization.NumberStyles.Integer" /> style.</param>
<param name=" provider">A <see cref="T:System.IFormatProvider" /> that supplies a <see cref="T:System.Globalization.NumberFormatInfo" /> containing culture-specific formatting information about <paramref name="s" />.</param>
<returns>
<para>The <see cref="T:System.Int64" /> value obtained from <paramref name="s" />.</para>
</returns>
<exception cref="T:System.ArgumentNullException">
<paramref name="s" /> is a null reference.</exception>
<exception cref="T:System.FormatException">
<paramref name="s" /> is not in the correct style.</exception>
<exception cref="T:System.OverflowException">
<paramref name="s" /> represents a number greater than <see cref="F:System.Int64.MaxValue" /> or less than <see cref="F:System.Int64.MinValue" />.</exception>
<remarks>
<para>The string <paramref name="s" /> is parsed using the
culture-specific formatting information from the <see cref="T:System.Globalization.NumberFormatInfo" />
instance supplied by <paramref name="provider" />. If <paramref name="provider" /> is
<see langword="null" /> or a
<see cref="T:System.Globalization.NumberFormatInfo" />
cannot be obtained from <paramref name="provider" />, the formatting information for the
current system culture is used.</para>
</remarks>
</Docs>
<Excluded>0</Excluded>
</Member>
</Members>
<TypeExcluded>0</TypeExcluded>
</Type>
