From 37a893e3e7920cff5ec327d5c509adb68b6345de Mon Sep 17 00:00:00 2001
From: kaloyankrastev <40073339+kaloyankrastev@users.noreply.github.com>
Date: Thu, 30 May 2019 18:13:16 +0300
Subject: [PATCH 1/4] Update File.xml

---
 xml/System.IO/File.xml | 34 +++++++++++++++++++++++++++++++---
 1 file changed, 31 insertions(+), 3 deletions(-)

diff --git a/xml/System.IO/File.xml b/xml/System.IO/File.xml
index 24e5bc707b6..6d851dd955a 100644
--- a/xml/System.IO/File.xml
+++ b/xml/System.IO/File.xml
@@ -848,7 +848,11 @@
   
  -or-  
   
- <paramref name="destFileName" /> is read-only.</exception>
+ <paramref name="destFileName" /> is read-only.
+        
+ -or-  
+  
+ <paramref name="destFileName" /> exists and is hidden, but <paramref name="sourceFileName" /> is not.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="sourceFileName" /> or <paramref name="destFileName" /> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="F:System.IO.Path.InvalidPathChars" />.  
   
@@ -962,6 +966,10 @@
  -or-  
   
  <paramref name="path" /> specified a file that is read-only.</exception>
+        
+ -or-  
+  
+ <paramref name="path" /> specified a file that is hidden.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="path" /> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="F:System.IO.Path.InvalidPathChars" />.</exception>
         <exception cref="T:System.ArgumentNullException">
@@ -1052,6 +1060,10 @@
  -or-  
   
  <paramref name="path" /> specified a file that is read-only.</exception>
+        
+ -or-  
+  
+ <paramref name="path" /> specified a file that is hidden.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="path" /> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="F:System.IO.Path.InvalidPathChars" />.</exception>
         <exception cref="T:System.ArgumentNullException">
@@ -1132,6 +1144,10 @@
  -or-  
   
  <paramref name="path" /> specified a file that is read-only.</exception>
+        
+ -or-  
+  
+ <paramref name="path" /> specified a file that is hidden.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="path" /> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="F:System.IO.Path.InvalidPathChars" />.</exception>
         <exception cref="T:System.ArgumentNullException">
@@ -1198,6 +1214,10 @@
  -or-  
   
  <paramref name="path" /> specified a file that is read-only.</exception>
+        
+ -or-  
+  
+ <paramref name="path" /> specified a file that is hidden.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="path" /> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="F:System.IO.Path.InvalidPathChars" />.</exception>
         <exception cref="T:System.ArgumentNullException">
@@ -1273,7 +1293,15 @@
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission.</exception>
+        <exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission.  
+  
+ -or-  
+  
+ <paramref name="path" /> specified a file that is read-only.</exception>
+        
+ -or-  
+  
+ <paramref name="path" /> specified a file that is hidden.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="path" /> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="F:System.IO.Path.InvalidPathChars" />.</exception>
         <exception cref="T:System.ArgumentNullException">
@@ -5491,4 +5519,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>

From 75b6b13733051b267e1dc08f2d8e0024204e1e53 Mon Sep 17 00:00:00 2001
From: kaloyankrastev <40073339+kaloyankrastev@users.noreply.github.com>
Date: Thu, 30 May 2019 19:35:16 +0300
Subject: [PATCH 2/4] Update File.xml

---
 xml/System.IO/File.xml | 50 ++++++++++++++++++++++++++++++++----------
 1 file changed, 39 insertions(+), 11 deletions(-)

diff --git a/xml/System.IO/File.xml b/xml/System.IO/File.xml
index 6d851dd955a..f493bfcdace 100644
--- a/xml/System.IO/File.xml
+++ b/xml/System.IO/File.xml
@@ -965,7 +965,7 @@
   
  -or-  
   
- <paramref name="path" /> specified a file that is read-only.</exception>
+ <paramref name="path" /> specified a file that is read-only.
         
  -or-  
   
@@ -1059,7 +1059,7 @@
   
  -or-  
   
- <paramref name="path" /> specified a file that is read-only.</exception>
+ <paramref name="path" /> specified a file that is read-only.
         
  -or-  
   
@@ -1143,7 +1143,7 @@
   
  -or-  
   
- <paramref name="path" /> specified a file that is read-only.</exception>
+ <paramref name="path" /> specified a file that is read-only.
         
  -or-  
   
@@ -1297,7 +1297,7 @@
   
  -or-  
   
- <paramref name="path" /> specified a file that is read-only.</exception>
+ <paramref name="path" /> specified a file that is read-only.
         
  -or-  
   
@@ -4785,7 +4785,11 @@
         <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
         <exception cref="T:System.IO.IOException">An I/O error occurred while opening the file.</exception>
         <exception cref="T:System.UnauthorizedAccessException">
-          <paramref name="path" /> specified a file that is read-only.  
+          <paramref name="path" /> specified a file that is read-only.
+        
+ -or-  
+  
+ <paramref name="path" /> specified a file that is hidden.
   
  -or-  
   
@@ -4922,7 +4926,11 @@
           <paramref name="path" /> is in an invalid format.</exception>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <exception cref="T:System.UnauthorizedAccessException">
-          <paramref name="path" /> specifies a file that is read-only.  
+          <paramref name="path" /> specified a file that is read-only.
+        
+ -or-  
+  
+ <paramref name="path" /> specified a file that is hidden.
   
  -or-  
   
@@ -5004,7 +5012,11 @@
         <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
         <exception cref="T:System.IO.IOException">An I/O error occurred while opening the file.</exception>
         <exception cref="T:System.UnauthorizedAccessException">
-          <paramref name="path" /> specified a file that is read-only.  
+          <paramref name="path" /> specified a file that is read-only.
+        
+ -or-  
+  
+ <paramref name="path" /> specified a file that is hidden.  
   
  -or-  
   
@@ -5091,7 +5103,11 @@
           <paramref name="path" /> is in an invalid format.</exception>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <exception cref="T:System.UnauthorizedAccessException">
-          <paramref name="path" /> specifies a file that is read-only.  
+          <paramref name="path" /> specified a file that is read-only.
+        
+ -or-  
+  
+ <paramref name="path" /> specified a file that is hidden.  
   
  -or-  
   
@@ -5172,7 +5188,11 @@
         <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
         <exception cref="T:System.IO.IOException">An I/O error occurred while opening the file.</exception>
         <exception cref="T:System.UnauthorizedAccessException">
-          <paramref name="path" /> specified a file that is read-only.  
+          <paramref name="path" /> specified a file that is read-only.
+        
+ -or-  
+  
+ <paramref name="path" /> specified a file that is hidden.  
   
  -or-  
   
@@ -5341,7 +5361,11 @@
         <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
         <exception cref="T:System.IO.IOException">An I/O error occurred while opening the file.</exception>
         <exception cref="T:System.UnauthorizedAccessException">
-          <paramref name="path" /> specified a file that is read-only.  
+          <paramref name="path" /> specified a file that is read-only.
+        
+ -or-  
+  
+ <paramref name="path" /> specified a file that is hidden.  
   
  -or-  
   
@@ -5427,7 +5451,11 @@
         <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
         <exception cref="T:System.IO.IOException">An I/O error occurred while opening the file.</exception>
         <exception cref="T:System.UnauthorizedAccessException">
-          <paramref name="path" /> specified a file that is read-only.  
+          <paramref name="path" /> specified a file that is read-only.
+        
+ -or-  
+  
+ <paramref name="path" /> specified a file that is hidden.  
   
  -or-  
   

From b712096315b8943cf3f0fa98f9f401d503fc7b0c Mon Sep 17 00:00:00 2001
From: kaloyankrastev <40073339+kaloyankrastev@users.noreply.github.com>
Date: Thu, 30 May 2019 19:57:11 +0300
Subject: [PATCH 3/4] Update File.xml

---
 xml/System.IO/File.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System.IO/File.xml b/xml/System.IO/File.xml
index f493bfcdace..477cf2681f3 100644
--- a/xml/System.IO/File.xml
+++ b/xml/System.IO/File.xml
@@ -1213,7 +1213,7 @@
   
  -or-  
   
- <paramref name="path" /> specified a file that is read-only.</exception>
+ <paramref name="path" /> specified a file that is read-only.
         
  -or-  
   

From 2610bf64a84e6b75badb4c5438da029c1f3d213c Mon Sep 17 00:00:00 2001
From: kaloyankrastev <40073339+kaloyankrastev@users.noreply.github.com>
Date: Fri, 31 May 2019 10:56:09 +0300
Subject: [PATCH 4/4] Update xml/System.IO/File.xml

Co-Authored-By: Ron Petrusha <ronpet@microsoft.com>
---
 xml/System.IO/File.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System.IO/File.xml b/xml/System.IO/File.xml
index 477cf2681f3..8344799f406 100644
--- a/xml/System.IO/File.xml
+++ b/xml/System.IO/File.xml
@@ -852,7 +852,7 @@
         
  -or-  
   
- <paramref name="destFileName" /> exists and is hidden, but <paramref name="sourceFileName" /> is not.</exception>
+<paramref name="overwrite" /> is <see langword="true" />, <paramref name="destFileName" /> exists and is hidden, but <paramref name="sourceFileName" /> is not hidden.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="sourceFileName" /> or <paramref name="destFileName" /> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="F:System.IO.Path.InvalidPathChars" />.