[conspire] Debian documentation in DocBook format

Ruben Safir ruben at mrbrklyn.com
Tue Sep 9 21:54:03 PDT 2008

On Tue, Sep 09, 2008 at 09:36:32PM -0700, Ken Bernard wrote:
> Hello all -
> Questions:
> Is Debian using DocBook as a format for its Documentation?
> How is that format opened?
> I am finding that the manuals I would like to access are in
> DocBook XML format. When I tried to view them I found out that
> I need to install OpenJade. The DocBook and the OpenJade
> install HOWTO's have a laundry list of other packages that are
> needed.

Sometimes you just get so fustrated with this stuff that you just wish
everything was in ascii.

I've really come to hate xml.


> http://tldp.org/HOWTO/text/DocBook-OpenJade-SGML-XML-HOWTO
>   <http://tldp.org/HOWTO/text/DocBook-OpenJade_SBML-XML-HOWTO>
> Is using DocBook now official on the part of the Debian distro
> documentation? If so,
> is there a single app. that will open this format? (Browsers return an XML
> file error)
> I got the (above) impression from the README in the manual I tried to open:
> http://packages.debian.org/lenny/installation-guide-i386
> "Here is the new manual. It is in DocBook XML format, which is
> becoming the new standard for documentation. The advantages include
> more precise tagging, figure and table support, and a very strongly
> supported toolchain. There is a fairly brief cheatsheet.xml here which
> will probably tell you all you need to know, especially if you've
> worked with debiandoc before. The Definitive Guide to DocBook by Norm
> Walsh is indispensable for figuring out why your tags don't work the
> way you think they should:
> http://www.oreilly.com/catalog/docbook/chapter/book/docbook.html
> For more information about the manual, see:
> http://d-i.alioth.debian.org/manual/
> All help is welcome! Send suggestions to the debian-boot list. Patches
> can be submitted against the package installation-guide.
> Last update: 09 July 2006"
> Ken Bernard

> _______________________________________________
> conspire mailing list
> conspire at linuxmafia.com
> http://linuxmafia.com/mailman/listinfo/conspire

http://www.mrbrklyn.com - Interesting Stuff
http://www.nylxs.com - Leadership Development in Free Software

So many immigrant groups have swept through our town that Brooklyn, like Atlantis, reaches mythological proportions in the mind of the world  - RI Safir 1998

http://fairuse.nylxs.com  DRM is THEFT - We are the STAKEHOLDERS - RI Safir 2002

"Yeah - I write Free Software...so SUE ME"

"The tremendous problem we face is that we are becoming sharecroppers to our own cultural heritage -- we need the ability to participate in our own society."

"> I'm an engineer. I choose the best tool for the job, politics be damned.<
You must be a stupid engineer then, because politcs and technology have been attached at the hip since the 1st dynasty in Ancient Egypt.  I guess you missed that one."

© Copyright for the Digital Millennium

More information about the conspire mailing list