Skip to content

Commit 26ac724

Browse files
BillWagnerBillWagner
authored
Merge pull request #4185 from dotnet/publish-23870
Merge master into live
2 parents f7f7034 + 508a199 commit 26ac724

File tree

8 files changed

+178
-102
lines changed

8 files changed

+178
-102
lines changed

‎xml/System.Collections.Generic/List`1.xml‎

Lines changed: 37 additions & 37 deletions
Large diffs are not rendered by default.

‎xml/System.Diagnostics/Process.xml‎

Lines changed: 16 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<Type Name="Process" FullName="System.Diagnostics.Process">
1+
<Type Name="Process" FullName="System.Diagnostics.Process">
22
<TypeSignature Language="C#" Value="public class Process : System.ComponentModel.Component, IDisposable" FrameworkAlternate="net-5.0" />
33
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit Process extends System.ComponentModel.Component implements class System.IDisposable" FrameworkAlternate="net-5.0" />
44
<TypeSignature Language="DocId" Value="T:System.Diagnostics.Process" />
@@ -39,8 +39,7 @@
3939
<BaseTypeName>System.ComponentModel.Component</BaseTypeName>
4040
<BaseTypeName FrameworkAlternate="netcore-1.0;netcore-1.1">System.Object</BaseTypeName>
4141
</Base>
42-
<Interfaces>
43-
</Interfaces>
42+
<Interfaces />
4443
<Attributes>
4544
<Attribute FrameworkAlternate="netframework-1.1;netframework-2.0;netframework-3.0;netframework-3.5;netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netstandard-2.0;xamarinandroid-7.1;xamarinios-10.8;xamarinmac-3.0;netframework-4.8;netstandard-2.1">
4645
<AttributeName>System.ComponentModel.DefaultEvent("Exited")</AttributeName>
@@ -774,7 +773,7 @@ process.BeginOutputReadLine();
774773
</ReturnValue>
775774
<Parameters />
776775
<Docs>
777-
<summary>To be added.</summary>
776+
<summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
778777
<remarks>To be added.</remarks>
779778
</Docs>
780779
</Member>
@@ -2094,7 +2093,7 @@ There are problems accessing the performance counter API's used to get process i
20942093
</Member>
20952094
<MemberGroup MemberName="Kill">
20962095
<Docs>
2097-
<summary>To be added.</summary>
2096+
<summary>Forces termination of the underlying process.</summary>
20982097
<remarks>
20992098
<format type="text/markdown"><![CDATA[
21002099

@@ -6083,10 +6082,18 @@ The file specified in the <paramref name="fileName" /> could not be found.
60836082
<Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="0" FrameworkAlternate="net-5.0" />
60846083
</Parameters>
60856084
<Docs>
6086-
<param name="cancellationToken">To be added.</param>
6087-
<summary>To be added.</summary>
6088-
<returns>To be added.</returns>
6089-
<remarks>To be added.</remarks>
6085+
<param name="cancellationToken">An optional token to cancel the asynchronous operation.</param>
6086+
<summary>Instructs the process component to wait for the associated process to exit, or for the <paramref name="cancellationToken" /> to be cancelled.</summary>
6087+
<returns>A task that will complete when the process has exited, cancellation has been requested, or an error occurs.</returns>
6088+
<remarks>
6089+
<format type="text/markdown"><![CDATA[
6090+
6091+
## Remarks
6092+
6093+
Calling this method will set <xref:System.Diagnostics.Process.EnableRaisingEvents> to `true`.
6094+
6095+
]]></format>
6096+
</remarks>
60906097
</Docs>
60916098
</Member>
60926099
<MemberGroup MemberName="WaitForInputIdle">

‎xml/System.Diagnostics/ProcessModuleCollection.xml‎

Lines changed: 32 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<Type Name="ProcessModuleCollection" FullName="System.Diagnostics.ProcessModuleCollection">
1+
<Type Name="ProcessModuleCollection" FullName="System.Diagnostics.ProcessModuleCollection">
22
<TypeSignature Language="C#" Value="public class ProcessModuleCollection : System.Collections.ReadOnlyCollectionBase" FrameworkAlternate="net-5.0;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;netframework-1.1;netframework-2.0;netframework-3.0;netframework-3.5;netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netstandard-2.0;netstandard-2.1;xamarinandroid-7.1;xamarinios-10.8;xamarinmac-3.0" />
33
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit ProcessModuleCollection extends System.Collections.ReadOnlyCollectionBase" FrameworkAlternate="net-5.0;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;netframework-1.1;netframework-2.0;netframework-3.0;netframework-3.5;netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netstandard-2.0;netstandard-2.1;xamarinandroid-7.1;xamarinios-10.8;xamarinmac-3.0" />
44
<TypeSignature Language="DocId" Value="T:System.Diagnostics.ProcessModuleCollection" />
@@ -34,8 +34,7 @@
3434
<BaseTypeName>System.Collections.ReadOnlyCollectionBase</BaseTypeName>
3535
<BaseTypeName FrameworkAlternate="netcore-1.0;netcore-1.1">System.Object</BaseTypeName>
3636
</Base>
37-
<Interfaces>
38-
</Interfaces>
37+
<Interfaces />
3938
<Docs>
4039
<summary>Provides a strongly typed collection of <see cref="T:System.Diagnostics.ProcessModule" /> objects.</summary>
4140
<remarks>
@@ -650,8 +649,8 @@
650649
<ReturnType>System.Int32</ReturnType>
651650
</ReturnValue>
652651
<Docs>
653-
<summary>To be added.</summary>
654-
<value>To be added.</value>
652+
<summary>Gets the number of elements contained in the collection.</summary>
653+
<value>The number of elements contained in the collection.</value>
655654
<remarks>To be added.</remarks>
656655
</Docs>
657656
</Member>
@@ -1088,8 +1087,8 @@
10881087
</ReturnValue>
10891088
<Parameters />
10901089
<Docs>
1091-
<summary>To be added.</summary>
1092-
<returns>To be added.</returns>
1090+
<summary>Returns an enumerator that iterates through a collection.</summary>
1091+
<returns>An enumerator object that can be used to iterate through the collection.</returns>
10931092
<remarks>To be added.</remarks>
10941093
</Docs>
10951094
</Member>
@@ -1862,9 +1861,9 @@
18621861
<Parameter Name="index" Type="System.Int32" Index="1" FrameworkAlternate="netcore-1.0;netcore-1.1" />
18631862
</Parameters>
18641863
<Docs>
1865-
<param name="array">To be added.</param>
1866-
<param name="index">To be added.</param>
1867-
<summary>To be added.</summary>
1864+
<param name="array">The one-dimensional array that is the destination of the elements copied from collection. The array must have zero-based indexing.</param>
1865+
<param name="index">The zero-based index in <paramref name="array" /> at which copying begins.</param>
1866+
<summary>Copies the elements of the collection to an array, starting at a particular array index.</summary>
18681867
<remarks>To be added.</remarks>
18691868
</Docs>
18701869
</Member>
@@ -1893,9 +1892,18 @@
18931892
<ReturnType>System.Boolean</ReturnType>
18941893
</ReturnValue>
18951894
<Docs>
1896-
<summary>To be added.</summary>
1897-
<value>To be added.</value>
1898-
<remarks>To be added.</remarks>
1895+
<summary>Gets a value indicating whether access to the collection is synchronized (thread safe).</summary>
1896+
<value>
1897+
<see langword="true" /> if access to the collection is synchronized (thread safe); otherwise, <see langword="false" />.</value>
1898+
<remarks>
1899+
<format type="text/markdown"><![CDATA[
1900+
1901+
## Remarks
1902+
1903+
This member is an explicit interface member implementation. It can be used only when the <xref:System.Diagnostics.ProcessModuleCollection> instance is cast to an <xref:System.Collections.ICollection> interface.
1904+
1905+
]]></format>
1906+
</remarks>
18991907
</Docs>
19001908
</Member>
19011909
<Member MemberName="System.Collections.ICollection.SyncRoot">
@@ -1923,9 +1931,17 @@
19231931
<ReturnType>System.Object</ReturnType>
19241932
</ReturnValue>
19251933
<Docs>
1926-
<summary>To be added.</summary>
1927-
<value>To be added.</value>
1928-
<remarks>To be added.</remarks>
1934+
<summary>Gets an object that can be used to synchronize access to the collection.</summary>
1935+
<value>An object that can be used to synchronize access to the collection.</value>
1936+
<remarks>
1937+
<format type="text/markdown"><![CDATA[
1938+
1939+
## Remarks
1940+
1941+
This member is an explicit interface member implementation. It can be used only when the <xref:System.Diagnostics.ProcessModuleCollection> instance is cast to an <xref:System.Collections.ICollection> interface.
1942+
1943+
]]></format>
1944+
</remarks>
19291945
</Docs>
19301946
</Member>
19311947
<Member MemberName="ToArray">

‎xml/System.Diagnostics/ProcessThreadCollection.xml‎

Lines changed: 32 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<Type Name="ProcessThreadCollection" FullName="System.Diagnostics.ProcessThreadCollection">
1+
<Type Name="ProcessThreadCollection" FullName="System.Diagnostics.ProcessThreadCollection">
22
<TypeSignature Language="C#" Value="public class ProcessThreadCollection : System.Collections.ReadOnlyCollectionBase" FrameworkAlternate="net-5.0;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;netframework-1.1;netframework-2.0;netframework-3.0;netframework-3.5;netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netstandard-2.0;netstandard-2.1;xamarinandroid-7.1;xamarinios-10.8;xamarinmac-3.0" />
33
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit ProcessThreadCollection extends System.Collections.ReadOnlyCollectionBase" FrameworkAlternate="net-5.0;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;netframework-1.1;netframework-2.0;netframework-3.0;netframework-3.5;netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netstandard-2.0;netstandard-2.1;xamarinandroid-7.1;xamarinios-10.8;xamarinmac-3.0" />
44
<TypeSignature Language="DocId" Value="T:System.Diagnostics.ProcessThreadCollection" />
@@ -34,8 +34,7 @@
3434
<BaseTypeName>System.Collections.ReadOnlyCollectionBase</BaseTypeName>
3535
<BaseTypeName FrameworkAlternate="netcore-1.0;netcore-1.1">System.Object</BaseTypeName>
3636
</Base>
37-
<Interfaces>
38-
</Interfaces>
37+
<Interfaces />
3938
<Docs>
4039
<summary>Provides a strongly typed collection of <see cref="T:System.Diagnostics.ProcessThread" /> objects.</summary>
4140
<remarks>To be added.</remarks>
@@ -647,8 +646,8 @@
647646
<ReturnType>System.Int32</ReturnType>
648647
</ReturnValue>
649648
<Docs>
650-
<summary>To be added.</summary>
651-
<value>To be added.</value>
649+
<summary>Gets the number of elements contained in the collection.</summary>
650+
<value>The number of elements contained in the collection.</value>
652651
<remarks>To be added.</remarks>
653652
</Docs>
654653
</Member>
@@ -1085,8 +1084,8 @@
10851084
</ReturnValue>
10861085
<Parameters />
10871086
<Docs>
1088-
<summary>To be added.</summary>
1089-
<returns>To be added.</returns>
1087+
<summary>Returns an enumerator that iterates through a collection.</summary>
1088+
<returns>An enumerator object that can be used to iterate through the collection.</returns>
10901089
<remarks>To be added.</remarks>
10911090
</Docs>
10921091
</Member>
@@ -1868,9 +1867,9 @@
18681867
<Parameter Name="index" Type="System.Int32" Index="1" FrameworkAlternate="netcore-1.0;netcore-1.1" />
18691868
</Parameters>
18701869
<Docs>
1871-
<param name="array">To be added.</param>
1872-
<param name="index">To be added.</param>
1873-
<summary>To be added.</summary>
1870+
<param name="array">The one-dimensional array that is the destination of the elements copied from collection. The array must have zero-based indexing.</param>
1871+
<param name="index">The zero-based index in <paramref name="array" /> at which copying begins.</param>
1872+
<summary>Copies the elements of the collection to an array, starting at a particular array index.</summary>
18741873
<remarks>To be added.</remarks>
18751874
</Docs>
18761875
</Member>
@@ -1899,9 +1898,18 @@
18991898
<ReturnType>System.Boolean</ReturnType>
19001899
</ReturnValue>
19011900
<Docs>
1902-
<summary>To be added.</summary>
1903-
<value>To be added.</value>
1904-
<remarks>To be added.</remarks>
1901+
<summary>Gets a value indicating whether access to the collection is synchronized (thread safe).</summary>
1902+
<value>
1903+
<see langword="true" /> if access to the collection is synchronized (thread safe); otherwise, <see langword="false" />.</value>
1904+
<remarks>
1905+
<format type="text/markdown"><![CDATA[
1906+
1907+
## Remarks
1908+
1909+
This member is an explicit interface member implementation. It can be used only when the <xref:System.Diagnostics.ProcessThreadCollection> instance is cast to an <xref:System.Collections.ICollection> interface.
1910+
1911+
]]></format>
1912+
</remarks>
19051913
</Docs>
19061914
</Member>
19071915
<Member MemberName="System.Collections.ICollection.SyncRoot">
@@ -1929,9 +1937,17 @@
19291937
<ReturnType>System.Object</ReturnType>
19301938
</ReturnValue>
19311939
<Docs>
1932-
<summary>To be added.</summary>
1933-
<value>To be added.</value>
1934-
<remarks>To be added.</remarks>
1940+
<summary>Gets an object that can be used to synchronize access to the collection.</summary>
1941+
<value>An object that can be used to synchronize access to the collection.</value>
1942+
<remarks>
1943+
<format type="text/markdown"><![CDATA[
1944+
1945+
## Remarks
1946+
1947+
This member is an explicit interface member implementation. It can be used only when the <xref:System.Diagnostics.ProcessThreadCollection> instance is cast to an <xref:System.Collections.ICollection> interface.
1948+
1949+
]]></format>
1950+
</remarks>
19351951
</Docs>
19361952
</Member>
19371953
<Member MemberName="ToArray">

‎xml/System.Diagnostics/TraceListenerCollection.xml‎

Lines changed: 37 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<Type Name="TraceListenerCollection" FullName="System.Diagnostics.TraceListenerCollection">
1+
<Type Name="TraceListenerCollection" FullName="System.Diagnostics.TraceListenerCollection">
22
<TypeSignature Language="C#" Value="public class TraceListenerCollection : System.Collections.IList" />
33
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit TraceListenerCollection extends System.Object implements class System.Collections.ICollection, class System.Collections.IEnumerable, class System.Collections.IList" />
44
<TypeSignature Language="DocId" Value="T:System.Diagnostics.TraceListenerCollection" />
@@ -974,7 +974,15 @@
974974
<Docs>
975975
<summary>Gets a value indicating whether access to the <see cref="T:System.Diagnostics.TraceListenerCollection" /> is synchronized (thread safe).</summary>
976976
<value>Always <see langword="true" />.</value>
977-
<remarks>To be added.</remarks>
977+
<remarks>
978+
<format type="text/markdown"><![CDATA[
979+
980+
## Remarks
981+
982+
This member is an explicit interface member implementation. It can be used only when the <xref:System.Diagnostics.TraceListenerCollection> instance is cast to an <xref:System.Collections.ICollection> interface.
983+
984+
]]></format>
985+
</remarks>
978986
</Docs>
979987
</Member>
980988
<Member MemberName="System.Collections.ICollection.SyncRoot">
@@ -1013,7 +1021,15 @@
10131021
<Docs>
10141022
<summary>Gets an object that can be used to synchronize access to the <see cref="T:System.Diagnostics.TraceListenerCollection" />.</summary>
10151023
<value>The current <see cref="T:System.Diagnostics.TraceListenerCollection" /> object.</value>
1016-
<remarks>To be added.</remarks>
1024+
<remarks>
1025+
<format type="text/markdown"><![CDATA[
1026+
1027+
## Remarks
1028+
1029+
This member is an explicit interface member implementation. It can be used only when the <xref:System.Diagnostics.TraceListenerCollection> instance is cast to an <xref:System.Collections.ICollection> interface.
1030+
1031+
]]></format>
1032+
</remarks>
10171033
</Docs>
10181034
</Member>
10191035
<Member MemberName="System.Collections.IList.Add">
@@ -1266,7 +1282,15 @@
12661282
<Docs>
12671283
<summary>Gets a value indicating whether the <see cref="T:System.Diagnostics.TraceListenerCollection" /> has a fixed size.</summary>
12681284
<value>Always <see langword="false" />.</value>
1269-
<remarks>To be added.</remarks>
1285+
<remarks>
1286+
<format type="text/markdown"><![CDATA[
1287+
1288+
## Remarks
1289+
1290+
This member is an explicit interface member implementation. It can be used only when the <xref:System.Diagnostics.TraceListenerCollection> instance is cast to an <xref:System.Collections.IList> interface.
1291+
1292+
]]></format>
1293+
</remarks>
12701294
</Docs>
12711295
</Member>
12721296
<Member MemberName="System.Collections.IList.IsReadOnly">
@@ -1305,7 +1329,15 @@
13051329
<Docs>
13061330
<summary>Gets a value indicating whether the <see cref="T:System.Diagnostics.TraceListenerCollection" /> is read-only.</summary>
13071331
<value>Always <see langword="false" />.</value>
1308-
<remarks>To be added.</remarks>
1332+
<remarks>
1333+
<format type="text/markdown"><![CDATA[
1334+
1335+
## Remarks
1336+
1337+
This member is an explicit interface member implementation. It can be used only when the <xref:System.Diagnostics.TraceListenerCollection> instance is cast to an <xref:System.Collections.IList> interface.
1338+
1339+
]]></format>
1340+
</remarks>
13091341
</Docs>
13101342
</Member>
13111343
<Member MemberName="System.Collections.IList.Item">

‎xml/System.Security.AccessControl/ObjectSecurity.xml‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1345,7 +1345,16 @@
13451345
<param name="preserveInheritance">
13461346
<see langword="true" /> to preserve inherited access rules; <see langword="false" /> to remove inherited access rules. This parameter is ignored if <paramref name="isProtected" /> is <see langword="false" />.</param>
13471347
<summary>Sets or removes protection of the access rules associated with this <see cref="T:System.Security.AccessControl.ObjectSecurity" /> object. Protected access rules cannot be modified by parent objects through inheritance.</summary>
1348-
<remarks>To be added.</remarks>
1348+
<remarks>
1349+
<format type="text/markdown"><![CDATA[
1350+
1351+
## Remarks
1352+
When you call the method with `isProtected=true` and `preserveInheritance=true`, you need to walk the new ACL of the object and check for DENY type ACEs.
1353+
For a canonically sorted DACL, the DENY ACEs must appear in the front of the DACL.
1354+
For more information on the canonical ordering of ACLs, see [Order of ACEs in a DACL](https://docs.microsoft.com/en-us/windows/win32/secauthz/order-of-aces-in-a-dacl).
1355+
1356+
]]></format>
1357+
</remarks>
13491358
<exception cref="T:System.InvalidOperationException">This method attempts to remove inherited rules from a non-canonical Discretionary Access Control List (DACL).</exception>
13501359
</Docs>
13511360
</Member>

‎xml/System.Xml/XmlTextWriter.xml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -51,10 +51,10 @@
5151
```csharp
5252
w.WriteStartElement("root");
5353
w.WriteAttributeString("xmlns", "x", null, "urn:1");
54-
w.WriteStartElement("item","urn:1");
55-
w.WriteEndElement();
56-
w.WriteStartElement("item","urn:1");
57-
w.WriteEndElement();
54+
w.WriteStartElement("item","urn:1");
55+
w.WriteEndElement();
56+
w.WriteStartElement("item","urn:1");
57+
w.WriteEndElement();
5858
w.WriteEndElement();
5959
```
6060

‎xml/System/Object.xml‎

Lines changed: 10 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1128,20 +1128,16 @@ and the <xref:System.IDisposable> interface. The <xref:System.IDisposable.Dispos
11281128
11291129
If you do choose to implement [IStringable](https://msdn.microsoft.com/library/windows/apps/windows.foundation.istringable.aspx) in a public managed type that is exported in a [!INCLUDE[wrt](~/includes/wrt-md.md)] component, the following restrictions apply:
11301130
1131-
- You can define the [IStringable](https://msdn.microsoft.com/library/windows/apps/windows.foundation.istringable.aspx) interface only in a "class implements" relationship, such as
1132-
1133-
```csharp
1134-
public class NewClass : IStringable
1135-
```
1136-
1137-
in C#, or
1138-
1139-
```vb
1140-
Public Class NewClass : Implements IStringable
1141-
```
1142-
1143-
in Visual Basic.
1144-
1131+
- You can define the [IStringable](https://msdn.microsoft.com/library/windows/apps/windows.foundation.istringable.aspx) interface only in a "class implements" relationship, as follows:
1132+
1133+
```csharp
1134+
public class NewClass : IStringable
1135+
```
1136+
1137+
```vb
1138+
Public Class NewClass : Implements IStringable
1139+
```
1140+
11451141
- You cannot implement [IStringable](https://msdn.microsoft.com/library/windows/apps/windows.foundation.istringable.aspx) on an interface.
11461142
11471143
- You cannot declare a parameter to be of type [IStringable](https://msdn.microsoft.com/library/windows/apps/windows.foundation.istringable.aspx).

0 commit comments

Comments
 (0)