Manual pages conventions

[Marc Fonvieille]

On Thu, Jun 09, 2005 at 06:18:35PM +0200, Jeremie Le Hen wrote:
> Hi,
> 
> (please include me in replies, I've not subscribed to this list)
> 
> I'm writing a manual page but I can't find any documentation on rules
> or conventions that must be applied.  First I would simply like to
> know where I can find a FreeBSD groff macros reference.  For what I
> saw on the Net, .Nm, .Xr, and so on are not standards (I'm really not
> a groff guru, not even a novice to be honest).
> 
> I had a look at the rc.conf(5) manpage since my project is pretty tied
> to the latter.  I more or less understood that, for instance, .Xr is
> used to reference another manual page, but I don't know when I should
> use .Xr (manual page reference) and when .Pa (path) would be better.
> 
> I would be grateful if someone give me some pointers or some
> explanations.
>

mdoc(7)

Marc
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20050609/400ace8d/attachment.sig>