From owner-freebsd-arch@FreeBSD.ORG Mon Jul 8 21:55:52 2013 Return-Path: Delivered-To: freebsd-arch@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id B63B71E4; Mon, 8 Jul 2013 21:55:52 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-3.mit.edu (dmz-mailsec-scanner-3.mit.edu [18.9.25.14]) by mx1.freebsd.org (Postfix) with ESMTP id 386941B34; Mon, 8 Jul 2013 21:55:51 +0000 (UTC) X-AuditID: 1209190e-b7f988e0000009a7-9d-51db35663815 Received: from mailhub-auth-1.mit.edu ( [18.9.21.35]) by dmz-mailsec-scanner-3.mit.edu (Symantec Messaging Gateway) with SMTP id FD.9D.02471.6653BD15; Mon, 8 Jul 2013 17:55:50 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-1.mit.edu (8.13.8/8.9.2) with ESMTP id r68Ltoq7025654; Mon, 8 Jul 2013 17:55:50 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r68Ltleo022338 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 8 Jul 2013 17:55:49 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r68Ltl6e000770; Mon, 8 Jul 2013 17:55:47 -0400 (EDT) Date: Mon, 8 Jul 2013 17:55:47 -0400 (EDT) From: Benjamin Kaduk To: Craig Rodrigues Subject: Re: [RFC] Review of mount.conf man page In-Reply-To: Message-ID: References: User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrDIsWRmVeSWpSXmKPExsUixCmqrJtmejvQYMEXE4vZ06cxWXy8OoPd Ym9vD5sDs8eMT/NZAhijuGxSUnMyy1KL9O0SuDL2nJnKVHCYu2Ld9L/MDYzbObsYOTkkBEwk mi90s0DYYhIX7q1n62Lk4hAS2McosXr7cShnA6PEihW9TBDOQSaJhsU9jCAtQgL1EpOObmcG sVkEtCQ+P2tjBbHZBFQkZr7ZyAZiiwhoSnTeXscEYjMLOEucercJbJ2wgIHE202nwOZwCgRK /Hm1F6yXV8BR4sSeH0AzOYDmB0gcmuQMEhYV0JFYvX8KC0SJoMTJmU9YIEZaSpz7c51tAqPg LCSpWUhSCxiZVjHKpuRW6eYmZuYUpybrFicn5uWlFuka6+VmluilppRuYgQHqiTfDsavB5UO MQpwMCrx8M64eCtQiDWxrLgy9xCjJAeTkiivh97tQCG+pPyUyozE4oz4otKc1OJDjBIczEoi vC9UgXK8KYmVValF+TApaQ4WJXHeZ0/PBgoJpCeWpGanphakFsFkZTg4lCR4S02AGgWLUtNT K9Iyc0oQ0kwcnCDDeYCGzwSp4S0uSMwtzkyHyJ9iVJQS511oBJQQAElklObB9cISyStGcaBX hHkNQKp4gEkIrvsV0GAmoMENabdABpckIqSkGhjLZsk0nJ2v8jbTxEHXdANft9Q6i4gJfHPr n309UVh6RfNyyG8Z8V1d003K1L6uedFR+fuOzt3rU4wfqy9+ICxxO9Tq7tUJvFPbLkzgWrNW 6KxLRE3Ghf8vb1h+zaiK41PhWvondMfNUIFWxSPac+8wr09OLM5xM3S7/nd6nPmOkCymvxEl /0KVWIozEg21mIuKEwG/Khq8/wIAAA== Cc: Marcel Moolenaar , freebsd-arch@freebsd.org X-BeenThere: freebsd-arch@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Discussion related to FreeBSD architecture List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Jul 2013 21:55:52 -0000 On Mon, 8 Jul 2013, Craig Rodrigues wrote: > Hi, > > In this GRN, Marcel overhauled the root mount logic: > > ------------------------------------------------------------------------ > r214006 | marcel | 2010-10-17 22:01:53 -0700 (Sun, 17 Oct 2010) | 20 lines > > Re-implement the root mount logic using a recursive approach, whereby each > root file system (starting with devfs and a synthesized configuration) can > contain directives for mounting another file system as root. > ------------------------------------------------------------------------ > > My diff is here: > > http://people.freebsd.org/~rodrigc/mount-conf/mount.conf.diff.txt > > I also have the man page rendered in ASCII, for easier reading: > > http://people.freebsd.org/~rodrigc/mount-conf/mount.conf.8.txt A few notes: our style for man pages (mdoc) is to start a new line for new sentences. I am not sure that the .Cm macro is appropriate to describe .onfail and friends; I guess that devd.conf.5 is using .Ic which might be better. The default font for .Em is supposedly italic, so it may not be best for the mountroot prompt, either. I'm not sure why there are square brackets around the 'N' argument to .timeout; does the default behavior of 3 seconds apply to a .timeout without 'N', or the absence of a .timeout? Can you double-check whether .Pp is needed after .Ed? Thanks for writing this, it's always good to have these things documented. -Ben