From owner-freebsd-doc@FreeBSD.ORG Wed Mar 13 20:09:08 2013 Return-Path: Delivered-To: doc@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 55D31639 for ; Wed, 13 Mar 2013 20:09:08 +0000 (UTC) (envelope-from joel@freebsd.org) Received: from mail.vnode.se (mail.vnode.se [212.247.52.13]) by mx1.freebsd.org (Postfix) with ESMTP id DB420663 for ; Wed, 13 Mar 2013 20:09:07 +0000 (UTC) Received: from mail.vnode.se (localhost [127.0.0.1]) by mail.vnode.se (Postfix) with ESMTP id E98CFE3F07A for ; Wed, 13 Mar 2013 21:08:59 +0100 (CET) X-Virus-Scanned: amavisd-new at vnode.se Received: from mail.vnode.se ([127.0.0.1]) by mail.vnode.se (mail.vnode.se [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id W2BsbWQ8NHUD for ; Wed, 13 Mar 2013 21:08:57 +0100 (CET) Received: from devbox.vnode.local (unknown [83.223.1.131]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mail.vnode.se (Postfix) with ESMTPSA id 7B28BE3F079 for ; Wed, 13 Mar 2013 21:08:57 +0100 (CET) Date: Wed, 13 Mar 2013 21:08:55 +0100 From: Joel Dahl To: doc@freebsd.org Subject: Re: Documenting various GEOM_* kernel options Message-ID: <20130313200855.GA1089@devbox.vnode.local> References: <20130309091122.GH17537@devbox.vnode.local> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="zhXaljGHf11kAtnf" Content-Disposition: inline In-Reply-To: <20130309091122.GH17537@devbox.vnode.local> User-Agent: Mutt/1.5.21 (2010-09-15) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 13 Mar 2013 20:09:08 -0000 --zhXaljGHf11kAtnf Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Sat, Mar 09, 2013 at 10:11:23AM +0100, Joel Dahl wrote: > > I recently noticed we haven't documented all of the various GEOM_* kernel > options in any manual pages. > > Both the gpart(8) and geli(8) manpages have kernel options in the SYNOPSIS, > which probably isn't correct for section 8 manpages. > > What about using the SYNOPSIS in the geom(4) manpage? Opinions? I have something like the attached patch in mind. -- Joel --zhXaljGHf11kAtnf Content-Type: text/x-diff; charset=us-ascii Content-Disposition: attachment; filename="geom.diff" Index: share/man/man4/geom.4 =================================================================== --- share/man/man4/geom.4 (revision 248249) +++ share/man/man4/geom.4 (working copy) @@ -40,6 +40,41 @@ .Sh NAME .Nm GEOM .Nd "modular disk I/O request transformation framework" +.Sh SYNOPSIS +.Cd options GEOM_AES +.Cd options GEOM_BDE +.Cd options GEOM_BSD +.Cd options GEOM_CACHE +.Cd options GEOM_CONCAT +.Cd options GEOM_ELI +.Cd options GEOM_FOX +.Cd options GEOM_GATE +.Cd options GEOM_JOURNAL +.Cd options GEOM_LABEL +.Cd options GEOM_LINUX_LVM +.Cd options GEOM_MBR +.Cd options GEOM_MIRROR +.Cd options GEOM_MULTIPATH +.Cd options GEOM_NOP +.Cd options GEOM_PART_APM +.Cd options GEOM_PART_BSD +.Cd options GEOM_PART_EBR +.Cd options GEOM_PART_EBR_COMPAT +.Cd options GEOM_PART_GPT +.Cd options GEOM_PART_LDM +.Cd options GEOM_PART_MBR +.Cd options GEOM_PART_PC98 +.Cd options GEOM_PART_VTOC8 +.Cd options GEOM_PC98 +.Cd options GEOM_RAID +.Cd options GEOM_RAID3 +.Cd options GEOM_SHSEC +.Cd options GEOM_STRIPE +.Cd options GEOM_SUNLABEL +.Cd options GEOM_UZIP +.Cd options GEOM_VIRSTOR +.Cd options GEOM_VOL +.Cd options GEOM_ZERO .Sh DESCRIPTION The .Nm Index: sbin/geom/class/eli/geli.8 =================================================================== --- sbin/geom/class/eli/geli.8 (revision 248249) +++ sbin/geom/class/eli/geli.8 (working copy) @@ -31,25 +31,7 @@ .Nm geli .Nd "control utility for the cryptographic GEOM class" .Sh SYNOPSIS -To compile GEOM_ELI into your kernel, add the following lines to your kernel -configuration file: -.Bd -ragged -offset indent -.Cd "device crypto" -.Cd "options GEOM_ELI" -.Ed -.Pp -Alternatively, to load the GEOM_ELI module at boot time, add the following line -to your -.Xr loader.conf 5 : -.Bd -literal -offset indent -geom_eli_load="YES" -.Ed -.Pp -Usage of the .Nm -utility: -.Pp -.Nm .Cm init .Op Fl bPv .Op Fl a Ar aalgo Index: sbin/geom/class/part/gpart.8 =================================================================== --- sbin/geom/class/part/gpart.8 (revision 248249) +++ sbin/geom/class/part/gpart.8 (working copy) @@ -31,33 +31,6 @@ .Nm gpart .Nd "control utility for the disk partitioning GEOM class" .Sh SYNOPSIS -To add support for the disk partitioning GEOM class, -place one or more of the following -lines in the kernel configuration file: -.Bd -ragged -offset indent -.Cd "options GEOM_PART_APM" -.Cd "options GEOM_PART_BSD" -.Cd "options GEOM_PART_GPT" -.Cd "options GEOM_PART_LDM" -.Cd "options GEOM_PART_MBR" -.Cd "options GEOM_PART_EBR" -.Cd "options GEOM_PART_EBR_COMPAT" -.Cd "options GEOM_PART_PC98" -.Cd "options GEOM_PART_VTOC8" -.Ed -.Pp -These options provide support for the various types of partitioning -schemes supported by the -.Ns Nm -utility. -See -.Sx "PARTITIONING SCHEMES" -below for more details. -.Pp -Usage of the -.Ns Nm -utility: -.Pp .\" ==== ADD ==== .Nm .Cm add --zhXaljGHf11kAtnf--