From owner-cvs-src@FreeBSD.ORG Wed Oct 12 19:33:43 2005 Return-Path: X-Original-To: cvs-src@freebsd.org Delivered-To: cvs-src@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9283716A41F; Wed, 12 Oct 2005 19:33:43 +0000 (GMT) (envelope-from ru@ip.net.ua) Received: from tigra.ip.net.ua (tigra.ip.net.ua [82.193.96.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6EF3643D55; Wed, 12 Oct 2005 19:33:41 +0000 (GMT) (envelope-from ru@ip.net.ua) Received: from localhost (rocky.ip.net.ua [82.193.96.2]) by tigra.ip.net.ua (8.12.11/8.12.11) with ESMTP id j9CJXehd088466; Wed, 12 Oct 2005 22:33:40 +0300 (EEST) (envelope-from ru@ip.net.ua) Received: from tigra.ip.net.ua ([82.193.96.10]) by localhost (rocky.ipnet [82.193.96.2]) (amavisd-new, port 10024) with LMTP id 75349-02-2; Wed, 12 Oct 2005 22:33:37 +0300 (EEST) Received: from heffalump.ip.net.ua (heffalump.ip.net.ua [82.193.96.213]) by tigra.ip.net.ua (8.12.11/8.12.11) with ESMTP id j9CJT0Gh088333 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 12 Oct 2005 22:29:00 +0300 (EEST) (envelope-from ru@ip.net.ua) Received: (from ru@localhost) by heffalump.ip.net.ua (8.13.4/8.13.4) id j9CJT1ko096698; Wed, 12 Oct 2005 22:29:01 +0300 (EEST) (envelope-from ru) Date: Wed, 12 Oct 2005 22:29:00 +0300 From: Ruslan Ermilov To: John Baldwin Message-ID: <20051012192900.GF75270@ip.net.ua> References: <200510070232.j972WGm9013102@repoman.freebsd.org> <20051007062537.707f4da3.trhodes@FreeBSD.org> <20051007121120.GC684@ip.net.ua> <200510121428.32781.jhb@freebsd.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="Pql/uPZNXIm1JCle" Content-Disposition: inline In-Reply-To: <200510121428.32781.jhb@freebsd.org> User-Agent: Mutt/1.5.9i X-Virus-Scanned: by amavisd-new at ip.net.ua Cc: Tom Rhodes , Ceri Davies , src-committers@freebsd.org, cvs-all@freebsd.org, cvs-src@freebsd.org Subject: Re: cvs commit: src/share/man/man4 an.4 ath.4 aue.4 awi.4 axe.4 bfe.4 bge.4 cdce.4 cm.4 cue.4 dc.4 de.4 ed.4 em.4 en.4 fwe.4 fwip.4 fxp.4 hme.4 ipw.4 iwi.4 kue.4 lge.4 my.4 nge.4 nve.4 pcn.4 ral.4 re.4 rl.4 rue.4 sf.4 sis.4 sk.4 sn.4 ste.4 ti.4 tl.4 tx.4 txp.4 ... X-BeenThere: cvs-src@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 12 Oct 2005 19:33:44 -0000 --Pql/uPZNXIm1JCle Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Oct 12, 2005 at 02:28:26PM -0400, John Baldwin wrote: > On Friday 07 October 2005 08:11 am, Ruslan Ermilov wrote: > > On Fri, Oct 07, 2005 at 06:25:37AM -0400, Tom Rhodes wrote: > > > On Fri, 7 Oct 2005 08:56:44 +0100 > > > > > > Ceri Davies wrote: > > > > On Fri, Oct 07, 2005 at 02:32:16AM +0000, Tom Rhodes wrote: > > > > > trhodes 2005-10-07 02:32:16 UTC > > > > > > > > > > FreeBSD src repository > > > > > > > > > > Modified files: > > > > > share/man/man4 an.4 ath.4 aue.4 awi.4 axe.4 bfe.4 bge.4 > > > > > cdce.4 cm.4 cue.4 dc.4 de.4 ed.4 em.4 > > > > > en.4 fwe.4 fwip.4 fxp.4 hme.4 ipw.4 iwi.4 > > > > > kue.4 lge.4 my.4 nge.4 nve.4 pcn.4 ral.4 > > > > > re.4 rl.4 rue.4 sf.4 sis.4 sk.4 sn.4 > > > > > ste.4 ti.4 tl.4 tx.4 txp.4 udav.4 ural.4 > > > > > vge.4 vlan.4 vr.4 wb.4 wi.4 xe.4 xl.4 > > > > > share/man/man4/man4.i386 arl.4 cp.4 cs.4 cx.4 ep.4 ex.4 fe.4 > > > > > ie.4 lnc.4 ray.4 vx.4 > > > > > Log: > > > > > Work around an apparent mdoc(7) bug. > > > > > > > > What's the bug? You can only use .Nm once or something? > > > > > > > > Ceri > > > > > > DES has already followed up, Groff was inserting a line break > > > for some really stupid reason. So, I guess this is a good > > > work around. :) > > > > There's no bug (already told you about this when Marius noticed). > > This is an intended behavior. The .Nm macro is special while in > > the SYNOPSIS section: it starts a new line and it sets up the > > indentation level to point after itself, to make the following > > > > work: > > : SYNOPSIS > > : install [-bCcMpSsv] [-B suffix] [-f flags] [-g group] [-m mode] > > : [-o owner] file1 file2 > > : install [-bCcMpSsv] [-B suffix] [-f flags] [-g group] [-m mode] > > : [-o owner] file1 ... fileN directory > > : install -d [-v] [-g group] [-m mode] [-o owner] directory ... > > > > Here, there are three synopses, so every .Nm asserts a new line. > > The indentation is set so that "[-o owner] ..." starts properly > > indented (to the length of "install" plus one space). > > > > The indentation is only set once, as can be demonstrated by the > > > > following example: > > : SYNOPSIS > > : hexdump [-bcCdovx] [-e format_string] [-f format_file] [-n lengt= h] > > : [-s skip] file ... > > : hd [-bcdovx] [-e format_string] [-f format_file] [-n length] [-s > > : skip] file ... > > > > Cheers, >=20 > Sounds like synopsis is not the right section for this information (what= =20 > device it is in a kernel config or what module to load). >=20 It's been like this from the very beginning when -mdoc was born (I think in 1993). The .Cd macro was specially invented for documenting config(8) file directives in the SYNOPSIS section. It's just that that initially SYNOPSIS sections were very terse, and the current tendency is to be more chatty, using more markup, etc., and that sometimes conflicts with the features (some macros behave differently while in a certain section). Cheers, --=20 Ruslan Ermilov ru@FreeBSD.org FreeBSD committer --Pql/uPZNXIm1JCle Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (FreeBSD) iD8DBQFDTWP8qRfpzJluFF4RAjFGAJ9rsy0FV9XXRScV4/R9D8nDL3nM7wCggMVP AWJohKyfnDUNTrYKA4J4fno= =Iwj9 -----END PGP SIGNATURE----- --Pql/uPZNXIm1JCle--