Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 20 Apr 2021 08:21:56 GMT
From:      Mateusz Piotrowski <0mp@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org
Subject:   git: 5d42c19f1fe2 - stable/12 - Explain the newfs naming convention
Message-ID:  <202104200821.13K8Lubj043471@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
The branch stable/12 has been updated by 0mp (doc, ports committer):

URL: https://cgit.FreeBSD.org/src/commit/?id=5d42c19f1fe2f0745869a6b7b269a747f203362c

commit 5d42c19f1fe2f0745869a6b7b269a747f203362c
Author:     Mateusz Piotrowski <0mp@FreeBSD.org>
AuthorDate: 2021-01-20 10:40:20 +0000
Commit:     Mateusz Piotrowski <0mp@FreeBSD.org>
CommitDate: 2021-04-20 08:21:33 +0000

    Explain the newfs naming convention
    
    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 74bd20769706041108a573601cf0b61c755bdc56.
    
    Reported by:    kib
    Reviewed by:    imp, kib, rpokala
    MFC after:      3 days
    
    (cherry picked from commit 5b9b65e92fb40703038cbcf61feb4616c42e0b6e)
---
 sbin/newfs/newfs.8 | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/sbin/newfs/newfs.8 b/sbin/newfs/newfs.8
index 985d0557044e..e64bdeb367f4 100644
--- a/sbin/newfs/newfs.8
+++ b/sbin/newfs/newfs.8
@@ -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
@@ -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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202104200821.13K8Lubj043471>