Re: [Boost-build] B2 documentation..

Subject: Re: [Boost-build] B2 documentation..
From: Rene Rivera (grafikrobot_at_[hidden])
Date: 2017-08-09 00:22:04

On Tue, Aug 8, 2017 at 11:46 AM, Robert Ramey via Boost-build <
boost-build_at_[hidden]> wrote:

> On 8/8/17 5:23 AM, Rene Rivera via Boost-build wrote:
>
>> .
>> * Limited to BoostBook output. Which limits it to the BoostBook XSLT.
>> Which limits it to one style of documentation.
>>
>
> Hmmm - I would say the opposite.  That is the BoostBook -> Docbook permits
> one to de-couple the content from the format so that one can generate
> output as html pages, pdf, ebook.  I have done all of these with the
> system.  One can also use xslt to tweak the output to taste. It IS a pain
> in the neck.  But it can do anything and once it's working it's quite
> reliable.

True.. But I obviously meant that it can't generate anything else by
itself. Having options of backend toolchains is an important attribute.
Having the docbook toolchain be the only option is aggravating. I.e. having
options is nice.

* No support for fun things like diagrams.
>> * No easy way to extend it.
>> * Limited languages for syntax styling.
>>
>
> Since quickbook generates boostbook I would expect that trying to specify
> formats with quickbook would not be a productive endeavor.
>

I don't see how that relates to those three points.

-- 
-- Rene Rivera
-- Grafik - Don't Assume Anything
-- Robot Dreams - http://robot-dreams.net
-- rrivera/acm.org (msn) - grafikrobot/aim,yahoo,skype,efnet,gmail