diff options
author | Jonathan Pryor <jonpryor@vt.edu> | 2011-06-09 22:27:55 +0400 |
---|---|---|
committer | Duncan Mak <duncanm@microsoft.com> | 2016-10-08 03:29:31 +0300 |
commit | 011a556fb857ae9113f6f0a48ed72b2ac8d7e015 (patch) | |
tree | c822a1ebc6f173843f527b20ce7c16298e0ace4d /mdoc/Test | |
parent | e8dae379eed880d7fc0972635c79a2651495a41c (diff) |
[mdoc-update] Generate proper lower bounds for multi-dimensional arrays.
Consider the method `void M(double[,,])`. When attempting to import
documentation for this method, `mdoc-update` should generate the CREF
"M(System.Double[0:,0:,0:])", otherwise some documentation isn't imported.
Due to this (and `mcs /doc`-related fixes) and other changes, flush the
expected output as more docs are properly imported.
Diffstat (limited to 'mdoc/Test')
7 files changed, 111 insertions, 115 deletions
diff --git a/mdoc/Test/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml b/mdoc/Test/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml index b0cf4b8a..82b4148e 100644 --- a/mdoc/Test/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml +++ b/mdoc/Test/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`1.xml @@ -195,11 +195,12 @@ <Parameter Name="helper" Type="Mono.DocTest.Generic.MyList<T>+Helper<U,V>" /> </Parameters> <Docs> - <typeparam name="U">To be added.</typeparam> - <typeparam name="V">To be added.</typeparam> - <param name="helper">To be added.</param> + <typeparam name="U">Argh!</typeparam> + <typeparam name="V">Foo Argh!</typeparam> + <param name="helper">A <see cref="T:Mono.DocTest.Generic.MyList`1.Helper`2" />.</param> <summary>To be added.</summary> - <remarks>To be added.</remarks> + <remarks> + <c>M:Mono.DocTest.Generic.MyList`1.UseHelper``2(Mono.DocTest.Generic.MyList{``0}.Helper{``1,``2})</c>.</remarks> </Docs> </Member> </Members> diff --git a/mdoc/Test/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml b/mdoc/Test/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml index a9030450..c59fe073 100644 --- a/mdoc/Test/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml +++ b/mdoc/Test/en.expected.importslashdoc/Mono.DocTest.Generic/MyList`2.xml @@ -187,12 +187,13 @@ <Parameter Name="u" Type="U" /> </Parameters> <Docs> - <typeparam name="U">To be added.</typeparam> + <typeparam name="U">U generic param on MyList`2</typeparam> <param name="a">To be added.</param> <param name="u">To be added.</param> <summary>To be added.</summary> <returns>To be added.</returns> - <remarks>To be added.</remarks> + <remarks> + <c>M:Mono.DocTest.Generic.MyList`2.Mono#DocTest#Generic#IFoo{A}#Method``1(`0,``0)</c>.</remarks> </Docs> </Member> <Member MemberName="MoveNext"> @@ -246,9 +247,10 @@ <Parameter Name="item" Type="A" /> </Parameters> <Docs> - <param name="item">To be added.</param> + <param name="item">The item to add.</param> <summary>To be added.</summary> - <remarks>To be added.</remarks> + <remarks> + <c>M:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}#Add(`0)</c>.</remarks> </Docs> </Member> <Member MemberName="System.Collections.Generic.ICollection<A>.Clear"> @@ -264,7 +266,8 @@ <Parameters /> <Docs> <summary>To be added.</summary> - <remarks>To be added.</remarks> + <remarks> + <c>M:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}#Clear</c>.</remarks> </Docs> </Member> <Member MemberName="System.Collections.Generic.ICollection<A>.Contains"> @@ -281,10 +284,11 @@ <Parameter Name="item" Type="A" /> </Parameters> <Docs> - <param name="item">To be added.</param> + <param name="item">The item to check for</param> <summary>To be added.</summary> - <returns>To be added.</returns> - <remarks>To be added.</remarks> + <returns>A <see cref="T:System.Boolean" /> instance (<see langword="false" />).</returns> + <remarks> + <c>M:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}.Contains(`0)</c>.</remarks> </Docs> </Member> <Member MemberName="System.Collections.Generic.ICollection<A>.IsReadOnly"> @@ -299,8 +303,9 @@ </ReturnValue> <Docs> <summary>To be added.</summary> - <value>To be added.</value> - <remarks>To be added.</remarks> + <value>A <see cref="T:System.Boolean" />.</value> + <remarks> + <c>P:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}#IsReadOnly</c>.</remarks> </Docs> </Member> <Member MemberName="System.Collections.Generic.ICollection<A>.Remove"> @@ -317,10 +322,11 @@ <Parameter Name="item" Type="A" /> </Parameters> <Docs> - <param name="item">To be added.</param> + <param name="item">the item to remove</param> <summary>To be added.</summary> - <returns>To be added.</returns> - <remarks>To be added.</remarks> + <returns>Whether the item was removed.</returns> + <remarks> + <c>M:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}#Remove(`0)</c>.</remarks> </Docs> </Member> <Member MemberName="System.Collections.Generic.IEnumerable<A>.GetEnumerator"> @@ -336,8 +342,9 @@ <Parameters /> <Docs> <summary>To be added.</summary> - <returns>To be added.</returns> - <remarks>To be added.</remarks> + <returns>A <see cref="T:System.Collections.Generic.IEnumerator{`0}" />.</returns> + <remarks> + <c>M:Mono.DocTest.MyList`2.System#Collections#Generic#IEnumerable{A}#GetEnumerator</c>.</remarks> </Docs> </Member> <Member MemberName="System.Collections.Generic.IEnumerator<A>.Current"> @@ -352,8 +359,9 @@ </ReturnValue> <Docs> <summary>To be added.</summary> - <value>To be added.</value> - <remarks>To be added.</remarks> + <value>The current value.</value> + <remarks> + <c>P:Mono.DocTest.MyList`2.Current</c>.</remarks> </Docs> </Member> <Member MemberName="System.Collections.IEnumerable.GetEnumerator"> diff --git a/mdoc/Test/en.expected.importslashdoc/Mono.DocTest/UseLists.xml b/mdoc/Test/en.expected.importslashdoc/Mono.DocTest/UseLists.xml index 983cf0fd..37b8e401 100644 --- a/mdoc/Test/en.expected.importslashdoc/Mono.DocTest/UseLists.xml +++ b/mdoc/Test/en.expected.importslashdoc/Mono.DocTest/UseLists.xml @@ -172,12 +172,19 @@ <Parameter Name="helper" Type="Mono.DocTest.Generic.MyList<T>+Helper<U,V>" /> </Parameters> <Docs> - <typeparam name="T">To be added.</typeparam> - <typeparam name="U">To be added.</typeparam> - <typeparam name="V">To be added.</typeparam> - <param name="helper">To be added.</param> + <typeparam name="T"> + <c>T</c> + </typeparam> + <typeparam name="U"> + <c>U</c> + </typeparam> + <typeparam name="V"> + <c>V</c> + </typeparam> + <param name="helper">A <see cref="T:Mono.DocTest.Generic.MyList{``0}.Helper{``1,``2}" />.</param> <summary>To be added.</summary> - <remarks>To be added.</remarks> + <remarks> + <c>M:Mono.DocTest.UseLists.UseHelper``3(Mono.DocTest.Generic.MyList{``0}.Helper{``1,``2})</c>.</remarks> </Docs> </Member> </Members> diff --git a/mdoc/Test/html.expected/Mono.DocTest.Generic/MyList`1.html b/mdoc/Test/html.expected/Mono.DocTest.Generic/MyList`1.html index e84ab437..da020467 100644 --- a/mdoc/Test/html.expected/Mono.DocTest.Generic/MyList`1.html +++ b/mdoc/Test/html.expected/Mono.DocTest.Generic/MyList`1.html @@ -658,15 +658,11 @@ <dt> <i>U</i> </dt> - <dd> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </dd> + <dd>Argh!</dd> <dt> <i>V</i> </dt> - <dd> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </dd> + <dd>Foo Argh!</dd> </dl> </blockquote> <h4 class="Subsection">Parameters</h4> @@ -675,15 +671,12 @@ <dt> <i>helper</i> </dt> - <dd> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </dd> + <dd>A <a href="../Mono.DocTest.Generic/MyList`1+Helper`2.html">Mono.DocTest.Generic.MyList`1.Helper`2</a>.</dd> </dl> </blockquote> <h2 class="Section">Remarks</h2> <div class="SectionBox" id="M:Mono.DocTest.Generic.MyList`1.UseHelper``2(Mono.DocTest.Generic.MyList{`0}.Helper{``0,``1}):Remarks"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </div> + <tt>M:Mono.DocTest.Generic.MyList`1.UseHelper``2(Mono.DocTest.Generic.MyList{``0}.Helper{``1,``2})</tt>.</div> <h2 class="Section">Requirements</h2> <div class="SectionBox" id="M:Mono.DocTest.Generic.MyList`1.UseHelper``2(Mono.DocTest.Generic.MyList{`0}.Helper{``0,``1}):Version Information"> <b>Namespace: </b>Mono.DocTest.Generic<br /><b>Assembly: </b>DocTest (in DocTest.dll)<br /><b>Assembly Versions: </b>0.0.0.0</div> diff --git a/mdoc/Test/html.expected/Mono.DocTest.Generic/MyList`2.html b/mdoc/Test/html.expected/Mono.DocTest.Generic/MyList`2.html index 8e710699..4766687f 100644 --- a/mdoc/Test/html.expected/Mono.DocTest.Generic/MyList`2.html +++ b/mdoc/Test/html.expected/Mono.DocTest.Generic/MyList`2.html @@ -759,16 +759,14 @@ </p> <h2>Syntax</h2> <div class="Signature"> - <i title="Ako generic param">A</i> <b>Mono.DocTest.Generic.IFoo<U></b> (<i title="Ako generic param">A</i> a, <i title="To be added.">U</i> u)</div> + <i title="Ako generic param">A</i> <b>Mono.DocTest.Generic.IFoo<U></b> (<i title="Ako generic param">A</i> a, <i title="U generic param on MyList`2">U</i> u)</div> <h4 class="Subsection">Type Parameters</h4> <blockquote class="SubsectionBox" id="M:Mono.DocTest.Generic.MyList`2.Mono#DocTest#Generic#IFoo``1(`0,``0):Type Parameters"> <dl> <dt> <i>U</i> </dt> - <dd> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </dd> + <dd>U generic param on MyList`2</dd> </dl> </blockquote> <h4 class="Subsection">Parameters</h4> @@ -794,8 +792,7 @@ </blockquote> <h2 class="Section">Remarks</h2> <div class="SectionBox" id="M:Mono.DocTest.Generic.MyList`2.Mono#DocTest#Generic#IFoo``1(`0,``0):Remarks"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </div> + <tt>M:Mono.DocTest.Generic.MyList`2.Mono#DocTest#Generic#IFoo{A}#Method``1(`0,``0)</tt>.</div> <h2 class="Section">Requirements</h2> <div class="SectionBox" id="M:Mono.DocTest.Generic.MyList`2.Mono#DocTest#Generic#IFoo``1(`0,``0):Version Information"> <b>Namespace: </b>Mono.DocTest.Generic<br /><b>Assembly: </b>DocTest (in DocTest.dll)<br /><b>Assembly Versions: </b>0.0.0.0</div> @@ -849,15 +846,12 @@ <dt> <i>item</i> </dt> - <dd> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </dd> + <dd>The item to add.</dd> </dl> </blockquote> <h2 class="Section">Remarks</h2> <div class="SectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Add(`0):Remarks"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </div> + <tt>M:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}#Add(`0)</tt>.</div> <h2 class="Section">Requirements</h2> <div class="SectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Add(`0):Version Information"> <b>Namespace: </b>Mono.DocTest.Generic<br /><b>Assembly: </b>DocTest (in DocTest.dll)<br /><b>Assembly Versions: </b>0.0.0.0</div> @@ -873,8 +867,7 @@ <a href="http://www.go-mono.com/docs/monodoc.ashx?link=T:System.Void">void</a> <b>System.Collections.Generic.ICollection<A>.Clear</b> ()</div> <h2 class="Section">Remarks</h2> <div class="SectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Clear:Remarks"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </div> + <tt>M:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}#Clear</tt>.</div> <h2 class="Section">Requirements</h2> <div class="SectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Clear:Version Information"> <b>Namespace: </b>Mono.DocTest.Generic<br /><b>Assembly: </b>DocTest (in DocTest.dll)<br /><b>Assembly Versions: </b>0.0.0.0</div> @@ -894,19 +887,14 @@ <dt> <i>item</i> </dt> - <dd> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </dd> + <dd>The item to check for</dd> </dl> </blockquote> <h4 class="Subsection">Returns</h4> - <blockquote class="SubsectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Contains(`0):Returns"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </blockquote> + <blockquote class="SubsectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Contains(`0):Returns">A <a href="http://www.go-mono.com/docs/monodoc.ashx?link=T:System.Boolean">bool</a> instance (<tt>false</tt>).</blockquote> <h2 class="Section">Remarks</h2> <div class="SectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Contains(`0):Remarks"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </div> + <tt>M:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}.Contains(`0)</tt>.</div> <h2 class="Section">Requirements</h2> <div class="SectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Contains(`0):Version Information"> <b>Namespace: </b>Mono.DocTest.Generic<br /><b>Assembly: </b>DocTest (in DocTest.dll)<br /><b>Assembly Versions: </b>0.0.0.0</div> @@ -921,13 +909,10 @@ <div class="Signature"> <a href="http://www.go-mono.com/docs/monodoc.ashx?link=T:System.Boolean">bool</a> <b>System.Collections.Generic.ICollection<A>.IsReadOnly</b> { get; }</div> <h4 class="Subsection">Value</h4> - <blockquote class="SubsectionBox" id="P:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#IsReadOnly:Value"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </blockquote> + <blockquote class="SubsectionBox" id="P:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#IsReadOnly:Value">A <a href="http://www.go-mono.com/docs/monodoc.ashx?link=T:System.Boolean">bool</a>.</blockquote> <h2 class="Section">Remarks</h2> <div class="SectionBox" id="P:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#IsReadOnly:Remarks"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </div> + <tt>P:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}#IsReadOnly</tt>.</div> <h2 class="Section">Requirements</h2> <div class="SectionBox" id="P:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#IsReadOnly:Version Information"> <b>Namespace: </b>Mono.DocTest.Generic<br /><b>Assembly: </b>DocTest (in DocTest.dll)<br /><b>Assembly Versions: </b>0.0.0.0</div> @@ -947,19 +932,14 @@ <dt> <i>item</i> </dt> - <dd> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </dd> + <dd>the item to remove</dd> </dl> </blockquote> <h4 class="Subsection">Returns</h4> - <blockquote class="SubsectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Remove(`0):Returns"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </blockquote> + <blockquote class="SubsectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Remove(`0):Returns">Whether the item was removed.</blockquote> <h2 class="Section">Remarks</h2> <div class="SectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Remove(`0):Remarks"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </div> + <tt>M:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}#Remove(`0)</tt>.</div> <h2 class="Section">Requirements</h2> <div class="SectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Remove(`0):Version Information"> <b>Namespace: </b>Mono.DocTest.Generic<br /><b>Assembly: </b>DocTest (in DocTest.dll)<br /><b>Assembly Versions: </b>0.0.0.0</div> @@ -974,13 +954,10 @@ <div class="Signature"> <a href="http://www.go-mono.com/docs/monodoc.ashx?link=T:System.Collections.Generic.IEnumerator`1">IEnumerator<A></a> <b>System.Collections.Generic.IEnumerable<A>.GetEnumerator</b> ()</div> <h4 class="Subsection">Returns</h4> - <blockquote class="SubsectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#IEnumerable{A}#GetEnumerator:Returns"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </blockquote> + <blockquote class="SubsectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#IEnumerable{A}#GetEnumerator:Returns">A <a href="http://www.go-mono.com/docs/monodoc.ashx?link=T:System.Collections.Generic.IEnumerator`1">IEnumerator<`0></a>.</blockquote> <h2 class="Section">Remarks</h2> <div class="SectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#IEnumerable{A}#GetEnumerator:Remarks"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </div> + <tt>M:Mono.DocTest.MyList`2.System#Collections#Generic#IEnumerable{A}#GetEnumerator</tt>.</div> <h2 class="Section">Requirements</h2> <div class="SectionBox" id="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#IEnumerable{A}#GetEnumerator:Version Information"> <b>Namespace: </b>Mono.DocTest.Generic<br /><b>Assembly: </b>DocTest (in DocTest.dll)<br /><b>Assembly Versions: </b>0.0.0.0</div> @@ -995,13 +972,10 @@ <div class="Signature"> <i title="Ako generic param">A</i> <b>System.Collections.Generic.IEnumerator<A>.Current</b> { get; }</div> <h4 class="Subsection">Value</h4> - <blockquote class="SubsectionBox" id="P:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#IEnumerator{A}#Current:Value"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </blockquote> + <blockquote class="SubsectionBox" id="P:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#IEnumerator{A}#Current:Value">The current value.</blockquote> <h2 class="Section">Remarks</h2> <div class="SectionBox" id="P:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#IEnumerator{A}#Current:Remarks"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </div> + <tt>P:Mono.DocTest.MyList`2.Current</tt>.</div> <h2 class="Section">Requirements</h2> <div class="SectionBox" id="P:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#IEnumerator{A}#Current:Version Information"> <b>Namespace: </b>Mono.DocTest.Generic<br /><b>Assembly: </b>DocTest (in DocTest.dll)<br /><b>Assembly Versions: </b>0.0.0.0</div> diff --git a/mdoc/Test/html.expected/Mono.DocTest/UseLists.html b/mdoc/Test/html.expected/Mono.DocTest/UseLists.html index 51a6dfa8..fba5a9f6 100644 --- a/mdoc/Test/html.expected/Mono.DocTest/UseLists.html +++ b/mdoc/Test/html.expected/Mono.DocTest/UseLists.html @@ -578,19 +578,19 @@ <i>T</i> </dt> <dd> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> + <tt>T</tt> </dd> <dt> <i>U</i> </dt> <dd> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> + <tt>U</tt> </dd> <dt> <i>V</i> </dt> <dd> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> + <tt>V</tt> </dd> </dl> </blockquote> @@ -600,15 +600,12 @@ <dt> <i>helper</i> </dt> - <dd> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </dd> + <dd>A <a href="../Mono.DocTest.Generic/MyList`1+Helper`2.html">Mono.DocTest.Generic.MyList<``0>.Helper<``1, ``2></a>.</dd> </dl> </blockquote> <h2 class="Section">Remarks</h2> <div class="SectionBox" id="M:Mono.DocTest.UseLists.UseHelper``3(Mono.DocTest.Generic.MyList{``0}.Helper{``1,``2}):Remarks"> - <span class="NotEntered">Documentation for this section has not yet been entered.</span> - </div> + <tt>M:Mono.DocTest.UseLists.UseHelper``3(Mono.DocTest.Generic.MyList{``0}.Helper{``1,``2})</tt>.</div> <h2 class="Section">Requirements</h2> <div class="SectionBox" id="M:Mono.DocTest.UseLists.UseHelper``3(Mono.DocTest.Generic.MyList{``0}.Helper{``1,``2}):Version Information"> <b>Namespace: </b>Mono.DocTest<br /><b>Assembly: </b>DocTest (in DocTest.dll)<br /><b>Assembly Versions: </b>0.0.0.0</div> diff --git a/mdoc/Test/msxdoc-expected.importslashdoc.xml b/mdoc/Test/msxdoc-expected.importslashdoc.xml index ce4da95f..a8497975 100644 --- a/mdoc/Test/msxdoc-expected.importslashdoc.xml +++ b/mdoc/Test/msxdoc-expected.importslashdoc.xml @@ -169,12 +169,19 @@ class Example { <exception cref="T:System.ArgumentNullException">To be added; from: <see cref="M:System.Linq.Check.SourceAndPredicate(System.Object,System.Object)" />, <see cref="M:System.Linq.Check.SourceAndPredicate(System.Object,System.Object)" /></exception> </member> <member name="M:Mono.DocTest.UseLists.UseHelper``3(Mono.DocTest.Generic.MyList{``0}+Helper{``1,``2})"> - <typeparam name="T">To be added.</typeparam> - <typeparam name="U">To be added.</typeparam> - <typeparam name="V">To be added.</typeparam> - <param name="helper">To be added.</param> + <typeparam name="T"> + <c>T</c> + </typeparam> + <typeparam name="U"> + <c>U</c> + </typeparam> + <typeparam name="V"> + <c>V</c> + </typeparam> + <param name="helper">A <see cref="T:Mono.DocTest.Generic.MyList{``0}.Helper{``1,``2}" />.</param> <summary>To be added.</summary> - <remarks>To be added.</remarks> + <remarks> + <c>M:Mono.DocTest.UseLists.UseHelper``3(Mono.DocTest.Generic.MyList{``0}.Helper{``1,``2})</c>.</remarks> </member> <member name="T:Mono.DocTest.Widget"> <summary>To be added.</summary> @@ -718,11 +725,12 @@ class Example { <c>M:Mono.DocTest.MyList`1.Test(`0)</c>.</remarks> </member> <member name="M:Mono.DocTest.Generic.MyList`1.UseHelper``2(Mono.DocTest.Generic.MyList{T}+Helper{``0,``1})"> - <typeparam name="U">To be added.</typeparam> - <typeparam name="V">To be added.</typeparam> - <param name="helper">To be added.</param> + <typeparam name="U">Argh!</typeparam> + <typeparam name="V">Foo Argh!</typeparam> + <param name="helper">A <see cref="T:Mono.DocTest.Generic.MyList`1.Helper`2" />.</param> <summary>To be added.</summary> - <remarks>To be added.</remarks> + <remarks> + <c>M:Mono.DocTest.Generic.MyList`1.UseHelper``2(Mono.DocTest.Generic.MyList{``0}.Helper{``1,``2})</c>.</remarks> </member> <member name="T:Mono.DocTest.Generic.MyList`1.Helper`2"> <typeparam name="U">Seriously!</typeparam> @@ -790,12 +798,13 @@ class Example { <c>M:Mono.DocTest.MyList`2.GetEnumerator</c>.</remarks> </member> <member name="M:Mono.DocTest.Generic.MyList`2.Mono#DocTest#Generic#IFoo{A}#Method``1(A,``0)"> - <typeparam name="U">To be added.</typeparam> + <typeparam name="U">U generic param on MyList`2</typeparam> <param name="a">To be added.</param> <param name="u">To be added.</param> <summary>To be added.</summary> <returns>To be added.</returns> - <remarks>To be added.</remarks> + <remarks> + <c>M:Mono.DocTest.Generic.MyList`2.Mono#DocTest#Generic#IFoo{A}#Method``1(`0,``0)</c>.</remarks> </member> <member name="M:Mono.DocTest.Generic.MyList`2.MoveNext"> <summary>To be added.</summary> @@ -811,40 +820,47 @@ class Example { <c>M:Mono.DocTest.MyList`2.Reset</c>.</remarks> </member> <member name="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Add(A)"> - <param name="item">To be added.</param> + <param name="item">The item to add.</param> <summary>To be added.</summary> - <remarks>To be added.</remarks> + <remarks> + <c>M:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}#Add(`0)</c>.</remarks> </member> <member name="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Clear"> <summary>To be added.</summary> - <remarks>To be added.</remarks> + <remarks> + <c>M:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}#Clear</c>.</remarks> </member> <member name="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Contains(A)"> - <param name="item">To be added.</param> + <param name="item">The item to check for</param> <summary>To be added.</summary> - <returns>To be added.</returns> - <remarks>To be added.</remarks> + <returns>A <see cref="T:System.Boolean" /> instance (<see langword="false" />).</returns> + <remarks> + <c>M:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}.Contains(`0)</c>.</remarks> </member> <member name="P:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#IsReadOnly"> <summary>To be added.</summary> - <value>To be added.</value> - <remarks>To be added.</remarks> + <value>A <see cref="T:System.Boolean" />.</value> + <remarks> + <c>P:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}#IsReadOnly</c>.</remarks> </member> <member name="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#ICollection{A}#Remove(A)"> - <param name="item">To be added.</param> + <param name="item">the item to remove</param> <summary>To be added.</summary> - <returns>To be added.</returns> - <remarks>To be added.</remarks> + <returns>Whether the item was removed.</returns> + <remarks> + <c>M:Mono.DocTest.MyList`2.System#Collections#Generic#ICollection{A}#Remove(`0)</c>.</remarks> </member> <member name="M:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#IEnumerable{A}#GetEnumerator"> <summary>To be added.</summary> - <returns>To be added.</returns> - <remarks>To be added.</remarks> + <returns>A <see cref="T:System.Collections.Generic.IEnumerator{`0}" />.</returns> + <remarks> + <c>M:Mono.DocTest.MyList`2.System#Collections#Generic#IEnumerable{A}#GetEnumerator</c>.</remarks> </member> <member name="P:Mono.DocTest.Generic.MyList`2.System#Collections#Generic#IEnumerator{A}#Current"> <summary>To be added.</summary> - <value>To be added.</value> - <remarks>To be added.</remarks> + <value>The current value.</value> + <remarks> + <c>P:Mono.DocTest.MyList`2.Current</c>.</remarks> </member> <member name="M:Mono.DocTest.Generic.MyList`2.System#Collections#IEnumerable#GetEnumerator"> <summary>To be added.</summary> |