Document System.IO.PipesAclExtensions (dotnet#3933)

Author: carlossanlop

xml/System.IO.Pipes/PipesAclExtensions.xml

@@ -17,7 +17,7 @@
  </Base>
  <Interfaces />
  <Docs>
- <summary>To be added.</summary>
+ <summary>Provides Windows-specific static extension methods for manipulating Access Control List (ACL) security attributes for pipe streams.</summary>
  <remarks>To be added.</remarks>
  </Docs>
  <Members>
@@ -48,9 +48,9 @@
  <Parameter Name="stream" Type="System.IO.Pipes.PipeStream" RefType="this" />
  </Parameters>
  <Docs>
- <param name="stream">To be added.</param>
- <summary>To be added.</summary>
- <returns>To be added.</returns>
+ <param name="stream">The existing pipe stream from which to obtain the security information.</param>
+ <summary>Returns the security information of a pipe stream.</summary>
+ <returns>The security descriptors of all the access control sections of the pipe stream.</returns>
  <remarks>To be added.</remarks>
  </Docs>
  </Member>
@@ -81,10 +81,16 @@
  <Parameter Name="pipeSecurity" Type="System.IO.Pipes.PipeSecurity" />
  </Parameters>
  <Docs>
- <param name="stream">To be added.</param>
- <param name="pipeSecurity">To be added.</param>
- <summary>To be added.</summary>
+ <param name="stream">An existing pipe stream.</param>
+ <param name="pipeSecurity">The security information to apply to the pipe stream.</param>
+ <summary>Changes the security attributes of an existing pipe stream.</summary>
  <remarks>To be added.</remarks>
+ <exception cref="ArgumentNullException">
+ <paramref name="pipeSecurity" /> is <see langword="null" />.
+ </exception>
+ <exception cref="IOException">
+ <paramref name="stream" /> is a disconnected <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> instance.
+ </exception>
  </Docs>
  </Member>
  </Members>