From owner-freebsd-doc@FreeBSD.ORG  Tue Sep  5 09:37:39 2006
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: freebsd-doc@freebsd.org
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 7770516A4DD;
	Tue,  5 Sep 2006 09:37:39 +0000 (UTC)
	(envelope-from mdmay74@internode.on.net)
Received: from smtp3.adl2.internode.on.net (smtp3.adl2.internode.on.net
	[203.16.214.203])
	by mx1.FreeBSD.org (Postfix) with ESMTP id D2EFE43D46;
	Tue,  5 Sep 2006 09:37:38 +0000 (GMT)
	(envelope-from mdmay74@internode.on.net)
Received: from [192.168.0.2] (ppp217-176.lns1.adl2.internode.on.net
	[203.122.217.176])
	by smtp3.adl2.internode.on.net (8.13.6/8.13.5) with ESMTP id
	k859baSu081306; Tue, 5 Sep 2006 19:07:37 +0930 (CST)
	(envelope-from mdmay74@internode.on.net)
Message-ID: <44FD45C3.7090907@internode.on.net>
Date: Tue, 05 Sep 2006 19:09:15 +0930
From: Matthew May <mdmay74@internode.on.net>
User-Agent: Mozilla Thunderbird 1.0.7 (X11/20051215)
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: freebsd-doc@freebsd.org, Giorgos Keramidas <keramida@freebsd.org>,
	Daniel Gerzo <danger@freebsd.org>, Tom Rhodes <trhodes@freebsd.org>
References: <20060904120036.8441716A4F5@hub.freebsd.org>
In-Reply-To: <20060904120036.8441716A4F5@hub.freebsd.org>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Cc: 
Subject: Re: mount(8) async description
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 05 Sep 2006 09:37:39 -0000

On 2006-09-04 07:36, Giorgos Keramidas <keramida@FreeBSD.org> wrote:

 > Hi Daniel and everyone else,
 >
 > In retrospect, having let this sink down for a few days, I think we
 > should also bear in mind Ruslan Ermilov's comments about referring to
 > the reader in second person.  Is there any way we can keep the same
 > meaning, stress the dangers of using ``-o async'' *and* avoid using
 > ``you'' in the text?
 >
 > This is definitely far across the borders of nit-picking, but perhaps
 > we can use something like this (based on the OpenBSD version, with the
 > fixes suggested by Matthew May <mdmay74@internode.on.net>, and using
 > the backup/newfs text suggested by Daniel):
 >
 >   async   All I/O to the file system should be done asynchronously.
 >           This is a dengerous flag to set, since it does not guarantee
 >           that the file system structure on the disk will remain
 >           consistent.  For this reason, the `async' flag should not be
 >           used unless some application-specific data recovery
 >           mechanism is present, or recreation of the file system is
 >           not a problem.
 >
 > Does this look less wordy and still useful as a change?
 >
 > - Giorgos

Hi Giorgos,

After a quick s/dengerous/dangerous/ I'd be happy with that :-)

MAtt.