<quote who="Paul Cameron">
> How do you embed images into your PS or PDF files? How do you use
> stylesheets from, say, the LDP or the FreeBSD doc project ? What's the
> difference between print and html documentation ? Automatic indexing ??
> How does one do that ?!
http://docbook.org/
There's an entire book (calledd "documentation") available for Free that
will describe these things. There are also many HOWTOs and guides that will
lead you through manual installation to customising your stylesheets.
> What happens when, say, your resulting document ends up looking like utter
> crap? What went wrong? Do you understand how the convoluted tool chain
> works ? For PDF, How are you converting it? Directly to it using an XML
> transformation engine, via TeX to DVI to PDF (thrice, it takes three
> iterations to generate proper versions, it just does ...) using
> pdfjadetex? Your index is malformed, why is that ?
>
> Riddle me that, oh Martin who's worth $65k fresh out of university
Wait, wait, I know this one... You can learn to use your tools!
> Or, you can just use something more comfortable, like Abiword or
> OpenOffice for your important extensive company documentation projects.
> Or not.
LyX has fine Docbook support. I seem to recall you recommending Word for
"important extensive company documentation projects". Word does not cut it
for serious documentation efforts.
> I like DB. I just wish it were a little easier.
It is quite simple. I didn't have much trouble with manual installation when
I had to do it. If you don't need to customise your stylesheets, and you're
using SGML, you needn't learn DSSSL. You can easily install stylesheets from
other projects (Gnome and FreeBSD have good ones), and you can always use
XML and the XSL stylesheets.
Surely someone writing documentation is familiar with the custom of actually
reading it?
- Jeff
-- [EMAIL PROTECTED] ------------------------------- http://lwn.net/daily/ --
Two words: Japanese technofetishism.
--
SLUG - Sydney Linux User Group Mailing List - http://slug.org.au/
More Info: http://slug.org.au/lists/listinfo/slug
