From owner-cvs-share  Wed Mar 19 13:52:30 1997
Return-Path: <owner-cvs-share>
Received: (from root@localhost)
          by freefall.freebsd.org (8.8.5/8.8.5) id NAA23158
          for cvs-share-outgoing; Wed, 19 Mar 1997 13:52:30 -0800 (PST)
Received: (from mpp@localhost)
          by freefall.freebsd.org (8.8.5/8.8.5) id NAA15057;
          Wed, 19 Mar 1997 13:48:52 -0800 (PST)
From: Mike Pritchard <mpp>
Message-Id: <199703192148.NAA15057@freefall.freebsd.org>
Subject: Re: cvs commit:  src/share/examples/mdoc example.3
To: bde@zeta.org.au (Bruce Evans)
Date: Wed, 19 Mar 1997 13:48:51 -0800 (PST)
Cc: cvs-all@freefall.freebsd.org, CVS-committers@freefall.freebsd.org,
        cvs-share@freefall.freebsd.org
In-Reply-To: <199703192124.IAA06242@godzilla.zeta.org.au> from "Bruce Evans" at Mar 20, 97 08:24:16 am
X-Mailer: ELM [version 2.4 PL24]
Content-Type: text
Sender: owner-cvs-share@FreeBSD.ORG
X-Loop: FreeBSD.org
Precedence: bulk

Bruce Evans wrote:
> 
> >  Modified:    share/examples/mdoc  example.3
> >  Log:
> >  Update to use the .Rv macro now that I know it exists :-).
> 
> It doesn't seem to be well known :-).  (It was only used once in
> /usr/share/man, in atexit.3.)

I know :-).  It looks like it was added late in the game, along with a 
few other undocumented mdoc macros I discovered while poking around in 
the mdoc macros for some other reason.  It looks like .Rv was never 

The .An macro is the next one it looks like I'll document.  It is
used by 3 man pages :-).

Usage: .An author name

E.g:

.An Mike Pritchard .

Generates:

Mike Pritchard.

.An Mike Pritchard Aq mpp@FreeBSD.ORG .

Gives:

Mike Pritchard <mpp@FreeBSD.ORG>.

So that all of the "author" info is contained on one macro line.
I kinda like that format, since I was thinking about writing some type
of "author" macro myself to do just that.
-- 
Mike Pritchard
mpp@FreeBSD.org
"Go that way.  Really fast.  If something gets in your way, turn"