[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Tinycc-devel] [PATCH] [0/2] tcc-doc.texi proper formating, spelling
Re: [Tinycc-devel] [PATCH] [0/2] tcc-doc.texi proper formating, spelling fixes
Thu, 06 Mar 2003 13:56:42 +0100
Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.1) Gecko/20020828
Thank you for the documentation patches - I'll apply them.
Peter "Firefly" Lund wrote:
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
The following commands all work now:
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.
PS: I hated texinfo before I did this -- now I hate it even more. Does
anybody have real strong feelings about any particular markup
"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.
Tinycc-devel mailing list