From owner-freebsd-doc  Fri Nov  9 11:30:11 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 AD74537B41A
	for <freebsd-doc@freebsd.org>; Fri,  9 Nov 2001 11:30:01 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.4/8.11.4) id fA9JU1130727;
	Fri, 9 Nov 2001 11:30:01 -0800 (PST)
	(envelope-from gnats)
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
X-Send-Pr-Version: 3.2
Subject: docs/31883: warning in Handbook about umount -f
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         31883
>Category:       docs
>Synopsis:       warning in Handbook about umount -f
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri Nov 09 11:30:01 PST 2001
>Closed-Date:
>Last-Modified:
>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:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message