[Tinycc-devel] [PATCH] [0/2] tcc-doc.texi proper formating, spelling fixes

[Peter \"Firefly\" Lund]

The tcc-doc.texi had some stuff in it that wasn't proper texinfo.  The
most serious problem was that I couldn't generate postscript files from it
-- and when I hacked it to support those, most of the examples and pieces
of code came out wrong (all the curly braces disappeared).

The first patch contains formating fixes only.

The second patch (to be applied on top of the first) fixes some frenchisms
and typos.

The following commands all work now:
  texi2html tcc-doc.texi
  texi2dvi  tcc-doc.texi
  makeinfo  tcc-doc.texi
  makeinfo --html tcc-doc.texi
  makeinfo --xml  tcc-doc.texi
  makeinfo --docbook tcc-doc.texi

If you are viewing the .info file with pinfo (Przemek's info viewer --
much better than the GNU info viewer), you will notice that going back to
a previously visited node doesn't work.  pinfo will exit and make some
noises to the effect that it doesn't consider the file a valid info file.
As far as I can see that is a bug in pinfo (it needs a tag table in the
info file and makeinfo doesn't provide one unless the info file would be
so big that it gets split into several smaller files).  This can be fixed
either with a patch to pinfo or by invoking makeinfo with a special magic
parameter -- I haven't had time to fiddle with that yet, maybe tomorrow.

-Peter

PS: I hated texinfo before I did this -- now I hate it even more.  Does
anybody have real strong feelings about any particular markup
language?

"Of course, I'm not unbiased, but in my humble opinion, I've
 gotten close to something that I can be really proud of."
 -- Knuth on The Art of Computer Programming.