Hi,

Franco Fichtner wrote on Fri, Jul 12, 2013 at 03:42:58PM +0200:
> On Jul 12, 2013, at 3:16 PM, Jason McIntyre <[email protected]> wrote:
>> On Fri, Jul 12, 2013 at 02:04:03PM +0200, Jan Stary wrote:

>>> Authors' emails in manpages are generally written as .e.g.
>>>
>>>       .An Damien Miller Aq [email protected]
>>>
>>> Should these be like
>>>
>>>       .An Damien Miller Aq Mt [email protected]

>> perhaps. either Mt is fairly new,

The first implementation i could find so far was committed to the
groff CVS on March 23, 2001, and it was released with groff 1.17
on May 2, 2001.  I can't exclude it appeared earlier elsewehere.
Neither the final CSRG code nor Heirloom troff appear to support .Mt,
though.

>> or i never noticed it before. we could
>> wholesale change stuff, but haven;t yet.

I think i'd like that, even though we would have to touch large
numbers of pages.  I'd indeed prefer the following style,
using pkg-config(1) as an example:

  .Sh AUTHORS
  .Nm
  was written by
  .An Chris Kuethe Aq Mt [email protected]
  as a replacement for the original freedesktop.org
  .Nm
  implementation.
  It was later extended and kept in sync (where relevant)
  with the original version by
  .An Marc Espie Aq Mt [email protected]
  and
  .An Jasper Lievisse Adriaanse Aq Mt [email protected] .

Note that so far, the mandoc manuals themselves use just `Mt'
and not `Aq Mt', but i think `Aq Mt' reads better and i should
probably change the mandoc manuals, too.

>> it probably does make sense for
>> folks who want stuff like html pages.

Exactly.

>> i did add an Mt fairly recently, but there can;t be many in tree.

> Looks like this is almost exclusively used in mandoc/mdocml for most
> BSDs.  Apparently nobody got the memo.  ;)

Maybe, but groff has been supporting it for a long time and that was
the de-facto reference implementation of mdoc(7) before mandoc was
written.

So i think it's just that nobody did the work of adding the markup, yet.

Yours,
  Ingo

Reply via email to