Conflict in FreeBSD Handbook 19.7.1 Label Types and Examples

[Wayne Sierke]

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"! :)