Add the new standard EXIT STATUS section where appropriate.

Sort standard sections in the (documented) preferred order.

3 files changed, 51 insertions, 51 deletions

diff --git a/bin/pax/cpio.1 b/bin/pax/cpio.1
index c6865a1..19c105d 100644
--- a/bin/pax/cpio.1
+++ b/bin/pax/cpio.1
@@ -251,7 +251,7 @@ List filenames as they are copied.
 .It Ev TMPDIR
 Path in which to store temporary files.
 .El
-.Sh DIAGNOSTICS
+.Sh EXIT STATUS
 The
 .Nm
 utility will exit with one of the following values:
diff --git a/bin/pax/pax.1 b/bin/pax/pax.1
index 5764c6d..0593404 100644
--- a/bin/pax/pax.1
+++ b/bin/pax/pax.1
@@ -1049,6 +1049,16 @@ options are specified along with the
 .Fl n
 option, a file is not considered selected unless it is newer
 than the file to which it is compared.
+.Sh EXIT STATUS
+The
+.Nm
+utility will exit with one of the following values:
+.Bl -tag -width 2n
+.It 0
+All files were processed successfully.
+.It 1
+An error occurred.
+.El
 .Sh EXAMPLES
 The command:
 .Dl "pax -w -f /dev/sa0 ."
@@ -1099,6 +1109,45 @@ will update (and list) only those files in the destination directory
 which are older (less recent inode change or file modification times) than
 files with the same name found in the source file tree
 .Pa home .
+.Sh DIAGNOSTICS
+Whenever
+.Nm
+cannot create a file or a link when reading an archive or cannot
+find a file when writing an archive, or cannot preserve the user ID,
+group ID, or file mode when the
+.Fl p
+option is specified, a diagnostic message is written to
+.Dv standard error
+and a non-zero exit status will be returned, but processing will continue.
+In the case where pax cannot create a link to a file,
+.Nm
+will not create a second copy of the file.
+.Pp
+If the extraction of a file from an archive is prematurely terminated by
+a signal or error,
+.Nm
+may have only partially extracted a file the user wanted.
+Additionally, the file modes of extracted files and directories
+may have incorrect file bits, and the modification and access times may be
+wrong.
+.Pp
+If the creation of an archive is prematurely terminated by a signal or error,
+.Nm
+may have only partially created the archive which may violate the specific
+archive format specification.
+.Pp
+If while doing a
+.Em copy ,
+.Nm
+detects a file is about to overwrite itself, the file is not copied,
+a diagnostic message is written to
+.Dv standard error
+and when
+.Nm
+completes it will exit with a non-zero exit status.
+.Sh SEE ALSO
+.Xr cpio 1 ,
+.Xr tar 1
 .Sh STANDARDS
 The
 .Nm
@@ -1130,9 +1179,6 @@ and
 operations are extensions to the
 .Tn POSIX
 standard.
-.Sh SEE ALSO
-.Xr cpio 1 ,
-.Xr tar 1
 .Sh HISTORY
 The
 .Nm
@@ -1141,52 +1187,6 @@ utility appeared in
 .Sh AUTHORS
 .An Keith Muller
 at the University of California, San Diego
-.Sh DIAGNOSTICS
-The
-.Nm
-utility will exit with one of the following values:
-.Bl -tag -width 2n
-.It 0
-All files were processed successfully.
-.It 1
-An error occurred.
-.El
-.Pp
-Whenever
-.Nm
-cannot create a file or a link when reading an archive or cannot
-find a file when writing an archive, or cannot preserve the user ID,
-group ID, or file mode when the
-.Fl p
-option is specified, a diagnostic message is written to
-.Dv standard error
-and a non-zero exit status will be returned, but processing will continue.
-In the case where pax cannot create a link to a file,
-.Nm
-will not create a second copy of the file.
-.Pp
-If the extraction of a file from an archive is prematurely terminated by
-a signal or error,
-.Nm
-may have only partially extracted a file the user wanted.
-Additionally, the file modes of extracted files and directories
-may have incorrect file bits, and the modification and access times may be
-wrong.
-.Pp
-If the creation of an archive is prematurely terminated by a signal or error,
-.Nm
-may have only partially created the archive which may violate the specific
-archive format specification.
-.Pp
-If while doing a
-.Em copy ,
-.Nm
-detects a file is about to overwrite itself, the file is not copied,
-a diagnostic message is written to
-.Dv standard error
-and when
-.Nm
-completes it will exit with a non-zero exit status.
 .Sh BUGS
 The
 .Nm
diff --git a/bin/pax/tar.1 b/bin/pax/tar.1
index d5da33e..b1b05b3 100644
--- a/bin/pax/tar.1
+++ b/bin/pax/tar.1
@@ -252,7 +252,7 @@ Default tape device to use instead of
 .It Pa /dev/sa0
 default archive name
 .El
-.Sh DIAGNOSTICS
+.Sh EXIT STATUS
 The
 .Nm
 utility will exit with one of the following values: