|
Boost : |
From: Paul A Bristow (pbristow_at_[hidden])
Date: 2007-06-25 11:53:35
>-----Original Message-----
>From: boost-bounces_at_[hidden]
>[mailto:boost-bounces_at_[hidden]] On Behalf Of Matias Capeletto
>Sent: 25 June 2007 15:34
>To: boost_at_[hidden]
>Subject: Re: [boost] Boost documentation
>
>On 6/25/07, Rene Rivera <grafikrobot_at_[hidden]> wrote:
>> Gennadiy Rozental wrote:
>> > "Rene Rivera" <grafikrobot_at_[hidden]> wrote in message
>> > news:467F1339.9050302_at_gmail.com...
>> >> Gennadiy Rozental wrote:
>> >>> "Matias Capeletto" <matias.capeletto_at_[hidden]> wrote in message
>> >>> news:e9b043a10706230826od2db317ic2cb90f1bfdb561_at_mail.gmail.com...
>> >>>> Also, compare the size of the docs source:
>> >>>>
>> >>>> Boost.Bimap docs in docbook: 1.1 MB
>> >>>> Boost.Bimap docs in quickbook: 0.3 MB
>
>> >> I would bet that even compressing a docbook file and
>> >> corresponding quickbook file would yield quickbook the winner.
>> >
>> > yes. I see ~30%. Again, what is the point of this comparison?
>>
>> Simple... That you *type* less when writing _Quickbook_, than when
>> writing with <emphasis role="underline">DocBook</phrase>
>> <emphasis>directly</emphasis>.
>
>[*That was my point]
AND it is not "Write-only" either - you can read it more easily too!
I think the weight of opinion is firmly behind keeping Quickbook as a favoured, but not exclusive, Boost docs tool.
Paul
--- Paul A Bristow Prizet Farmhouse, Kendal, Cumbria UK LA8 8AB +44 1539561830 & SMS, Mobile +44 7714 330204 & SMS pbristow_at_[hidden]
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk