Node:Refilling Paragraphs, Next:Command Syntax, Previous:Catching Mistakes, Up:Top
The @refill command refills and, optionally, indents the first
line of a paragraph.1 The
@refill command is no longer important, but we describe it here
because you once needed it. You will see it in many old Texinfo
files.
Without refilling, paragraphs containing long @-constructs may look
bad after formatting because the formatter removes @-commands and
shortens some lines more than others. In the past, neither the
texinfo-format-region command nor the
texinfo-format-buffer command refilled paragraphs
automatically. The @refill command had to be written at the
end of every paragraph to cause these formatters to fill them. (Both
TeX and makeinfo have always refilled paragraphs
automatically.) Now, all the Info formatters automatically fill and
indent those paragraphs that need to be filled and indented.
The @refill command causes texinfo-format-region and
texinfo-format-buffer to refill a paragraph in the Info file
after all the other processing has been done. For this reason,
you can not use @refill with a paragraph containing either
@* or @w{ ... } since the refilling action will
override those two commands.
The texinfo-format-region and texinfo-format-buffer
commands now automatically append @refill to the end of each
paragraph that should be filled. They do not append @refill to
the ends of paragraphs that contain @* or @w{ ...}
and therefore do not refill or indent them.
Perhaps the command should have been
called the @refillandindent command, but @refill is
shorter and the name was chosen before indenting was possible.