From mwlucas@blackhelicopters.org  Fri Nov  9 11:29:22 2001
Return-Path: <mwlucas@blackhelicopters.org>
Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18])
	by hub.freebsd.org (Postfix) with ESMTP id D981937B417
	for <FreeBSD-gnats-submit@freebsd.org>; Fri,  9 Nov 2001 11:29:21 -0800 (PST)
Received: (from mwlucas@localhost)
	by blackhelicopters.org (8.9.3/8.9.3) id OAA16131;
	Fri, 9 Nov 2001 14:29:21 -0500 (EST)
	(envelope-from mwlucas)
Message-Id: <200111091929.OAA16131@blackhelicopters.org>
Date: Fri, 9 Nov 2001 14:29:21 -0500 (EST)
From: mwlucas@blackhelicopters.org
Reply-To: mwlucas@blackhelicopters.org
To: FreeBSD-gnats-submit@freebsd.org
Subject: warning in Handbook about umount -f
X-Send-Pr-Version: 3.2

>Number:         31883
>Category:       docs
>Synopsis:       warning in Handbook about umount -f
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri Nov 09 11:30:01 PST 2001
>Closed-Date:    Mon Nov 12 19:32:41 PST 2001
>Last-Modified:  Mon Nov 12 19:32:56 PST 2001
>Originator:     Michael Lucas
>Release:        FreeBSD 3.5-STABLE i386
>Organization:
None
>Environment:

current -doc tree

>Description:

The Handbook mentions use of umount -f, but does not mention that
there is any risk involved with this.

This section of the Handbook also has several areas where hard tabs
are used instead of spaces.  Does this warrant a separate PR?

>How-To-Repeat:


>Fix:

*** en_US.ISO8859-1/books/handbook/basics/chapter.sgml-dist	Fri Nov  9 14:21:12 2001
--- en_US.ISO8859-1/books/handbook/basics/chapter.sgml	Fri Nov  9 14:27:36 2001
***************
*** 694,700 ****
  	<option>-A</option> option.</para>
          
        <para>All forms take <option>-f</option> to force unmounting,
! 	and <option>-v</option> for verbosity.</para>
          
        <para><option>-a</option> and <option>-A</option> are used to
  	unmount all mounted filesystems, possibly modified by the
--- 694,703 ----
  	<option>-A</option> option.</para>
          
        <para>All forms take <option>-f</option> to force unmounting,
!         and <option>-v</option> for verbosity.  Be warned that
!         <option>-f</option> is not generally a good idea.  Forcibly
!         unmounting filesystems can crash the computer or damage data
!         on the filesystem.</para>
          
        <para><option>-a</option> and <option>-A</option> are used to
  	unmount all mounted filesystems, possibly modified by the
>Release-Note:
>Audit-Trail:

From: Cyrille Lefevre <clefevre@citeweb.net>
To: mwlucas@blackhelicopters.org
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/31883: warning in Handbook about umount -f
Date: Sat, 10 Nov 2001 01:53:50 +0100 (CET)

 mwlucas@blackhelicopters.org wrote:
 > 
 > !         unmounting filesystems can crash the computer or damage data
                                    ^^^ may
 > !         on the filesystem.</para>
 
 Cyrille.
 -- 
 Cyrille Lefevre                 mailto:clefevre@citeweb.net

From: Michael Lucas <mwlucas@blackhelicopters.org>
To: Cyrille Lefevre <clefevre@citeweb.net>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/31883: warning in Handbook about umount -f
Date: Mon, 12 Nov 2001 09:48:05 -0500

 --DocE+STaALJfprDB
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 On Sat, Nov 10, 2001 at 01:53:50AM +0100, Cyrille Lefevre wrote:
 > mwlucas@blackhelicopters.org wrote:
 > > 
 > > !         unmounting filesystems can crash the computer or damage data
 >                                    ^^^ may
 > > !         on the filesystem.</para>
 
 As someone else suggested, "might" is probably most appropriate here.
 But thanks.
 
 Patch attached.
 
 -- 
 Michael Lucas
 mwlucas@blackhelicopters.org
 http://www.blackhelicopters.org/~mwlucas/
 Big Scary Daemons: http://www.oreillynet.com/pub/q/Big_Scary_Daemons
 
 --DocE+STaALJfprDB
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename=umount
 
 *** en_US.ISO8859-1/books/handbook/basics/chapter.sgml-dist	Fri Nov  9 14:21:12 2001
 --- en_US.ISO8859-1/books/handbook/basics/chapter.sgml	Fri Nov  9 14:27:36 2001
 ***************
 *** 694,700 ****
   	<option>-A</option> option.</para>
           
         <para>All forms take <option>-f</option> to force unmounting,
 ! 	and <option>-v</option> for verbosity.</para>
           
         <para><option>-a</option> and <option>-A</option> are used to
   	unmount all mounted filesystems, possibly modified by the
 --- 694,703 ----
   	<option>-A</option> option.</para>
           
         <para>All forms take <option>-f</option> to force unmounting,
 !         and <option>-v</option> for verbosity.  Be warned that
 !         <option>-f</option> is not generally a good idea.  Forcibly
 !         unmounting filesystems might crash the computer or damage data
 !         on the filesystem.</para>
           
         <para><option>-a</option> and <option>-A</option> are used to
   	unmount all mounted filesystems, possibly modified by the
 
 --DocE+STaALJfprDB--
State-Changed-From-To: open->closed 
State-Changed-By: bmah 
State-Changed-When: Mon Nov 12 19:32:41 PST 2001 
State-Changed-Why:  
Committed the last version of the patch...thanks! 

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