Skip to content

Commit

Permalink
Explain the newfs naming convention
Browse files Browse the repository at this point in the history
It might be unclear why newfs and newfs_msdos should cross-reference
each other. Add a note explaining it.

This is a follow-up to 74bd207.

Reported by:	kib
Reviewed by:    imp, kib, rpokala
MFC after:	3 days

(cherry picked from commit 5b9b65e)
  • Loading branch information
0mp committed Apr 20, 2021
1 parent 8ca8248 commit 5d42c19
Showing 1 changed file with 9 additions and 1 deletion.
10 changes: 9 additions & 1 deletion sbin/newfs/newfs.8
Expand Up @@ -28,7 +28,7 @@
.\" @(#)newfs.8 8.6 (Berkeley) 5/3/95
.\" $FreeBSD$
.\"
.Dd January 29, 2019
.Dd April 17, 2021
.Dt NEWFS 8
.Os
.Sh NAME
Expand Down Expand Up @@ -291,6 +291,14 @@ to find the alternate superblocks if the standard superblock is lost.
.It Fl S Ar sector-size
The size of a sector in bytes (almost never anything but 512).
.El
.Sh NOTES ON THE NAMING
.Dq newfs
is a common name prefix for utilities creating filesystems, with the suffix
indicating the type of the filesystem, for instance
.Xr newfs_msdos 8 .
The
.Nm
utility is a special case which predates that convention.
.Sh EXAMPLES
.Dl newfs /dev/ada3s1a
.Pp
Expand Down

0 comments on commit 5d42c19

Please sign in to comment.