From owner-freebsd-doc@FreeBSD.ORG Mon Aug 22 16:40:15 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 08B0F106566B for ; Mon, 22 Aug 2011 16:40:15 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id D3E0F8FC13 for ; Mon, 22 Aug 2011 16:40:14 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p7MGeEAg027029 for ; Mon, 22 Aug 2011 16:40:14 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p7MGeEZW027027; Mon, 22 Aug 2011 16:40:14 GMT (envelope-from gnats) Date: Mon, 22 Aug 2011 16:40:14 GMT Message-Id: <201108221640.p7MGeEZW027027@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Benjamin Kaduk Cc: Subject: Re: docs/159897: [patch] improve HAST section of Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Benjamin Kaduk List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 22 Aug 2011 16:40:15 -0000 The following reply was made to PR docs/159897; it has been noted by GNATS. From: Benjamin Kaduk To: Warren Block Cc: freebsd-gnats-submit@freebsd.org, freebsd-doc@freebsd.org Subject: Re: docs/159897: [patch] improve HAST section of Handbook Date: Mon, 22 Aug 2011 12:36:42 -0400 (EDT) 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? > >>> Once the HAST framework is configured >>> properly, the final step is to make sure that >>> - HAST is started during the system boot time >>> - automatically. The following line should be added to the >>> - /etc/rc.conf file: >>> + HAST is started automatically during the system >>> + boot. This line is added to >>> + /etc/rc.conf: >> >> "This line is added" is a pretty unusual grammatical construct for what is >> attempting to be conveyed. "To do so, add this line to" I think says >> things more clearly. > > I would prefer the imperative "Add this line to...". That works. I had initially shied away from it since it could be read to imply that all users should do so, not just those wanting to use HAST. But this is the HAST section, after all. > >>> - 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". Can you prepare an updated patch with these changes? Thanks, Ben