Date: Fri, 7 Oct 2005 15:11:20 +0300 From: Ruslan Ermilov <ru@FreeBSD.org> To: Tom Rhodes <trhodes@FreeBSD.org> Cc: cvs-src@FreeBSD.org, Ceri Davies <ceri@submonkey.net>, cvs-all@FreeBSD.org, src-committers@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 ... Message-ID: <20051007121120.GC684@ip.net.ua> In-Reply-To: <20051007062537.707f4da3.trhodes@FreeBSD.org> References: <200510070232.j972WGm9013102@repoman.freebsd.org> <20051007075644.GG99170@submonkey.net> <20051007062537.707f4da3.trhodes@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--xesSdrSSBC0PokLI Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Oct 07, 2005 at 06:25:37AM -0400, Tom Rhodes wrote: > On Fri, 7 Oct 2005 08:56:44 +0100 > Ceri Davies <ceri@submonkey.net> wrote: >=20 > > On Fri, Oct 07, 2005 at 02:32:16AM +0000, Tom Rhodes wrote: > > > trhodes 2005-10-07 02:32:16 UTC > > >=20 > > > FreeBSD src repository > > >=20 > > > Modified files: > > > share/man/man4 an.4 ath.4 aue.4 awi.4 axe.4 bfe.4 bge.4=20 > > > cdce.4 cm.4 cue.4 dc.4 de.4 ed.4 em.4=20 > > > en.4 fwe.4 fwip.4 fxp.4 hme.4 ipw.4 iwi.4=20 > > > kue.4 lge.4 my.4 nge.4 nve.4 pcn.4 ral.4=20 > > > re.4 rl.4 rue.4 sf.4 sis.4 sk.4 sn.4=20 > > > ste.4 ti.4 tl.4 tx.4 txp.4 udav.4 ural.4=20 > > > vge.4 vlan.4 vr.4 wb.4 wi.4 xe.4 xl.4=20 > > > share/man/man4/man4.i386 arl.4 cp.4 cs.4 cx.4 ep.4 ex.4 fe.4=20 > > > ie.4 lnc.4 ray.4 vx.4=20 > > > Log: > > > Work around an apparent mdoc(7) bug. > >=20 > > What's the bug? You can only use .Nm once or something? > >=20 > > Ceri >=20 > 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. :) >=20 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 length] : [-s skip] file ... : hd [-bcdovx] [-e format_string] [-f format_file] [-n length] [-s ski= p] : file ... Cheers, --=20 Ruslan Ermilov ru@FreeBSD.org FreeBSD committer --xesSdrSSBC0PokLI Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (FreeBSD) iD8DBQFDRmXnqRfpzJluFF4RAi5sAJ96uvYcsB/mrBTqQxBPNgfu6cQGIgCcD76d GTLHmVjBRD9at5r8/1oyAxQ= =8Q0H -----END PGP SIGNATURE----- --xesSdrSSBC0PokLI--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20051007121120.GC684>