From: Gennadiy Rozental (rogeeff_at_[hidden])
Date: 2008-07-23 15:54:38


Paul A Bristow <pbristow <at> hetp.u-net.com> writes:

>
>
> >-----Original Message-----
> >From: boost-bounces <at> lists.boost.org
> >[mailto:boost-bounces <at> lists.boost.org] On Behalf Of Gennadiy Rozental
> >Sent: 23 July 2008 18:38
> >To: boost <at> lists.boost.org
> >Subject: Re: [boost] [test] documentatation on patmedia.net
> >disappeared,not up to date on boost.org
> >
> >Ilya Sokolov <fal_delivery <at> mail.ru> writes:
> >> Could you at least check in html documentation only, without
> >sources?
> >
> >I think I'll do just this.
>
> OK - this is a great help - but long-term can we find someone who is willing
to rewrite the whole document in
> Quickbook?

1. I don't think it's possible. Even BoostBook is not able to handle what I
need. I've got bunch of xsl scripts built on top and I had to make core changes
in BoostBook itself (not very big, but significant).

2. We've been through this discussion before. I need to be able to support the
documentation. And I am not looking forward learning yet another documentation
format or yet another tool that produces my format. All in all I do not see
advantages in using quickbook.

> The docs can then link directly to the examples, and perhaps include
> new examples.

Examples support in Boost.Test docs is much more sophisticated. Resulting html
includes code, output, source and annotation (not yet fully functional)

Gennadiy