Re: [Boost-docs] HTML version of documentation - Store using SVN or leave users to build

Subject: Re: [Boost-docs] HTML version of documentation - Store using SVN or leave users to build
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2011-09-07 17:57:29

> -----Original Message-----
> From: boost-docs-bounces_at_[hidden] [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of
> Daniel James
> Sent: Wednesday, September 07, 2011 12:44 PM
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] HTML version of documentation - Store using SVN or leave users to build
> 
> On 7 September 2011 12:25, Paul A. Bristow <pbristow_at_[hidden]> wrote:
> >
> > Well I noted that many people seemed to be doing something like that,
> > but it seemed a most untidy solution, when the main project files are
> > in Boost-sandbox.  And a hassle, for the author and readers?
> 
> Why is that a hassle for the reader?

Well unpacking a zip file is a (tiny) bit of a hassle, compared to a simple click.

> I find that redirect files work fine, e.g. 
> https://svn.boost.org/svn/boost/trunk/libs/geometry/index.html

OK, I'll try to use Sourceforge, and redirect to this.
 
> I find storing generated files in version control more of a hassle myself.

Indeed :-(

> > Would a zip of the html docs be better?
> 
> You should be including the documentation in the zipfile.

And I'll add built docs to a zipfile too.

Thanks

Paul

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