long boring editorial PATCH for tm.texi

[Zack Weinberg]

Formerly, there were only macros described in tm.texi, and every
section of this part of the manual had a table (@table @code) to
define its macros.  Since we've been converting to target hooks, a new
style has arisen: use of @deftypefn / @deftypevr to describe target
hooks.  This leads to an odd mishmash of visual format, in a section
that has both hooks and macros.

Therefore the attached seven-thousand-line patch for tm.texi changes
almost the entire file to use @defmac for macros, instead of tables.
There are a handful of exceptions, where the visual style of @defmac
seems grossly inappropriate, such as the description of target escape
sequences.  In the process I found and corrected a number of errors -
mostly formatting, e.g. putting a macro argument list on a @findex
line instead of the corresponding @item.  However, there are a handful
of content changes in here too, which I hope are unobjectionable.

Tested by 'make info' and 'make gccint.dvi'.  One is disappointed to
report that each of these catches a different set of errors.  I also
skimmed through the TeXed output in xdvi.

zw

        * doc/tm.texi: Uniformly use @defmac for macros, rather than
        @table items.  Minor formatting and editorial corrections.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: tm.texi-use-defmac.diff.gz
Type: application/octet-stream
Size: 68927 bytes
Desc: not available
URL: <http://gcc.gnu.org/pipermail/gcc-patches/attachments/20030620/578b569a/attachment.obj>