From owner-freebsd-doc Tue May 23 19:22:29 2000 Delivered-To: freebsd-doc@freebsd.org Received: from praseodumium.btinternet.com (praseodumium.btinternet.com [194.73.73.82]) by hub.freebsd.org (Postfix) with ESMTP id A81DE37BB4E for ; Tue, 23 May 2000 19:22:23 -0700 (PDT) (envelope-from mark@ukug.uk.freebsd.org) Received: from [213.1.164.88] (helo=parish.my.domain) by ruthenium.btinternet.com with esmtp (Exim 2.05 #1) id 12uIr4-00076T-00; Tue, 23 May 2000 18:52:35 +0100 Received: (from mark@localhost) by parish.my.domain (8.9.3/8.9.3) id SAA01051; Tue, 23 May 2000 18:48:32 +0100 (BST) (envelope-from mark) Date: Tue, 23 May 2000 18:48:31 +0100 From: Mark Ovens To: Mike Pritchard Cc: Nicola Vitale , doc@freebsd.org Subject: Re: Question about mdoc formatting Message-ID: <20000523184831.B233@parish> References: <20000521164932.A236@parish> <20000523093303.A11021@mppsystems.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <20000523093303.A11021@mppsystems.com>; from mpp@mppsystems.com on Tue, May 23, 2000 at 09:33:03AM -0500 Organization: Total lack of Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, May 23, 2000 at 09:33:03AM -0500, Mike Pritchard wrote: > On Tue, May 23, 2000 at 03:51:45PM +0200, Nicola Vitale wrote: > > > [Mark Ovens, 21/05/00] > > > How do you force a newline in mdoc? > > > > .br > > No, don't use *roff formatting directives directly within -mdoc > style man pages. > > The .Pp macro will generate a line break, as well as an empty line, > which may not be what you want. > > > So in your > > > > > Example: > > > > > > .It Ev DEF_BUILD_DIR > > > If set, is used as the path of the build directory instead of > > > .Pa /usr/src/sys/compile . > > > It can be overridden by the > > .br > > > .Fl d Ar destdir > > > option. > > I would suggest something like this (untested): > > .It Ev DEF_BUILDER_DIR > If set, is used as the path of the build directory instead of > .Pa /usr/src/sys/compile > It can be overridden by the > .Dq Fl d Ar destdir > option. > > > This should generate something like: > > DEF_BUILDER_DIR If set, is used as the path of the build > directory instead of _/usr/src/sys/compile. > It can be overridden by the ``-d destdir'' option. > > Nah, it didn't work. It used double quotes, but still wrapped the same. I guessed that there wasn't a direct solution, after all inserting a line-break that is correct in an 80-column window would be wrong in a 90-column, even though FreeBSD manpages format to 80 even if the window is bigger. I suppose what is really needed is for .Fl d Ar destdir to use a non-breaking space between the flag and the arg. In this case I'll just stick the extra word in. Thanks for the help. > -Mike > -- > Mike Pritchard > mpp@FreeBSD.org or mpp@mppsystems.com > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-doc" in the body of the message -- ...and on the eighth day God created UNIX ________________________________________________________________ FreeBSD - The Power To Serve http://www.freebsd.org My Webpage http://ukug.uk.freebsd.org/~mark/ mailto:mark@ukug.uk.freebsd.org http://www.radan.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message