2. Is the texinfo node in some sort of a circular buffer?
Carl: it looks to me that Kannan found a bug in this edition.
File: texinfo, Node: Point Glyph erroneously points back to
File: texinfo, Node: result
Kannan, use your next, previous and up keys to navigate out of this loop.
1. I have been wondering about the possibility of creating some user
documents using texinfo.
Good idea. It provides for different output formats from one source
file. This is very helpful.
Not to mention also that Info is more efficient than other on-line
documention formats, because it provides easy navigation and good
searching throughout the document (unlike, for example, HTML, which is
very inefficent to use).
But when I went through the manual on
texinfo using info, I found that I may have to learn quite a bit.
Not true. Most of what you see is `boiler plate' -- stuff you
copy to the beginning of a file from some other document, and then
change the title for your document.
Although I use LaTeX extensively, I haven't used TeX at all.
Fortunately, Texinfo is not TeX and you don't have to learn TeX.
Is there an easy way for someone who knows LaTeX well to learn
texinfo quickly...
It is somewhat similar to LaTeX, but designed for different outputs:
on-line, character-only, typeset print, HTML. LaTeX is limited to
typeset output (we tried to adapt it to Info, but LaTeX turned out to
be too typesetter oriented for that to work)
You knowledge of LaTeX will transfer over pretty well.
I do recommend the Texinfo Manual! :) Just browse through it get some
sense of what is there. (I myself would either buy a copy of the
printed version or print it out, but some people prefer to read it in
Info.)
Mainly, you need to learn the following commands:
@node Not like any command in LaTeX
@chapter Like LaTeX
@section Like LaTeX
@cindex I cannot remember how close this is to LaTeX
@xref I cannot remember how close this is to LaTeX
Also, I recommend printing all your output using @smallbook, even on
A4 paper. Looks nicer.
Best wishes.
--
Robert J. Chassell [EMAIL PROTECTED]
Rattlesnake Enterprises http://www.rattlesnake.com
Here is a sample Texinfo file. Note the boiler plate at the
beginning. (I have left out the stuff for a printed title page; see
the manual; it is all there.)
I do encourage you to learn Texinfo mode in GNU Emacs; it really helps.
\input texinfo @c -*-texinfo-*-
@comment %**start of header
@setfilename t1.info
@settitle T1
@smallbook
@comment %**end of header
@comment node-name, next, previous, up
@node top, Chapter One, (dir), (dir)
@ifinfo
@top Test Top
@end ifinfo
@menu
* Chapter One::
* Chapter Two::
@end menu
@comment node-name, next, previous, up
@node Chapter One, Chapter Two, top, top
@chapter Chapter One
Contents of chapter 1.
@cindex foobar
The quick brown fox jumps over the lazy dog.
@xref{Chapter Two}.
@comment node-name, next, previous, up
@node Chapter Two, , Chapter One, top
@chapter Chapter Two
Contents of chapter 2
@cindex bar
The lazy dog opened an eye.
@menu
* Section TwoA::
* Section TwoB::
@end menu
@comment node-name, next, previous, up
@node Section TwoA, Section TwoB, Chapter Two, Chapter Two
@section SectionTwoA
Contents of Section 2A
@comment node-name, next, previous, up
@node Section TwoB, , Section TwoA, Chapter Two
@section Section TwoB
Contents of Section 2B
@bye
