Re: [Groff] Using real tables in groff_mdoc(7)

[Ruslan Ermilov]

Eric,

On Sat, Aug 11, 2012 at 08:16:26AM +0200, Werner LEMBERG wrote:
> [I'm moving the discussion to address@hidden, and CCing Ruslan Ermilov,
> since this is the better place to discuss such issues.]

Now that you've committed a TBL change to groff_mdoc.man,
I looked at the diffs in the resulting -Tascii documents,
and the results were not satisfactory:

1) many indents have disappreared, e.g.:

: Under FreeBSD 9.1, the following sections are defined:
: 
: -                  1        FreeBSD General Commands Manual
: -                  2        FreeBSD System Calls Manual
: -                  3        FreeBSD Library Functions Manual
: -                  4        FreeBSD Kernel Interfaces Manual
: -                  5        FreeBSD File Formats Manual
: -                  6        FreeBSD Games Manual
: -                  7        FreeBSD Miscellaneous Information Manual
: -                  8        FreeBSD System Manager's Manual
: -                  9        FreeBSD Kernel Developer's Manual
: +            1   FreeBSD General Commands Manual
: +            2   FreeBSD System Calls Manual
: +            3   FreeBSD Library Functions Manual
: +            4   FreeBSD Kernel Interfaces Manual
: +            5   FreeBSD File Formats Manual
: +            6   FreeBSD Games Manual
: +            7   FreeBSD Miscellaneous Information Manual
: +            8   FreeBSD System Manager's Manual
: +            9   FreeBSD Kernel Developer's Manual

Adding ".Bd -ragged -offset indent" seems to fix these.

2) In the PREDEFINED STRINGS section, there's now an undesired empty
string before "greek pi":

: PREDEFINED STRINGS
:      The following strings are predefined:
: 
:      String   Nroff      Troff      Meaning
:      <=       <=         <=         less equal
:      >=       >=         >=         greater equal
:      Rq       ''         ''         right double quote
:      Lq       ``         ``         left double quote
:      ua       ^          ^          upwards arrow
:      aa       '          '          acute accent
:      ga       `          `          grave accent
:      q        "          "          straight double quote
: 
:      Pi       pi         pi         greek pi
:      Ne       !=         !=         not equal
:      Le       <=         <=         less equal
:      Ge       >=         >=         greater equal
:      Lt       <          <          less than
:      Gt       >          >          greater than
:      Pm       +-         +-         plus minus
:      If       infinity   infinity   infinity
:      Am       &          &          ampersand
:      Na       NaN        NaN        not a number
:      Ba       |          |          vertical bar

Adding "nokeep" seems to cure the problem, but I'm not sure
it's a valid fix (mainly for compatibility reasons).

It'd be nice if you could take a closer look at these minor
formatting issues.  :)