From owner-freebsd-doc@FreeBSD.ORG Mon Sep 4 14:37:38 2006 Return-Path: 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 57C7D16A4DD for ; Mon, 4 Sep 2006 14:37:38 +0000 (UTC) (envelope-from keramida@FreeBSD.org) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7C62443D66 for ; Mon, 4 Sep 2006 14:37:32 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from gothmog.pc (host5.bedc.ondsl.gr [62.103.39.229]) (authenticated bits=128) by igloo.linux.gr (8.13.7/8.13.7/Debian-2) with ESMTP id k84Eat6A028004 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 4 Sep 2006 17:37:10 +0300 Received: from gothmog.pc (gothmog [127.0.0.1]) by gothmog.pc (8.13.7/8.13.7) with ESMTP id k84EbBqf089802; Mon, 4 Sep 2006 17:37:14 +0300 (EEST) (envelope-from keramida@FreeBSD.org) Received: (from giorgos@localhost) by gothmog.pc (8.13.7/8.13.7/Submit) id k84Eav7W085836; Mon, 4 Sep 2006 17:36:57 +0300 (EEST) (envelope-from keramida@FreeBSD.org) Date: Mon, 4 Sep 2006 17:36:47 +0300 From: Giorgos Keramidas To: John Andrewartha Message-ID: <20060904143647.GA26439@gothmog.pc> References: <200609042022.31150.mulgajohn@bigpond.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="EVF5PPMfhYS0aIcm" Content-Disposition: inline In-Reply-To: <200609042022.31150.mulgajohn@bigpond.com> X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (score=-3.026, required 5, autolearn=not spam, AWL -0.43, BAYES_00 -2.60, UNPARSEABLE_RELAY 0.00) X-Hellug-MailScanner-From: keramida@freebsd.org X-Spam-Status: No Cc: freebsd-doc@FreeBSD.org Subject: Re: Just to add to the confusion: async X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 04 Sep 2006 14:37:38 -0000 --EVF5PPMfhYS0aIcm Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2006-09-04 20:22, John Andrewartha wrote: > Try this version. > Good English 5 lines and says it all Sorry but no. First of all, make sure you Cc: me and use *reply* to the message, otherwise your message/followup may be lost in the noise. This would be a terrible shame, if the suggestions you are making are cool :-/ > async >=20 > Caution is advised when using this command. > All I/O to the file system should be done asynchronously to > ensuring maintaining the full integrity of the file system. > The use of the 'async' flag by an application may cause unrecoverable > data loose and corrupt the disk beyond recovery. Unfortunately, there are quite a few points which are not so good here: + "to ensuring" ? + "ensuring maintaining" ? + What is "full integrity" and how does it compare to "non-full"? + The "async" flag is not used by an application, but it a property of a mount point + "data loss" is spelled differently + The disk is not corrupted by 'async'. The disk should still work fine after a newfs operation. The filesystem though, is another story. If you fix the above points, and *still* want to help, I would be honestly grateful to see the fixed version, as this part of the manpage has already caused far too many people to waste too much time, so we should just fix it and move on. Thank you for taking the time to write. I really appreciate any help and I am grateful that you did spend the time to think about a good way to write this :) -- Giorgos --EVF5PPMfhYS0aIcm Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.5 (FreeBSD) iD8DBQFE/Dn/1g+UGjGGA7YRAnn3AJ4mpEywhYSfO4SwVStBeaYFtFmTSACfQ/Rh ZV3jcNAG3XK3K3gYfAV4nl8= =vDBU -----END PGP SIGNATURE----- --EVF5PPMfhYS0aIcm--