diff options
| author | Alexander Köplinger <alex.koeplinger@outlook.com> | 2014-11-07 14:34:26 +0300 |
|---|---|---|
| committer | Duncan Mak <duncanm@microsoft.com> | 2016-10-08 03:30:48 +0300 |
| commit | 09263e4e599f8d5037e2743fa3109d70478e4e95 (patch) | |
| tree | f3f595881c5d8639b9dee25c2ab6cbb22743f7ee /mdoc/Test | |
| parent | 6fce47748596844e372bd4a50aaea444a9e8aa26 (diff) | |
[mdoc] Refreshed the en.expected.importecmadoc files to fix errors after the recent XML changes
The XML work in 661430fd1f052c5589bcd5d116f37b9ee4e27210 and bf39f5aec034800abcfe5e73a63ddd1414cb8078 changed the whitespace handling, so the mdoc test suite failed.
Refreshing the files makes them identical to what MS.NET produces and fixes the mdoc tests.
Diffstat (limited to 'mdoc/Test')
4 files changed, 93 insertions, 92 deletions
diff --git a/mdoc/Test/en.expected.importecmadoc/System/Action`1.xml b/mdoc/Test/en.expected.importecmadoc/System/Action`1.xml index 745c5153..9337d6d7 100644 --- a/mdoc/Test/en.expected.importecmadoc/System/Action`1.xml +++ b/mdoc/Test/en.expected.importecmadoc/System/Action`1.xml @@ -21,12 +21,13 @@ <typeparam name="T">To be added.</typeparam> <param name="obj">The object on which to perform an action.</param> <summary> - <para> Represents the method that performs an action on the specified object.</para> - </summary> + <para> Represents the method that performs an action on the specified object.</para> + </summary> <remarks> - <block subset="none" type="note"> - <para>This delegate is used by the method <see cref="M:System.Array.ForEach" /><see langword="(T[], Action<T>)" />, and in <see cref="T:System.Collections.Generic.List<T>" /> to perform an action on each element of the collection.</para> - </block> - </remarks> + <block subset="none" type="note"> + <para>This delegate is used by the method <see cref="M:System.Array.ForEach" /> + <see langword="(T[], Action<T>)" />, and in <see cref="T:System.Collections.Generic.List<T>" /> to perform an action on each element of the collection.</para> + </block> + </remarks> </Docs> </Type> diff --git a/mdoc/Test/en.expected.importecmadoc/System/Array.xml b/mdoc/Test/en.expected.importecmadoc/System/Array.xml index 96aee607..91084a09 100644 --- a/mdoc/Test/en.expected.importecmadoc/System/Array.xml +++ b/mdoc/Test/en.expected.importecmadoc/System/Array.xml @@ -11,76 +11,76 @@ <Interfaces /> <Docs> <summary> - <para> Serves as the base class for arrays. Provides methods for creating, + <para> Serves as the base class for arrays. Provides methods for creating, copying, manipulating, searching, and sorting arrays.</para> - </summary> + </summary> <remarks> - <para>This class is intended to be used as a base class by + <para>This class is intended to be used as a base class by language implementations that support arrays. Only the system can derive from this type: derived classes of <see cref="T:System.Array" /> are not to be created by the developer.</para> - <block subset="none" type="note"> - <para>An array is a collection of + <block subset="none" type="note"> + <para>An array is a collection of identically typed data <paramref name="elements" /> that are accessed and referenced by sets of integral <paramref name="indices" />. </para> - <para>The <paramref name="rank" /> of an array is the number + <para>The <paramref name="rank" /> of an array is the number of dimensions in the array. Each dimension has its own set of indices. An array with a rank greater than one can have a different lower bound and a different number of elements for each dimension. Multidimensional arrays (i.e. arrays with a rank greater than one) are processed in row-major order. </para> - <para>The <paramref name="lower bound" /> of a dimension + <para>The <paramref name="lower bound" /> of a dimension is the starting index of that dimension. </para> - <para>The <paramref name="length" /> of an array is the total number of elements contained in all of its + <para>The <paramref name="length" /> of an array is the total number of elements contained in all of its dimensions. </para> - <para>A <paramref name="vector" /> is a + <para>A <paramref name="vector" /> is a one-dimensional array with a <paramref name="lower bound" /> of '0'. </para> - <para>If the implementer creates a derived class of <see cref="T:System.Array" />, expected <see cref="T:System.Array" /> behavior + <para>If the implementer creates a derived class of <see cref="T:System.Array" />, expected <see cref="T:System.Array" /> behavior cannot be guaranteed. For information on array-like objects with increased functionality, see the <see cref="T:System.Collections.IList" /> and <see cref="T:System.Collections.Generic.IList<T>" /> interfaces. For more information regarding the use of arrays versus the use of collections, see Partition V of the CLI Specification. </para> - </block> - <para>Every specific <see cref="T:System.Array" /> type has three instance methods defined on it. + </block> + <para>Every specific <see cref="T:System.Array" /> type has three instance methods defined on it. While some programming languages allow direct access to these methods, they are primarily intended to be called by the output of compilers based on language syntax that deals with arrays. </para> - <list type="bullet"> - <item> - <term> - <para> - <c>Get</c>: Takes as many <see cref="T:System.Int32" /> arguments as the array + <list type="bullet"> + <item> + <term> + <para> + <c>Get</c>: Takes as many <see cref="T:System.Int32" /> arguments as the array has dimensions and returns the value stored at the given index. It throws a <see cref="T:System.IndexOutOfRangeException" /> exception for invalid indices. </para> - </term> - </item> - <item> - <term> - <para> - <c>Set</c>: Takes as many <see cref="T:System.Int32" /> arguments as the array + </term> + </item> + <item> + <term> + <para> + <c>Set</c>: Takes as many <see cref="T:System.Int32" /> arguments as the array has dimensions, plus one additional argument (the last argument) which has the same type as an array element. It stores the final value in the specified index of the array. It throws a <see cref="T:System.IndexOutOfRangeException" /> exception for invalid indices. </para> - </term> - </item> - <item> - <term> - <para> - <c>Address</c>: Takes as many <see cref="T:System.Int32" /> arguments as the + </term> + </item> + <item> + <term> + <para> + <c>Address</c>: Takes as many <see cref="T:System.Int32" /> arguments as the array has dimensions and returns the address of the element at the given index. It throws a <see cref="T:System.IndexOutOfRangeException" /> exception for invalid indices. </para> - </term> - </item> - </list> - <para>In addition, every specific <see cref="T:System.Array" /> type has a constructor on it that takes as many non-negative + </term> + </item> + </list> + <para>In addition, every specific <see cref="T:System.Array" /> type has a constructor on it that takes as many non-negative <see cref="T:System.Int32" /> arguments as the array has dimensions. The arguments specify the number of elements in each dimension, and a lower bound of 0. Thus, a two-dimensional array of <see cref="T:System.Int32" /> objects would have a constructor that could be called with <c>(2, 4)</c> as its arguments to create an array of eight zeros with the first dimension indexed with 0 and 1 and the second dimension indexed with 0, 1, 2, and 3. </para> - <para>For all specific array types except vectors (i.e. those + <para>For all specific array types except vectors (i.e. those permitted to have non-zero lower bounds and those with more than one dimension) there is an additional constructor. It takes twice as many arguments as the array has dimensions. The arguments are considered in pairs, with the first of @@ -91,9 +91,9 @@ with 0 and 1 and the second dimension indexed with 0, 1, 2, and 3. </para> objects would also have a constructor that could be called with <c>(-1, 2, 1, 3)</c> as its arguments, specifying an array of 6 zeros, with the first dimension indexed by -1 and 0, and the second dimension indexed by 1, 2, and 3. </para> - <para>Enumeration over an array occurs in ascending row-major order, starting from the first element. (For example, a 2x3 array is traversed in the order [0,0], [0,1], [0,2], [1,0], [1,1], and [1,2].)</para> - <para>Parallel implementation of methods taking a <see cref="T:System.Predicate" /> argument are not permitted.</para> - </remarks> + <para>Enumeration over an array occurs in ascending row-major order, starting from the first element. (For example, a 2x3 array is traversed in the order [0,0], [0,1], [0,2], [1,0], [1,1], and [1,2].)</para> + <para>Parallel implementation of methods taking a <see cref="T:System.Predicate" /> argument are not permitted.</para> + </remarks> </Docs> <Members> <Member MemberName=".ctor"> @@ -158,21 +158,21 @@ and the second dimension indexed by 1, 2, and 3. </para> <typeparam name="TOutput">To be added.</typeparam> <param name="array">The one-dimensional array to convert.</param> <param name="converter"> - <para>A <see cref="T:System.Converter<T,U>" /> that converts each element from one type to another type.</para> - </param> + <para>A <see cref="T:System.Converter<T,U>" /> that converts each element from one type to another type.</para> + </param> <summary> - <para>Converts an array of one type to an array of another type.</para> - </summary> + <para>Converts an array of one type to an array of another type.</para> + </summary> <returns> - <para>A new array of the target type containing the converted elements from <paramref name="array" />.</para> - </returns> + <para>A new array of the target type containing the converted elements from <paramref name="array" />.</para> + </returns> <remarks> - <para>The <see cref="T:System.Converter<T,U>" /> is a delegate that converts an array element to the target type. The elements of <paramref name="array" /> are individually passed to this converter, and the converted elements are saved in the new array. The source array remains unchanged.</para> - </remarks> + <para>The <see cref="T:System.Converter<T,U>" /> is a delegate that converts an array element to the target type. The elements of <paramref name="array" /> are individually passed to this converter, and the converted elements are saved in the new array. The source array remains unchanged.</para> + </remarks> <exception cref="T:System.InvalidOperationException">To be added; from: <see cref="M:System.Array.ConvertAll``2(``0[],System.Converter{``0,``1})" /></exception> <exception cref="T:System.ArgumentNullException"> - <paramref name="array" /> is <see langword="null" /> or <paramref name="converter" /> is <see langword="null" />.</exception> + <paramref name="array" /> is <see langword="null" /> or <paramref name="converter" /> is <see langword="null" />.</exception> </Docs> </Member> <Member MemberName="Resize<T>"> diff --git a/mdoc/Test/en.expected.importecmadoc/System/AsyncCallback.xml b/mdoc/Test/en.expected.importecmadoc/System/AsyncCallback.xml index a232e3c2..b5bcde6d 100644 --- a/mdoc/Test/en.expected.importecmadoc/System/AsyncCallback.xml +++ b/mdoc/Test/en.expected.importecmadoc/System/AsyncCallback.xml @@ -17,8 +17,8 @@ <Docs> <param name="ar">A <see cref="T:System.IAsyncResult" /> object containing information about the asynchronous operation that has completed.</param> <summary> - <para> References one or more methods called when an asynchronous operation completes.</para> - </summary> + <para> References one or more methods called when an asynchronous operation completes.</para> + </summary> <remarks>To be added.</remarks> </Docs> </Type> diff --git a/mdoc/Test/en.expected.importecmadoc/System/Environment.xml b/mdoc/Test/en.expected.importecmadoc/System/Environment.xml index f7a5f40c..40a9735e 100644 --- a/mdoc/Test/en.expected.importecmadoc/System/Environment.xml +++ b/mdoc/Test/en.expected.importecmadoc/System/Environment.xml @@ -11,34 +11,34 @@ <Interfaces /> <Docs> <summary> - <para> Provides the current settings for, and information about, the execution environment.</para> - </summary> + <para> Provides the current settings for, and information about, the execution environment.</para> + </summary> <remarks> - <block subset="none" type="note"> - <para>Use this class to retrieve the following + <block subset="none" type="note"> + <para>Use this class to retrieve the following information:</para> - <list type="bullet"> - <item> - <term>Command line arguments</term> - </item> - <item> - <term>Exit codes</term> - </item> - <item> - <term>Environment variable settings</term> - </item> - <item> - <term>Contents of the call stack</term> - </item> - <item> - <term>Time since last system boot</term> - </item> - <item> - <term>Version of the execution engine</term> - </item> - </list> - </block> - </remarks> + <list type="bullet"> + <item> + <term>Command line arguments</term> + </item> + <item> + <term>Exit codes</term> + </item> + <item> + <term>Environment variable settings</term> + </item> + <item> + <term>Contents of the call stack</term> + </item> + <item> + <term>Time since last system boot</term> + </item> + <item> + <term>Version of the execution engine</term> + </item> + </list> + </block> + </remarks> </Docs> <Members> <Member MemberName="GetFolderPath"> @@ -56,28 +56,28 @@ </Parameters> <Docs> <param name="folder"> - <para>A <see cref="T:System.Environment+SpecialFolder" />.</para> - </param> + <para>A <see cref="T:System.Environment+SpecialFolder" />.</para> + </param> <summary> - <para> Returns the arguments specified on the command + <para> Returns the arguments specified on the command line.</para> - </summary> + </summary> <returns> - <para> Returns a <see cref="T:System.String" /> array. Each <see cref="T:System.String" /> in the array + <para> Returns a <see cref="T:System.String" /> array. Each <see cref="T:System.String" /> in the array contains a single command line argument.</para> - </returns> + </returns> <remarks> - <para>The first element in the array contains the filename of + <para>The first element in the array contains the filename of the executing program. If the filename is not available, the first element is equal to <see cref="F:System.String.Empty" />. The remaining elements contain any additional tokens entered on the command line.</para> - <block subset="none" type="note"> - <para>The program filename can, but is not required to, + <block subset="none" type="note"> + <para>The program filename can, but is not required to, include path information.</para> - <para>To obtain the command line as a single <see cref="T:System.String" />, use the <see cref="P:System.Environment.CommandLine" /> + <para>To obtain the command line as a single <see cref="T:System.String" />, use the <see cref="P:System.Environment.CommandLine" /> property.</para> - </block> - </remarks> + </block> + </remarks> <exception cref="T:System.NotSupportedException">To be added; from: <see cref="M:System.Environment.GetFolderPath(System.Environment.SpecialFolder)" /></exception> <exception cref="T:System.ArgumentException">foo</exception> |