discuss@mandoc.bsd.lv
 help / color / mirror / Atom feed
From: Ingo Schwarze <schwarze@usta.de>
To: discuss@mdocml.bsd.lv
Cc: "Anthony J. Bentley" <anthonyjbentley@gmail.com>
Subject: Re: Unknown macros: .ti, .ce, .fc, from nmh
Date: Sun, 27 May 2012 17:00:48 +0200	[thread overview]
Message-ID: <20120527150047.GD30@iris.usta.de> (raw)
In-Reply-To: <4f95afb8.c3043c0a.5b0d.ffffb8eb@mx.google.com>

Hi Anthony,

Anthony J. Bentley wrote on Mon, Apr 23, 2012 at 01:38:28PM -0600:

> nmh (in OpenBSD, FreeBSD, and pkgsrc as mail/nmh) has some manpage
> macros that mandoc doesn't know:
> 
> mandoc -Tlint:
> repl.1:97:2: ERROR: skipping unknown macro: .ti +3 
> repl.1:137:2: ERROR: skipping unknown macro: .ti +\w'In\-Reply\-To: 'u
> repl.1:151:2: ERROR: skipping unknown macro: .ti +\w'In\-Reply\-To: 'u
[...]
> mandoc -Tlint:
> slocal.1:130:2: ERROR: skipping unknown macro: .ce
[...]
> mandoc -Tlint:
> send.1:412:2: ERROR: skipping unknown macro: .fc ^ ~

Thanks for reporting!
I took a note in the TODO file,

  http://mdocml.bsd.lv/cgi-bin/cvsweb/TODO?cvsroot=mdocml

   - xloadimage(1) wants .ti (temporary indent), rep by naddy@
  +  reported again by bentley@ in nmh(1)  Mon, 23 Apr 2012 13:38:28 -0600
  +  also uses .ce (center N lines) and .fc (field control)

There is nothing wrong with reporting missing features multiple
times, it makes a difference for coding priorities whether one
or a hundred pages require a particular feature.

However, regarding the priorities in this particular case:

 - .ti is very low level (acting on a single output line)
   and doesn't fit well into the syntax tree concept,
   so the implementation is going to be ugly; besides,
   fortunately, it seems to be used rarely
 - same for .ce, which is even more ugly and even more rare
 - so both are not likely to get much priority
 - the very concept behind .fc is terribly complicated;
   besides, fine-tuning horizontal spacing in this way
   is not very useful in -Tascii mode, so i'd call the
   chances that we might implement .fc negligible

At least for now, mail/nmh must continue to USE_GROFF,
unless the upstream author decides to avoid mixing such
low-level roff(7) requests into his man(7) code, which is
likely to be easily feasible, but maybe not likely to happen.

Yours,
  Ingo

P.S.
Sorry that this answer took some time, but it didn't look that
urgent, and i was rather busy.
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv

      reply	other threads:[~2012-05-27 15:00 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-04-23 19:38 Anthony J. Bentley
2012-05-27 15:00 ` Ingo Schwarze [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20120527150047.GD30@iris.usta.de \
    --to=schwarze@usta.de \
    --cc=anthonyjbentley@gmail.com \
    --cc=discuss@mdocml.bsd.lv \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).