From owner-freebsd-doc@FreeBSD.ORG Wed Aug 24 01:04:32 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 6E34A1065672; Wed, 24 Aug 2011 01:04:32 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-6.mit.edu (DMZ-MAILSEC-SCANNER-6.MIT.EDU [18.7.68.35]) by mx1.freebsd.org (Postfix) with ESMTP id 0A3A68FC0A; Wed, 24 Aug 2011 01:04:31 +0000 (UTC) X-AuditID: 12074423-b7b31ae000000a3c-46-4e544e1e3506 Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) by dmz-mailsec-scanner-6.mit.edu (Symantec Messaging Gateway) with SMTP id 94.3D.02620.E1E445E4; Tue, 23 Aug 2011 21:04:30 -0400 (EDT) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id p7O14UJo030836; Tue, 23 Aug 2011 21:04:30 -0400 Received: from multics.mit.edu (MULTICS.MIT.EDU [18.187.1.73]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id p7O14SsH008029 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Tue, 23 Aug 2011 21:04:29 -0400 (EDT) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id p7O14RVM013420; Tue, 23 Aug 2011 21:04:27 -0400 (EDT) Date: Tue, 23 Aug 2011 21:04:27 -0400 (EDT) From: Benjamin Kaduk To: Warren Block In-Reply-To: Message-ID: References: <201108182253.p7IMr0us086588@red.freebsd.org> <20110823060936.GA19211@chaos.ukrhub.net> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrNIsWRmVeSWpSXmKPExsUixG6noivnF+JncHGHicX5b2tYLE6d6WK1 aHmymt3i1ykPBxaPGZ/ms3jcnXCU0eNIxyPGAOYoLpuU1JzMstQifbsErozLf4+yFNwUq7jT /pq9gfGPYBcjJ4eEgInE12+NLBC2mMSFe+vZuhi5OIQE9jFKrOlvZ4RwNjBKnHr3hwnCOcAk caRhDyuE08Ao0bLsEjtIP4uAtsSpP11sIDabgIrEzDcbgWwODhEBVYm9Z6xBwswCqRJzF8xm BbGFBZwkrsw4D9bKKWArsWXDIRaQcl4BB4n5pyQgxj9iktg54zpYjaiAjsTq/VPATuUVEJQ4 OfMJC8RMS4l/a3+xTmAUnIUkNQtJagEj0ypG2ZTcKt3cxMyc4tRk3eLkxLy81CJdM73czBK9 1JTSTYzgMHZR3sH456DSIUYBDkYlHt4bF4L9hFgTy4orcw8xSnIwKYnyXvYJ8RPiS8pPqcxI LM6ILyrNSS0+xCjBwawkwvuVByjHm5JYWZValA+TkuZgURLnldnp4CckkJ5YkpqdmlqQWgST leHgUJLgrfAFahQsSk1PrUjLzClBSDNxcIIM5wEaXgJSw1tckJhbnJkOkT/FqCglztsOkhAA SWSU5sH1wtLMK0ZxoFeEeb1BqniAKQqu+xXQYCagwRy/gkAGlyQipKQaGHMu3DaudKr93R3A mnFA151FY5P40dpnod8WiapXxVmfcdDhuvu9/+a31pbs2bffq9bcSf6ewFG+6kNB8M4J58r2 nTt3/0tG/AYtjiP6U522vrPsS1xdXHwlcOHOa/bFOce0vvTsqvt9melOq2hD9MSZaa8/tEi+ E19o1s3HHrV/k5n3j1/+p5RYijMSDbWYi4oTAVvcChUOAwAA Cc: freebsd-doc@freebsd.org, freebsd-gnats-submit@freebsd.org Subject: Re: docs/159897: [patch] improve HAST section of Handbook 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: Wed, 24 Aug 2011 01:04:32 -0000 On Tue, 23 Aug 2011, Warren Block wrote: > On Tue, 23 Aug 2011, Taras Korenko wrote: > >> On Mon, Aug 22, 2011 at 06:08:09PM -0600, Warren Block wrote: >>> On Mon, 22 Aug 2011, Benjamin Kaduk wrote: >>> >>>> On Sun, 21 Aug 2011, Warren Block wrote: >>>> >>>>> On Sat, 20 Aug 2011, Benjamin Kaduk wrote: >>>>> >>>>>> On Thu, 18 Aug 2011, Warren Block wrote: >>>>>> >>>>>>> - File system agnostic, thus allowing to use any file >>>>>>> + File system agnostic, thus allowing use of any file >>>>>> >>>>>> I think "allowing the use" is better here. >>>>> >>>>> "allowing any" might be even better. >>>> >>>> I don't think that would be correct usage -- "allowing any file system" >>>> to >>>> do what? >>> >>> Allowing any file system versus allowing only file systems made for >>> HAST. Looking at it again, the problem is the word "allowing". What >>> this is really saying is: "File system agnostic, compatible with any >>> file system supported by &os;." >>> >> >> File system agnostic, thus allowing laying out any file >> system supported by &os;. > > Another day and now "agnostic" looks wrong. IMO, the meaning is not "HAST is > unsure that file systems exist", but that it operates at a block level and is > not even aware of file systems. More simply, it doesn't care which file > system is used. > > So my latest proposal for the simplest rewording is > > "Works with any file system supported by FreeBSD." Filesystem-agnostic is something of a term of art for this sort of thing; I would stick with: "File system agnostic; works with any file system supported by FreeBSD." (This is where bde comes in and tells me off for condensing filesystem into a single word, per http://lists.freebsd.org/pipermail/svn-src-head/2011-June/028709.html ) >>>>> - In order to fix this situation the administrator has to >>>>> + The administrator must >>>>> decide which node has more important changes (or merge them >>>>> - manually) and let the HAST perform >>>>> + manually) and let HAST perform >>>>> the full synchronization of the node which has the broken >>>> >>>> Just "full synchronization", I think. >>> >>> Changing "of" to "on" ("full synchronization on the node") also helps a >>> bit. >> >> I think I still prefer "of", but would not object to "on". > > The idea is that "synchronization of the node" is ambiguous about which node > is being changed, where "synchronization on the node", er, isn't. It is "synchronization of the node to the reference state" versus "a synchronization process on the [broken] node to bring it back into a good state". In going for concision, we necessarily introduce some ambiguity; I'm not equipped to say which one has the greater ambiguity for more people. Thanks again, Ben