Automatic port of System.IO exceptions (dotnet#4665)

Co-authored-by: carlossanlop <[email protected]>

Author: carlossanlop

xml/System.IO.Compression/ZipArchive.xml

@@ -302,7 +302,11 @@
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentException">The stream is already closed, or the capabilities of the stream do not match the mode.</exception>
+        <exception cref="T:System.ArgumentException">The stream is already closed, or the capabilities of the stream do not match the mode.
+
+-or-
+
+An encoding other than UTF-8 is specified for the <paramref name="entryNameEncoding" />.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="stream" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">

xml/System.IO.Compression/ZipArchiveEntry.xml

@@ -37,7 +37,7 @@
   
  The methods for manipulating zip archives and their file entries are spread across three classes: <xref:System.IO.Compression.ZipFile>, <xref:System.IO.Compression.ZipArchive> and <xref:System.IO.Compression.ZipArchiveEntry>.  
   
-|To…|Use…|  
+|To...|Use...|  
 |---------|----------|  
 |Create a zip archive from a directory|<xref:System.IO.Compression.ZipFile.CreateFromDirectory%2A?displayProperty=nameWithType>|  
 |Extract the contents of a zip archive to a directory|<xref:System.IO.Compression.ZipFile.ExtractToDirectory%2A?displayProperty=nameWithType>|  

xml/System.IO.Compression/ZipFile.xml

@@ -43,7 +43,7 @@
   
  The methods for manipulating zip archives and their files are spread across three classes: <xref:System.IO.Compression.ZipFile>, <xref:System.IO.Compression.ZipArchive> and <xref:System.IO.Compression.ZipArchiveEntry>.  
   
-|To…|Use…|  
+|To...|Use...|  
 |---------|----------|  
 |Create a zip archive from a directory|<xref:System.IO.Compression.ZipFile.CreateFromDirectory%2A?displayProperty=nameWithType>|  
 |Extract the contents of a zip archive to a directory|<xref:System.IO.Compression.ZipFile.ExtractToDirectory%2A?displayProperty=nameWithType>|  
@@ -159,7 +159,11 @@
 
  -or-  
 
- A file in the specified directory could not be opened.</exception>
+ A file in the specified directory could not be opened.
+
+-or-
+
+An I/O error occurred while opening a file to be archived.</exception>
         <exception cref="T:System.UnauthorizedAccessException">
           <paramref name="destinationArchiveFileName" /> specifies a directory.  
 
@@ -249,7 +253,11 @@
 
  -or-  
 
- A file in the specified directory could not be opened.</exception>
+ A file in the specified directory could not be opened.
+
+-or-
+
+An I/O error occurred while opening a file to be archived.</exception>
         <exception cref="T:System.UnauthorizedAccessException">
           <paramref name="destinationArchiveFileName" /> specifies a directory.  
 
@@ -346,7 +354,11 @@
 
  -or-  
 
- A file in the specified directory could not be opened.</exception>
+ A file in the specified directory could not be opened.
+
+-or-
+
+An I/O error occurred while opening a file to be archived.</exception>
         <exception cref="T:System.UnauthorizedAccessException">
           <paramref name="destinationArchiveFileName" /> specifies a directory.  
 
@@ -833,7 +845,11 @@ An archive entry has been compressed using a compression method that is not supp
 
  -or-  
 
- <paramref name="mode" /> is set to <see cref="F:System.IO.Compression.ZipArchiveMode.Create" />, but the file specified in <paramref name="archiveFileName" /> already exists.</exception>
+ <paramref name="mode" /> is set to <see cref="F:System.IO.Compression.ZipArchiveMode.Create" />, but the file specified in <paramref name="archiveFileName" /> already exists.
+
+-or-
+
+An unspecified I/O error occurred while opening the file.</exception>
         <exception cref="T:System.UnauthorizedAccessException">
           <paramref name="archiveFileName" /> specifies a directory.  
 
@@ -948,7 +964,11 @@ An archive entry has been compressed using a compression method that is not supp
 
  -or-  
 
- <paramref name="mode" /> is set to <see cref="F:System.IO.Compression.ZipArchiveMode.Create" />, but the file specified in <paramref name="archiveFileName" /> already exists.</exception>
+ <paramref name="mode" /> is set to <see cref="F:System.IO.Compression.ZipArchiveMode.Create" />, but the file specified in <paramref name="archiveFileName" /> already exists.
+
+-or-
+
+An unspecified I/O error occurred while opening the file.</exception>
         <exception cref="T:System.UnauthorizedAccessException">
           <paramref name="archiveFileName" /> specifies a directory.  
 
@@ -1034,7 +1054,11 @@ An archive entry has been compressed using a compression method that is not supp
         <exception cref="T:System.IO.DirectoryNotFoundException">
           <paramref name="archiveFileName" /> is invalid or does not exist (for example, it is on an unmapped drive).</exception>
         <exception cref="T:System.IO.IOException">
-          <paramref name="archiveFileName" /> could not be opened.</exception>
+          <paramref name="archiveFileName" /> could not be opened.
+
+-or-
+
+An unspecified I/O error occurred while opening the file.</exception>
         <exception cref="T:System.UnauthorizedAccessException">
           <paramref name="archiveFileName" /> specifies a directory.  
 

xml/System.IO/FileSystemAclExtensions.xml

@@ -228,6 +228,8 @@ This extension method was added to .NET Core to bring the functionality that was
           <paramref name="directorySecurity" /> or <paramref name="path" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="path" /> is empty.</exception>
+        <exception cref="T:System.IO.DirectoryNotFoundException">Could not find a part of the path.</exception>
+        <exception cref="T:System.UnauthorizedAccessException">Access to the path is denied.</exception>
       </Docs>
     </Member>
     <Member MemberName="GetAccessControl">

xml/System.IO/Path.xml

@@ -1783,6 +1783,8 @@ Paths are resolved by calling the <xref:System.IO.Path.GetFullPath%2A> method be
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="relativeTo" /> or <paramref name="path" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="relativeTo" /> or <paramref name="path" /> is effectively empty.</exception>
         <related type="article" href="/dotnet/standard/io/file-path-formats">File path formats on Windows systems</related>
       </Docs>
     </Member>