Update GNU tar error code documentation.
authorBruce Momjian <bruce@momjian.us>
Fri, 14 Sep 2007 04:16:44 +0000 (04:16 +0000)
committerBruce Momjian <bruce@momjian.us>
Fri, 14 Sep 2007 04:16:44 +0000 (04:16 +0000)
Backpatch to 8.2.X.

doc/src/sgml/backup.sgml

index fe2b33c6e6ac601699f4a49ebbd86640442339b8..ed32a0de1ad7185044febdcdb2ce6fd32cd394ec 100644 (file)
@@ -729,16 +729,17 @@ SELECT pg_stop_backup();
    <para>
     Some backup tools that you might wish to use emit warnings or errors
     if the files they are trying to copy change while the copy proceeds.
-    This situation is normal, and not an error, when taking a base backup of
-    an active database; so you need to ensure that you can distinguish
+    This situation is normal, and not an error, when taking a base backup
+    of an active database; so you need to ensure that you can distinguish
     complaints of this sort from real errors.  For example, some versions
-    of <application>rsync</> return a separate exit code for <quote>vanished
-    source files</>, and you can write a driver script to accept this exit
-    code as a non-error case.  Also, some versions of GNU
-    <application>tar</> consider it an error if a file is changed while
-    <application>tar</> is copying it.  Fortunately, GNU
-    <application>tar</> versions 1.16 and later exit with <literal>1</>
-    if files changed during the backup, and <literal>2</> for other errors.
+    of <application>rsync</> return a separate exit code for
+    <quote>vanished source files</>, and you can write a driver script to
+    accept this exit code as a non-error case.  Also, some versions of
+    GNU <application>tar</> consider it an error if a file was truncated
+    while <application>tar</> is copying it.  Fortunately, GNU
+    <application>tar</> versions 1.16 and later exits with <literal>1</>
+    if a file was changed during the backup, and <literal>2</> for other
+    errors.
    </para>
 
    <para>