From owner-freebsd-doc@FreeBSD.ORG Mon Nov 24 18:51:19 2008 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 260181065670; Mon, 24 Nov 2008 18:51:19 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from pittgoth.com (pittgoth.com [205.134.163.206]) by mx1.freebsd.org (Postfix) with ESMTP id C77BA8FC08; Mon, 24 Nov 2008 18:51:18 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from localhost.fbsdsecure.org (c-68-83-213-214.hsd1.va.comcast.net [68.83.213.214]) (authenticated bits=0) by pittgoth.com (8.14.2/8.14.2) with ESMTP id mAOIpBbE017840 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 24 Nov 2008 13:51:12 -0500 (EST) (envelope-from trhodes@FreeBSD.org) Date: Mon, 24 Nov 2008 13:51:07 -0500 From: Tom Rhodes To: Manolis Kiagias Message-Id: <20081124135107.06a8af26.trhodes@FreeBSD.org> In-Reply-To: <492AE607.4020208@gmail.com> References: <492AE607.4020208@gmail.com> X-Mailer: Sylpheed version 1.0.6 (GTK+ 1.2.10; i386-portbld-freebsd8.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: gabor@kovesdan.org, pgj@FreeBSD.org, doc@FreeBSD.org, keramida@FreeBSD.org, trhodes@FreeBSD.org Subject: Re: A patch for the 'geom' chapter 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, 24 Nov 2008 18:51:19 -0000 On Mon, 24 Nov 2008 19:36:07 +0200 Manolis Kiagias wrote: > Hey all, > > I recently completed the Greek translation of the geom chapter and (as > it has become customary) I also created a patch for the English > version. So I 'd thought to call all my usual reviewers (and anyone > else who cares to comment): > > http://people.freebsd.org/~manolis/geom.txt > > A brief description of (some) changes: > > - Added the messages returned by a gstripe command (as requested by the > original author) > - Change the /mnt as a permanent mount point in fstab, suggested in an > example. Since /mnt is normally used for temporary administrator mounts, > it makes sense to create a specific mount point for a permanent mount. > - Convert a vi editing session to a . The user is free to choose > his editor - although the original vi instructions are handy and should > not be removed > - It seems glabel can create both permanent and temporary labels that > are not file system specific. Reworded the relevant paragraphs > - Add a complete example of labeling a boot disk's partitions, so it can > be used on another controller, or indeed, system > - Journaling does not store the log on the last sector (only metadata > that shows the volume is journaled) > - Loading the geom_journal module during startup - or building it into a > custom kernel > - Add a reference to my gjournal-desktop article ;) > - Minor rewording in paragraphs above / below the actual changes to > avoid repeating the same information > > This is a somewhat lengthy patch, for those that feel better reading the > build, here it is: > > http://people.freebsd.org/~manolis/geom.html > > Any and all comments appreciated :) This looks pretty good actually. I would probably change the following: + + Labeling Your Boot Disk's Partitions to: Labeling Partitions on the Boot Disk And there are a lot of "You" references. I've tried to write this without invoking the user as much as possible and may make reading the entire chapter difficult. I would prefer we not talk to the user though. -- Tom Rhodes