From owner-freebsd-doc Wed Jan 23 21:20:12 2002 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 78C6437B404 for ; Wed, 23 Jan 2002 21:20:01 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g0O5K1D58634; Wed, 23 Jan 2002 21: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 CA22037B405 for ; Wed, 23 Jan 2002 21:17:04 -0800 (PST) Received: from thig.blarg.net (thig.blarg.net [206.124.128.18]) by lists.blarg.net (Postfix) with ESMTP id 5BA45BD68 for ; Wed, 23 Jan 2002 21:17:04 -0800 (PST) Received: from localhost.localdomain ([206.124.139.115]) by thig.blarg.net (8.9.3/8.9.3) with ESMTP id VAA08729 for ; Wed, 23 Jan 2002 21:17:04 -0800 Received: (from jojo@localhost) by localhost.localdomain (8.11.6/8.11.3) id g0O5KAj01559; Wed, 23 Jan 2002 21:20:10 -0800 (PST) (envelope-from swear@blarg.net) Message-Id: Date: 23 Jan 2002 21:20:10 -0800 From: "Gary W. Swearingen" Reply-To: swear@blarg.net To: FreeBSD-gnats-submit@freebsd.org Subject: docs/34220: eject(1) man page needs cleanup 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: 34220 >Category: docs >Synopsis: eject(1) man page needs cleanup >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: Wed Jan 23 21:20:01 PST 2002 >Closed-Date: >Last-Modified: >Originator: Gary W. Swearingen >Release: FreeBSD 4.5-PRERELEASE i386 >Organization: none >Environment: n/a ================ >Description: The eject man page has several minor problems that should be cleaned up. -- Has "brefore" for "before". -- Has "Not" for "Do not" in -n option description. -- The "ENVIRONMENT" section has an unneeded and obvious explanation. -- The "DESCRIPTION" is wordy. -- The option descriptions are not as clear as they should be. -- Has a "FILES" section which is not appropriate or at least unneeded. ================ >How-To-Repeat: n/a ================ >Fix: patch -d "unknown uncompressed man directory" < this-PR --- /tmp/eject..orig.1 Wed Jan 23 19:49:58 2002 +++ /tmp/eject.1 Wed Jan 23 21:02:57 2002 @@ -36,39 +36,23 @@ .Ar device .Sh DESCRIPTION .Nm eject -is a program to eject removable media from drive. -The +causes removable media to ejected from the drive named by .Ar device -is a removable drive name such as cd0, matcd0, mcd0, scd0, wcd0 or od0. -.Nm eject -unmounts the -.Ar device -if it was mounted brefore ejecting. +(eg, cd0, matcd0, mcd0, scd0, wcd0, or od0), which if mounted on a +filesystem, is first dismounted. .Pp The following options are available: .Bl -tag -width Ds .It Fl f -Force unmounts the device if it was mounted. +Forcibly unmounts the device if it was mounted (as in umount(8)). .It Fl n -Not execute operation but print it. +Do not eject, but verbosely output what would be done. .It Fl v -Verbose mode. +Verbosely output what is done. .Sh ENVIRONMENT -If the following environment variable exists, it is used by -.Nm eject : .Bl -tag -width Ds .It Ev EJECT -Specifies default device. -.El -.Sh FILES -.Bl -tag -width /dev/rmatcd0c -compact -.It Pa /dev/rcd0c -.It Pa /dev/rmatcd0c -.It Pa /dev/rmcd0c -.It Pa /dev/rscd0c -.It Pa /dev/rwcd0c -.It Pa /dev/rod0c -.El +Specifies the default device. .Sh AUTHOR Shunsuke Akiyama .Sh HISTORY >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message