Date: Thu, 25 May 2000 18:35:45 +0100 From: Mark Ovens <mark@ukug.uk.freebsd.org> To: Nicola Vitale <nivit@libero.it> Cc: Mike Pritchard <mpp@mppsystems.com>, doc@freebsd.org, sheldonh@freebsd.org Subject: Re: Question about mdoc formatting Message-ID: <20000525183544.A232@parish> In-Reply-To: <Pine.BSF.4.10.10005251011390.277-100000@numeria.libero.it>; from nivit@libero.it on Thu, May 25, 2000 at 02:01:36PM %2B0200 References: <Pine.BSF.4.10.10005251011390.277-100000@numeria.libero.it>
next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, May 25, 2000 at 02:01:36PM +0200, Nicola Vitale wrote:
> > [Mike Pritchard, 24/05/00]
> > > > No, don't use *roff formatting directives directly within -mdoc
> > > > style man pages.
> > > I didn't know. :-(
> >
> > No big deal. Better that you asked for advice first, right?
>
> Yes, I'm agree. But it would have been a great deal better
> if in -mdoc documentation there was written directly: "Using
> troff internal codes along with -mdoc macros is deprecated,
> or still better forbidden.", with this last word blinking! :-)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
...and the -mdoc macro for that is? ;-)
>
> > > .Bk -words
> > > Fl d Ar destdir
> > > .Ek
> >
> > I've never actually seen those macros used anywhere, so I'm not
> > sure if they work :-(.
>
> Well, I checked make(1) and it is used there.
>
> > >From the documentation, .Bk/.Ek sound like what you want. If they
> > don't work for you, why don't you send me the mdoc source of the man
> > page you are working on? Then I'll take a look and see if I can figure
> > out a work-around?
>
> Are you asking to me or Mark Ovens? I suppose Mark. _My_
> English doesn't let me to write any kind of documentation; I
> don't even know what I have exactly written in this message!
> Indeed! :-)
>
> Ciao
> --
> Nicola Vitale
> nivit@libero.it
>
>
>
>
>
>
> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000525183544.A232>