Re: [Boost-docs] [quickbook][boostbook] CSS & image files

Subject: Re: [Boost-docs] [quickbook][boostbook] CSS & image files
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2010-06-27 17:00:17

> -----Original Message-----
> From: boost-docs-bounces_at_[hidden] [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of Daniel James
> Sent: Thursday, June 17, 2010 4:22 PM
> To: Discussion of Boost Documentation
> Subject: [Boost-docs] [quickbook][boostbook] CSS & image files
> 
> At the moment we have copies of the css and image files for boostbook
> in doc/html and doc/src which is a bit messy. I'd like to remove one
> of these. I'd prefer to remove the files under html, so that directory
> would only contain the generated documentation.
> 
> This means going through all the documentation and fixing anything
> which refers to the files in doc/html (mostly just changing build
> settings). Sorting this out with all the library maintainers would be
> a pain, so I'm just going to go ahead and do it in a few days time.
> For documentation which has been checked in, I'll rebuild it some time
> before the beta if it hasn't been already.

This sounds a very good idea, and thanks for doing it.

You might also like to consider how to make it easier for users to chose their own boostbook.css to get their choice of
syntax coloring - my reaction to the current is yuk ;-)  (and perhaps their own images too).

And it doesn't seem entirely logical that /doc/pdf contains a jamfile for building pdf, but the jamfile for html is at
/doc/

but maybe that's the way it is ...

Paul

---
Paul A. Bristow
Prizet Farmhouse
Kendal, UK   LA8 8AB
[phone], mobile [phone]
pbristow_at_[hidden]