From owner-freebsd-doc@FreeBSD.ORG Wed Nov 19 00:38:23 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id E315EAEB for ; Wed, 19 Nov 2014 00:38:23 +0000 (UTC) Received: from ipmail04.adl6.internode.on.net (ipmail04.adl6.internode.on.net [150.101.137.141]) by mx1.freebsd.org (Postfix) with ESMTP id 71D03C21 for ; Wed, 19 Nov 2014 00:38:22 +0000 (UTC) Received: from ppp103-111.static.internode.on.net (HELO lillith-iv.ovirt.dyndns.ws) ([150.101.103.111]) by ipmail04.adl6.internode.on.net with ESMTP; 19 Nov 2014 11:02:44 +1030 X-Envelope-From: ws@au.dyndns.ws X-Envelope-To: Received: from [172.17.17.136] (predator-ii.buffyverse [172.17.17.136]) by lillith-iv.ovirt.dyndns.ws (8.14.5/8.14.5) with ESMTP id sAJ0WbvH065776 for ; Wed, 19 Nov 2014 11:02:37 +1030 (CST) (envelope-from ws@au.dyndns.ws) Subject: Conflict in FreeBSD Handbook 19.7.1 Label Types and Examples From: Wayne Sierke To: freebsd-doc Content-Type: text/plain; charset="UTF-8" Date: Wed, 19 Nov 2014 05:02:44 +1030 Message-ID: <1416335564.1330.85.camel@predator-ii.buffyverse> Mime-Version: 1.0 X-Mailer: Evolution 2.32.1 FreeBSD GNOME Team Port Content-Transfer-Encoding: 8bit X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (lillith-iv.ovirt.dyndns.ws [172.17.17.142]); Wed, 19 Nov 2014 11:02:37 +1030 (CST) X-Scanned-By: MIMEDefang 2.74 on 172.17.17.142 X-Scanned-By: SpamAssassin 3.003002(2011-06-06) X-Scanned-By: ClamAV X-Spam-Score: -1.308 () ALL_TRUSTED,BAYES_00,DATE_IN_PAST_03_06 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 19 Nov 2014 00:38:24 -0000 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"! :)