Re: [Groff] Request "cf"

[Werner LEMBERG]

> The 1.19.2 edition of groff documentation presents the trf and cf
> requests for including files in diversions.

Yes, the wording is a bit unfortunate.

> The trf request works well, but it does some processing of its
> input.  The cf request is supposed to do the same as trf except it
> would not process its input in any way.  Unfortunately cf does not
> seem to do a thing.

It does:

file foo:

  ***A***
  ***B***

file foo.tr:

  ***1***

  .di bar
  ***2***
  .cf foo
  ***3***
  .br
  .di

  ***4***

  .bar

  ***5***


now troff -Tascii foo.tr gives:

  ...
  t***1***
  n40 0
  V160
  H0
  t***4***
  n40 0
  V200
  H0
  ***A***
  ***B***
  x font 1 R
  f1
  s10
  V240
  H0
  t***2***
  wh24
  t***3***
  n40 0
  V320
  H0
  t***5***
  ...

Perhaps it's helpful to think that, within a diversion, each line of a
file inserted with .cf is handled as if it was preceded with `\!\\!'.

I'll add this to the documentation.


    Werner