Re: [Boost-docs] [1.35] Where to place PDF versions of docs?

Subject: Re: [Boost-docs] [1.35] Where to place PDF versions of docs?
From: Robert Ramey (ramey_at_[hidden])
Date: 2007-11-01 20:12:23

Here is what I would like to see:

for each library a directory structure like the following:

boost/
   libs/
      serialization/
          docs/
             html/
                Jamfile.v2 // maybe builds html from docbook
             pdf/
                Jamfile.v2 // maybe builds html  from docbook
             docbook/
                 Jamfile.v2 // maybe builds docbook from quickbooks
             quickbook/
                 // nothing to build - util someone makes meta-quikbooks or 
something

with the tar ball shipped with the html pre-built.

I would also like to see a simple, documented, reliable, procedure for 
building at least
the html from its generator(s).  So if I'm using SVN I could just generate 
all the html
on my local machine.

Robert Ramey

"John Maddock" <john_at_[hidden]> wrote in message 
news:00d501c81cb7$469e1fe0$83341b56_at_fuji...
> Folks I think we need to get organised with PDF's now that we have many 
> more
> libraries with quickbook/boostbook docs.
>
> I don't particularly want these in SVN trunk: apart from anything else it
> needlessly bloats the download size if folks are happy with HTML versions.
> Previously I've placed these in the vault, but there's a file size limit
> there and the new Boost.Math PDF's are too large :-(
>
> Another alternative would be the sourceforge file release system, but I
> don't believe all developers have access to that?
>
> So.... how about we either have a directory in the "website" area of SVN 
> for
> these, or else in the sandbox maybe?
>
> Thoughts?  John.