Re: problems in one or more man pages you maintain

[Werner LEMBERG]

> Problems with afmtodit.1:
> 
> 1. Macro definition is in a location (such as the Synopsis section)
> that confuses translation tools.

Already fixed in the CVS.

> 1. Unbalanced .RS or .RE macro

Uh, oh, you've sent me this about a month ago.  I wrote:

  ???  They *are* balanced!  The patch you give is plain wrong,
  changing the indentation incorrectly.  How did you came to the
  conclusion?

> Problems with gpic.1:
> 
> 1. List syntax error. This means .IP, .TP or .RS/.RE markup is
> garbled.  This confuses doclifter, and may also mess up stricter
> troff interpreters like groffer and TkMan.

I've answered this a month ago already:

  Again, the patch is wrong.  A few lines before your change the same

    .RS
    .IP
    ...
    .RE
    .IP

  constructs are used to increase indentation and to insert blank
  lines, and your script apparently doesn't complain there.

  It seems that you expect a certain markup order for .IP, .TP, .LP,
  and .RS/.RE.  I don't think that this is true.  As far as I know,
  the only valid assumption is that .RS and .RE should be paired.

> Problems with groff_mom.7:
> 
> 1. Unknown or invalid macro.  That is, one that does not fit in the
> macro set that the man page seems to be using.  This is a serious
> error; it often means part of your text is being lost or rendered
> incorrectly.

Sigh.  It seems that you haven't read the answers I'm sending to
you.  Two months ago I answered this:

  Hmm, this looks like a problem in your checking tool.  There is a
  proper definition of the TQ macro in groff_mom.7 (even at the right
  place, before the .TH line).

  BTW, I suggest that you add one or more empty lines between
  successive problem reports within a single mail.

I don't mind if I get repeated reports about problems not fixed in the
released groff versions.  But please don't ignore my answers!


    Werner