From swear@blarg.net  Wed Jan 23 21:17:05 2002
Return-Path: <swear@blarg.net>
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id CA22037B405
	for <FreeBSD-gnats-submit@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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 <FreeBSD-gnats-submit@freebsd.org>; 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: <z4n0z49vg5.0z4@localhost.localdomain>
Date: 23 Jan 2002 21:20:10 -0800
From: "Gary W. Swearingen" <swear@blarg.net>
Reply-To: swear@blarg.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: eject(1) man page needs cleanup
X-GNATS-Notify:

>Number:         34220
>Category:       docs
>Synopsis:       eject(1) man page needs cleanup
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jan 23 21:20:01 PST 2002
>Closed-Date:    Fri Jan 25 14:12:00 PST 2002
>Last-Modified:  Fri Jan 25 14:12:14 PST 2002
>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 <akiyama@jp.FreeBSD.org>
 .Sh HISTORY
>Release-Note:
>Audit-Trail:

From: Dima Dorfman <dima@trit.org>
To: swear@blarg.net
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/34220: eject(1) man page needs cleanup 
Date: Fri, 25 Jan 2002 00:51:57 +0000

 "Gary W. Swearingen" <swear@blarg.net> wrote:
 > 
 > >Number:         34220
 > >Category:       docs
 > >Synopsis:       eject(1) man page needs cleanup
 
 There is no eject(1) in the base system:
 
 	dd@ref5% man eject
 	No manual entry for eject

From: swear@blarg.net (Gary W. Swearingen)
To: Dima Dorfman <dima@trit.org>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/34220: eject(1) man page needs cleanup
Date: 24 Jan 2002 20:21:23 -0800

 Dima Dorfman <dima@trit.org> writes:
 
 > There is no eject(1) in the base system:
 
 Sorry.  I'll try the author or porter.  Close it.
State-Changed-From-To: open->closed 
State-Changed-By: dd 
State-Changed-When: Fri Jan 25 14:12:00 PST 2002 
State-Changed-Why:  
Manual page in question is from a port. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=34220 
>Unformatted:
