Re: [boost] Boost documentation

From: Rene Rivera (grafikrobot_at_[hidden])
Date: 2007-06-24 21:06:35

Joel de Guzman wrote:
> Why? some people, do not like the elaborate tool chain that
> Doc/BoostBook requires. Some parts of the tool chain, e.g. FOP,
> is severely broken, XSLT is so slow and difficult to understand
> and maintain, etc. DocBook is not perfect, you know. It too has
> its own sets of problems.

I would be one of those people. So blame be if you must. And if it 
wasn't clear before... I hate XSTL. IMO it is one of the worse 
programming languages ever invented. But this is probably off-topic ;-)

> A boost/docbook backend will still be supported, for sure.

Indeed. I am, personally since i"m the oen doing the changes to 
Quickbook for plugable backends, to make Quickbook more flexible in this 
respect. First, to make the maintenance of the XML generation much 
simpler and easier. Second, to guard against future document format 
changes. After all someone might decide DocBook is silly and switch to 
something else, at which point I'd rather rewrite the quickbook 
generator than all my documentation. And last, for my won personal 
interest in using Quickbook to generate web pages, RSS feeds, etc. on 
the fly.

-- 
-- Grafik - Don't Assume Anything
-- Redshift Software, Inc. - http://redshift-software.com
-- rrivera/acm.org - grafik/redshift-software.com
-- 102708583/icq - grafikrobot/aim - grafikrobot/yahoo