Michael -
On Sep 10, 11:08 pm, michael crane <[email protected]> wrote:
> so what is the way to view the document in all it's composed glory ?
As a long time user of Texinfo, I'd say
the question is not well defined. Please let me
explain why.
Texinfo as a file format is powerful enough
encode different output for different target
formats. The key point is that we can run
various translators on Texinfo source files to
produce for example
Info,
Plain text,
HTML, XML,
DVI, PS,
PDF, and
DocBook
documentation. Each of these can in theory
contain different contents, though they were
generated from the _same_ Texinfo source,
because we can select what gets processed with
so called "Conditional Commands". like, e.g.,
@ifhtml
...
@end ifhtml
or
@iftex
...
@end iftex
What looks like sheer exuberance at first glance
actually makes sense if you want e.g. to show a
graphic. It is easy to show it in HTML. With a
simple conversion it is as easy to include it in
the PostScript and PDF variants, too, but what
about the text based formats? Here, either your
generator program for the graphic helps you (as
e.g. Gnuplot does) or you have to draw corny
ASCII line art (which is done for all Fig-files
of the documentation).
Moreover, the freedom to select particular
presentations for a specific output translation
allows the savvy documentation author to optimize
the target representation. Mathematical
formulas in particular benefit from this
treatment.
So, to finally answer your question: In the
general case there is no one and only document
that represents a set of Texinfo files. And
this is a good thing.
> "man" shows some of it
> "info" shows some of it
> "perldoc" shows some of it but I forget the syntax
Some of my favorites are
- Acrobat for PDF
- Ghostview (and Evince) for PostScript
- pinfo and Emacs for Info
- Firefox for XML&MathML
Usually the PDF and the HTML/XML are the richest
target formats. It has been a larger effort to set up the
Enblend/Enfuse documentation with that much of
flexibility. Now you can choose your preferred format
and enjoy reading.
I hope I could clarify the issue.
Cheers,
Chris
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"hugin and other free panoramic software" group.
A list of frequently asked questions is available at:
http://wiki.panotools.org/Hugin_FAQ
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at http://groups.google.com/group/hugin-ptx
-~----------~----~----~----~------~----~------~--~---
