Document System.IO.PipesAclExtensions (#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>