From owner-freebsd-doc Sun Dec 2 19:20: 7 2001 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 967C237B417 for ; Sun, 2 Dec 2001 19:20:01 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id fB33K1U08681; Sun, 2 Dec 2001 19:20:01 -0800 (PST) (envelope-from gnats) Received: from lists.blarg.net (lists.blarg.net [206.124.128.17]) by hub.freebsd.org (Postfix) with ESMTP id C9D7A37B417 for ; Sun, 2 Dec 2001 19:17:54 -0800 (PST) Received: from thig.blarg.net (thig.blarg.net [206.124.128.18]) by lists.blarg.net (Postfix) with ESMTP id 75FCEBD5B for ; Sun, 2 Dec 2001 19:17:54 -0800 (PST) Received: from localhost.localdomain ([206.124.139.115]) by thig.blarg.net (8.9.3/8.9.3) with ESMTP id TAA09044 for ; Sun, 2 Dec 2001 19:17:54 -0800 Received: (from jojo@localhost) by localhost.localdomain (8.11.6/8.11.3) id fB33I3Z14303; Sun, 2 Dec 2001 19:18:03 -0800 (PST) (envelope-from swear@blarg.net) Message-Id: Date: 02 Dec 2001 19:18:03 -0800 From: "Gary W. Swearingen" Reply-To: swear@blarg.net To: FreeBSD-gnats-submit@freebsd.org Subject: docs/32452: disklabel(8)'s "examine or save" is confusing. Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 32452 >Category: docs >Synopsis: disklabel(8)'s "examine or save" is confusing. >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Dec 02 19:20:01 PST 2001 >Closed-Date: >Last-Modified: >Originator: Gary W. Swearingen >Release: FreeBSD 4.4-RELEASE i386 >Organization: none >Environment: n/a ================ >Description: disklabel(8)'s "Reading the disk label" section starts out "To examine or save the label on a disk drive,...". This is confusing. The given command (disklabel [-r] disk) doesn't save anything (except to standard out, but that should go without saying). It reads as if the command might save something on the disk drive. ================ >How-To-Repeat: n/a ================ >Fix: Remove "or save " with this patch: patch -d "unknown uncompressed man directory" < this-PR --- disklabel.8.old Sun Dec 2 19:04:31 2001 +++ disklabel.8 Sun Dec 2 19:07:38 2001 @@ -141,7 +141,7 @@ will automatically prepend it. .Ss Reading the disk label .Pp -To examine or save the label on a disk drive, use +To examine the label on a disk drive, use .Nm without options: .Pp >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message