Permalink
Browse files

mdoc: Reorder manpage sections to keep them consistent.

* Keep CAVEATS and BUGS sections at the end of the pages.
* EXIT STATUS section should come after ENVIRONMENT.

Found-with: mandoc -Tlint
Reviewed-by: Sacha Wildner <swildner@>
  • Loading branch information...
1 parent 6411d14 commit 2d8ff97dc80fa1b349ba7304b29edc1452f256e9 @ntunes ntunes committed Jul 5, 2012
Showing with 34 additions and 36 deletions.
  1. +6 −7 sbin/fsirand/fsirand.8
  2. +2 −2 sbin/hammer/hammer.8
  3. +4 −4 sbin/jscan/jscan.8
  4. +5 −5 sbin/mount/mount.8
  5. +12 −13 sbin/mount_msdos/mount_msdos.8
  6. +5 −5 sbin/mount_ufs/mount_ufs.8
View
@@ -28,7 +28,6 @@
.\"
.\" $OpenBSD: fsirand.8,v 1.6 1997/02/23 03:58:26 millert Exp $
.\" $FreeBSD: src/sbin/fsirand/fsirand.8,v 1.10.2.4 2003/02/23 20:17:15 trhodes Exp $
-.\" $DragonFly: src/sbin/fsirand/fsirand.8,v 1.3 2008/05/01 23:36:43 swildner Exp $
.\"
.Dd January 25, 1997
.Dt FSIRAND 8
@@ -88,12 +87,6 @@ is not marked as clean.
Print the current generation numbers for all inodes instead of
generating new ones.
.El
-.Sh CAVEATS
-Since
-.Nm
-allocates enough memory to hold all the inodes in
-a given cylinder group it may use a large amount
-of memory for large disks with few cylinder groups.
.Sh SEE ALSO
.Xr fs 5 ,
.Xr fsck 8 ,
@@ -114,3 +107,9 @@ version first appeared in
.Fx 2.2.5 .
.Sh AUTHORS
.An Todd C. Miller Aq Todd.Miller@courtesan.com
+.Sh CAVEATS
+Since
+.Nm
+allocates enough memory to hold all the inodes in
+a given cylinder group it may use a large amount
+of memory for large disks with few cylinder groups.
View
@@ -1771,8 +1771,6 @@ If history is important, old root PFS can me restored to a new PFS, and
important directories/files can be
.Nm null
mounted to the new PFS.
-.Sh EXIT STATUS
-.Ex -std
.Sh ENVIRONMENT
If the following environment variables exist, they will be used by:
.Bl -tag -width ".Ev EDITOR"
@@ -1814,6 +1812,8 @@ VERSION 2-)
.It Pa <fs>/pfs
recommended PFS directory
.El
+.Sh EXIT STATUS
+.Ex -std
.\".Sh EXAMPLES
.Sh SEE ALSO
.Xr ssh 1 ,
View
@@ -293,12 +293,12 @@ can exceed a gigabyte (e.g. if someone were to do a single
system call writing a gigabyte all in one go).
.Sh SEE ALSO
.Xr mountctl 8
-.Sh CAVEATS
-This utility is currently under construction and not all features have been
-implemented yet.
-In fact, most have not.
.Sh HISTORY
The
.Nm
utility first appeared in
.Dx 1.3 .
+.Sh CAVEATS
+This utility is currently under construction and not all features have been
+implemented yet.
+In fact, most have not.
View
@@ -430,6 +430,11 @@ have permission to load the module.
.Xr mount_union 8 ,
.Xr sysctl 8 ,
.Xr umount 8
+.Sh HISTORY
+A
+.Nm
+utility appeared in
+.At v1 .
.Sh CAVEATS
After a successful
.Nm ,
@@ -439,10 +444,5 @@ is accessible from the mounted file system.
The minimum permissions for
the mount point for traversal across the mount point in both
directions to be possible for all users is 0111 (execute for all).
-.Sh HISTORY
-A
-.Nm
-utility appeared in
-.At v1 .
.Sh BUGS
It is possible for a corrupted file system to cause a crash.
@@ -29,7 +29,6 @@
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\" $FreeBSD: src/sbin/mount_msdos/mount_msdos.8,v 1.19.2.1 2000/12/08 14:03:59 ru Exp $
-.\" $DragonFly: src/sbin/mount_msdos/mount_msdos.8,v 1.3 2008/04/29 09:33:41 swildner Exp $
.\"
.Dd September 12, 2009
.Dt MOUNT_MSDOS 8
@@ -156,6 +155,18 @@ file name conversions for DOS names.
.Xr unmount 2 ,
.Xr fstab 5 ,
.Xr mount 8
+.Sh HISTORY
+The
+.Nm
+utility first appeared in
+.Fx 2.0 .
+Its predecessor, the
+.Nm mount_pcfs
+utility appeared in
+.Fx 1.0 ,
+and was abandoned in favor
+of the more aptly-named
+.Nm .
.Sh CAVEATS
The use of the
.Fl 9
@@ -170,15 +181,3 @@ mounted file system.
Cluster sizes larger than 16K are unavoidable for file system sizes
larger than 1G, and also occur when filesystems larger than 1G are
shrunk to smaller than 1G using FIPS.
-.Sh HISTORY
-The
-.Nm
-utility first appeared in
-.Fx 2.0 .
-Its predecessor, the
-.Nm mount_pcfs
-utility appeared in
-.Fx 1.0 ,
-and was abandoned in favor
-of the more aptly-named
-.Nm .
View
@@ -430,6 +430,11 @@ have permission to load the module.
.Xr mount_union 8 ,
.Xr sysctl 8 ,
.Xr umount 8
+.Sh HISTORY
+A
+.Nm
+utility appeared in
+.At v1 .
.Sh CAVEATS
After a successful
.Nm ,
@@ -439,10 +444,5 @@ is accessible from the mounted file system.
The minimum permissions for
the mount point for traversal across the mount point in both
directions to be possible for all users is 0111 (execute for all).
-.Sh HISTORY
-A
-.Nm
-utility appeared in
-.At v1 .
.Sh BUGS
It is possible for a corrupted file system to cause a crash.

0 comments on commit 2d8ff97

Please sign in to comment.