Date: Wed, 19 Nov 2014 05:02:44 +1030 From: Wayne Sierke <ws@au.dyndns.ws> To: freebsd-doc <freebsd-doc@FreeBSD.org> Subject: Conflict in FreeBSD Handbook 19.7.1 Label Types and Examples Message-ID: <1416335564.1330.85.camel@predator-ii.buffyverse>
index | next in thread | raw e-mail
Handbook ยง19.7.1 includes the following text:
To create a permanent label for a UFS2 file system without
destroying any data, issue the following command:
# tunefs -L home /dev/da3
Warning:
If the file system is full, this may cause data corruption.
which leaves one contemplating the distinction between "corrupting" and
"destroying" data!
I presume the intention in writing the first sentence was to convey the
notion of using tunefs(8) rather than newfs(8), in which case perhaps
something like the following is more appropriate:
To create a permanent label for an existing UFS2 filesystem,
issue the following command:
or slightly more helpful:
To create (or modify) a permanent label for an existing UFS2
filesystem, issue the following command:
Additionally, the given command should be clearly identified as an
example, therefore:
To create (or modify) a permanent label for an existing UFS2
filesystem use tunefs(8); for example to create the label "home"
for the UFS2 filesystem on /dev/da3 issue the following command:
or something similar.
(And please standardise the use of "filesystem" over "file system"! :)
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?1416335564.1330.85.camel>