Manual:  http://www.gnu.org/software/texinfo/manual/texinfo/html_node/index.html

LIMITATIONS
-----------
Can not nest set's.
Sets seem to be evaluated once before anything else, so you can't use a
variable and then change it (i.e., variables are not "variable").
You can't nest many things because it kills the tex processor, e.g.
can't hava "strong{ ... enumerate{...", etc.
My version requires @ifnottex around the Top node definition, so you
can not use @ifinfo there.  The result is, the title is duplicated in 
the top node in HTML format.

Does not handle Gif files, due to copyrights.

Source files: *.texi
texi -> info:  makeinfo file.texi
texi -> html:  makeinfo --html file.texi
texi -> dvi:   ??
texi -> pdf:  texi2dvi --pdf file.texi


URLS
----
@uref{http://blah/blah}
@uref{http://blah/blah, text-to-show} # But Info also shows the raw URL
@uref{http://blah/blah,, text-to-show}

IMAGES
------
@image{filename, [width], [height], [alttext], [extension]}
HTML output:
    Can handle .png, .jpg, .xpm.   Default: .png then .jpg by default.
TeX output:
    .eps
PDFTeX output?:
    .pdf
width and height are given with TeX units like "1in".
Can't use underscores in image file names.

HTML output
-----------

Makes a subdir.
Main page is index.html.
The index for the document is Index.html.

LINES
---------
@*  Linebreak
sp 2   2 Blank lines

HYPHENS
-------
---

LITERALS
--------
You must enter @@, @{, @} to see @, {, } in the output.


PROBLEMS
--------
Paragraphs with indented first line are usually inappropriate for tech
docs, so I don't know why they don't have the default "@paragraphindent none".
With that setting, examples are not indented at all in HTML, but are
indented in info.  :(.  So must manually indent all examples and variants.


.texi file
----------
Insert @, {, and } like @@, @{, @}.
Sample:

\input texinfo
@c This is a comment line
@comment This too.
@ignore
This is a block
comment.
@end ignore
@c The start/end-of lines are required for any condl. Tex/Info processing
@c %**start of header
@setfilename filename.info
@settitle    The Title
@paragraphindent none
@c %**end of header

@c This section only for printed output
@titlepage
@title  Sample Title
@end titlepage
@c Print TOC.  Definitely used for Tex and for HTML output.
@contents

@ This section for info output
@ifnottex
@c @node arg is the node Name
@node Top
@top  Top Node Title
This is some text that goes in
the Top node.
@end ifnottex
@menu
* First Section::  Title for the
                   first section.
@end menu

@c  MAIN BODY ********************************************************
@node Node Name
@chapter Node Title

Some text that will go
in the first chapter.

Here is a numbered list
@enumerate
@item
First item here.
@item
Second item here
@end enumerate.

For unnumbered list, do same exact thing but use "itemize" in place of 
"enumerate".

@c @table is really just for an list with keys
@table @samp
@item keyword
Remainder of record.
@end table

@c Real tables
@multitable @columnfractions .1 .1 .1 .1 .1
@c OR @multitable {col1 prototype} {col2 prototype} {col3 prototype}
@c Must have col specifiers > @tab's.  Entirely ignored for HTML output.
@item col1 text @tab col2 text
@tab col3 text
@end multitable

@c  ******************************************************************

@bye


To embed HTML, use
@html
    <SPAN style='color:green'>HTML with tags and stuff</SPAN>
@end html


FUCKING @verbatim and @verbatiminclude DO NOT WORK!!!