[Groff] Re: artifacts due to ".TS H" usage

[Werner LEMBERG]

[I'm CCing this to the groff list since I want to hear opinions from
others.]

[The question is whether .LP should be allowed in .DS/.DE or not; the
display is used to hold a grap image.]

> It turns out that, by changing ".LP" to ".br", I can get groff to
> stop complaining.  This is (a) a usable workaround and (b) an
> indication of the nature of the problem.

Well, the problem is that this:

  .DS
  .LP
  .DE

causes an error.

>From groff_ms.man:

  Use displays to show text-based examples or figures (such as code
  listings).  Displays turn off filling, so lines of code can be
  displayed as-is without inserting `br' requests in between each
  line.  [...]

The original ms documentation says:

  To prepare displays of lines, such as tables, in which the lines
  should not be re-arranged, enclose them in the commands .DS and .DE

A grap figure isn't text-based, isn't it?  And using .LP actually does
rearrange lines into a paragraph shape...

What you should do instead is

  .RS
  .KS
  <grap figure together with caption>
  .KE
  .RE

Since the old UNIX ms macros accept .LS within .DS/.DE, I wonder
whether we shall emulate that by temporarily mapping all paragraph
commands to `.br', emitting a proper warning message...


    Werner