2. Результирующий xml

Здесь представлен результат, созданный генератором документации по вышеприведенному исходному коду для класса Point:

<?xml version="1.0"?> <doc> <assembly> <name>Point</name> </assembly> <members> <member name="T:Graphics.Point"> <summary>Class <c>Point</c> models a point in a two-dimensional plane. </summary> </member>

<member name="F:Graphics.Point.x"> <summary>Instance variable <c>x</c> represents the point's x-coordinate.</summary> </member>

<member name="F:Graphics.Point.y"> <summary>Instance variable <c>y</c> represents the point's y-coordinate.</summary> </member>

<member name="M:Graphics.Point.#ctor"> <summary>This constructor initializes the new Point to (0,0).</summary> </member>

<member name="M:Graphics.Point.#ctor(System.Int32,System.Int32)"> <summary>This constructor initializes the new Point to (<paramref name="xor"/>,<paramref name="yor"/>).</summary> <param><c>xor</c> is the new Point's x-coordinate.</param> <param><c>yor</c> is the new Point's y-coordinate.</param> </member>

<member name="M:Graphics.Point.Move(System.Int32,System.Int32)"> <summary>This method changes the point's location to the given coordinates.</summary> <param><c>xor</c> is the new x-coordinate.</param> <param><c>yor</c> is the new y-coordinate.</param> <see cref="M:Graphics.Point.Translate(System.Int32,System.Int32)"/> </member>

<member name="M:Graphics.Point.Translate(System.Int32,System.Int32)"> <summary>This method changes the point's location by the given x- and y-offsets. <example>Например: <code> Point p = new Point(3,5); p.Translate(-1,3); </code> results in <c>p</c>'s having the value (2,8). </example> </summary> <param><c>xor</c> is the relative x-offset.</param> <param><c>yor</c> is the relative y-offset.</param> <see cref="M:Graphics.Point.Move(System.Int32,System.Int32)"/> </member>

<member name="M:Graphics.Point.Equals(System.Object)"> <summary>This method determines whether two Points have the same location.</summary> <param><c>o</c> is the object to be compared to the current object. </param> <returns>True if the Points have the same location and they have the exact same type; otherwise, false.</returns> <seealso cref="M:Graphics.Point.op_Equality(Graphics.Point,Graphics.Point)"/> <seealso cref="M:Graphics.Point.op_Inequality(Graphics.Point,Graphics.Point)"/> </member>

<member name="M:Graphics.Point.ToString"> <summary>Report a point's location as a string.</summary> <returns>A string representing a point's location, in the form (x,y), without any leading, training, or embedded whitespace.</returns> </member>

<member name="M:Graphics.Point.op_Equality(Graphics.Point,Graphics.Point)"> <summary>This operator determines whether two Points have the same location.</summary> <param><c>p1</c> is the first Point to be compared.</param> <param><c>p2</c> is the second Point to be compared.</param> <returns>True if the Points have the same location and they have the exact same type; otherwise, false.</returns> <seealso cref="M:Graphics.Point.Equals(System.Object)"/> <seealso cref="M:Graphics.Point.op_Inequality(Graphics.Point,Graphics.Point)"/> </member>

<member name="M:Graphics.Point.op_Inequality(Graphics.Point,Graphics.Point)"> <summary>This operator determines whether two Points have the same location.</summary> <param><c>p1</c> is the first Point to be compared.</param> <param><c>p2</c> is the second Point to be compared.</param> <returns>True if the Points do not have the same location and the exact same type; otherwise, false.</returns> <seealso cref="M:Graphics.Point.Equals(System.Object)"/> <seealso cref="M:Graphics.Point.op_Equality(Graphics.Point,Graphics.Point)"/> </member>

<member name="M:Graphics.Point.Main"> <summary>This is the entry point of the Point class testing program. <para>This program tests each method and operator, and is intended to be run after any non-trvial maintenance has been performed on the Point class.</para></summary> </member>

<member name="P:Graphics.Point.X"> <value>Property <c>X</c> represents the point's x-coordinate.</value> </member>

<member name="P:Graphics.Point.Y"> <value>Property <c>Y</c> represents the point's y-coordinate.</value> </member> </members> </doc>

2. Грамматика

Это приложение содержит сводные сведения о лексике и синтаксисе, используемых в основном документе, а также о грамматических расширениях для небезопасного кода. Грамматические конструкции отображаются здесь в том же порядке, в котором они представлены в основном документе.

1. Лексика

ввод: раздел_ввода_{необязательно}

раздел_ввода: часть_раздела_ввода раздел_ввода часть_раздела_ввода

часть_раздела_ввода: элементы_ввода_{необязательно} новая_строка директива_предварительной_обработки

элементы_ввода: элемент_ввода элементы_ввода элемент_ввода

элемент_ввода: пробел примечание лексема

1. Знаки завершения строки

новая_строка: Символ возврата каретки (U+000D) Символ перевода строки (U+000A) Символ возврата каретки (U+000D), за которым следует знак перевода строки (U+000A) Символ следующей строки (U+0085) Символ разделителя строк (U+2028) Символ разделителя абзацев (U+2029)

2. Комментарии

комментарий: однострочный_комментарий комментарий_с_разделами

однострочный_комментарий: // входные_символы_{необязательно}

входные_символы: входной_символ входные_символы входной_символ

входной_символ: Любой знак Юникода за исключением символа_следующей_строки

символ_следующей_строки: Символ возврата каретки (U+000D) Символ перевода строки (U+000A) Символ следующей строки (U+0085) Символ разделителя строк (U+2028) Символ разделителя абзацев (U+2029)

комментарий_с_разделами: /* текст_комментария_с_разделами_{необязательно} звездочка /

текст_комментария_с_разделами: раздел_комментария_с_разделами текст_комментария_с_разделами раздел_комментария_с_разделами

раздел_комментария_с_разделами: / звездочка_{необязательно} не_косая_черта_и_не_звездочка

звездочка: * звездочка *

не_косая_черта_и_не_звездочка: Любой знак Юникода за исключением косой черты (/) или звездочки (*)

3. Пробел

пробел: Любой символа класса Юникода Zs Символ горизонтальной табуляции (U+0009) Символ вертикальной табуляции (U+000B) Символ перехода к другой форме (U+000C)

4. Маркеры

маркер: идентификатор ключевое_слово целочисленный_литерал действительный_литерал символьный_литерал строковый_литерал оператор_или_знак_пунктуации

5. Управляющие последовательности символов Юникода

управляющая_последовательность_Юникода: \u шестнадцатеричная_цифра шестнадцатеричная_цифра шестнадцатеричная_цифра шестнадцатеричная_цифра \U шестнадцатеричная_цифра шестнадцатеричная_цифра шестнадцатеричная_цифра шестнадцатеричная_цифра шестнадцатеричная_цифра шестнадцатеричная_цифра шестнадцатеричная_цифра шестнадцатеричная_цифра

6. Идентификаторы

идентификатор: доступный_идентификатор @ идентификатор_или_ключевое_слово

доступный_идентификатор: идентификатор_или_ключевое_слово, не являющиеся ключевым_словом

идентификатор_или_ключевое_слово: начальный_символ_идентификатора символы_части_идентификатора_{необязательно}

начальный_символ_идентификатора: буква _ (знак подчеркивания, U+005F)

символы_части_идентификатора: символ_части_идентификатора символы_части_идентификатора символ_части_идентификатора

символ_части_идентификатора: буква десятичная_цифра соединитель несамостоятельный_символ символ_управления_форматом

буква: Символ Юникода классов Lu, Ll, Lt, Lm, Lo или Nl управляющая_последовательность_Юникода, представляющая символы классов Lu, Ll, Lt, Lm, Lo или Nl

несамостоятельный_символ: Символ Юникода классов Mn или Mc управляющая_последовательность_Юникода, представляющая символ классов Mn или Mc

десятичная_цифра: Символ Юникода класса Nd управляющая_последовательность_Юникода, представляющая символ класса Nd

символ-соединитель: Символ Юникода класса Pc управляющая_последовательность_Юникода, представляющая символ класса Pc

символ_управления_форматом: Символ Юникода класса Cf Управляющая_последовательность_Юникода, представляющая символ класса Cf