Re: [Boost-docs] installing files

Subject: Re: [Boost-docs] installing files
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2009-12-23 18:03:17

> -----Original Message-----
> From: boost-docs-bounces_at_[hidden]
[mailto:boost-docs-bounces_at_[hidden]]
> On Behalf Of Rene Rivera
> Sent: Tuesday, December 22, 2009 7:00 PM
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] installing files
> 
> Paul A. Bristow wrote:
> > I am trying, so far unsuccessfully, to copy the .css and some image files
into a
> > doc/html  so that the html and subdirectories are complete and 'zippable'.
But
> > there is obviously something (many perhaps things) that I don't understand
about
> > B*****y jam syntax/rules.
> >
> > I want to copy the Boost 'official' versions using BOOST_ROOT (or better a
local
> > version).
> >
> > path-constant local-boost-root : $BOOST_ROOT ; # So can access your chosen
boost
> > version (trunk, old ...).
> >
> > Ideally I'd like to create path constants for the sources too, for example:
> >
> >    path-constant images_location  :    $(BOOST_ROOT)/doc/html ;
> >
> > 1st copy the stylesheet boostbook.css into an html subfolder
> >
> > install css
> >   :
> >     <location>$(BOOST_ROOT)/doc/html/boostbook.css
> >   :
> >     <location>html
> >   ;
> >
> > But this doesn't do the copy?
> 
> Interesting... Not sure what effect that would have other than an error
> message from BBv2. Try looking at the way the existing docs build copies
> the CSS and images
> <https://svn.boost.org/trac/boost/browser/trunk/doc/Jamfile.v2#L82>. But
> to put it briefly:
> 
> install /target name/ : /source files/ : <location>/target directory/ ;

I have got as far as understanding that - but I suspect not how to specify the
names and directories.

I've tried to copy this example by Daniel James - but the difference is that I
am trying (perhaps misguidedly - but can't see why) to use an *absolute* file
specification based on BOOST_ROOT. 

install css : [ glob src/*.css ] : <location>html ;
explicit css ;
install images : [ glob src/images/*.png ] : <location>html/images ;
explicit images ;
install callouts : [ glob src/images/callouts/*.png ] :
<location>html/images/callouts ;
explicit callouts ;

I clearly don't understand how to use glob rule, for example trying 

install css : [ glob $(BOOST_ROOT)/doc/src/boostbook.css ] : <location>html ;
explicit css ;

because I get an error (despite apparently not using a * wildcard)

jamfile.v2:232: in modules.load
*** argument error
* rule glob ( wildcards + : excludes * )
* called with: (  )
* missing argument wildcards
I:/boost_1_41_0/tools/build/v2/build\project.jam:1040:see definition of rule
'glob' being called
I:/boost_1_41_0/tools/build/v2/build\project.jam:313: in load-jamfile
I:/boost_1_41_0/tools/build/v2/build\project.jam:62: in load
I:/boost_1_41_0/tools/build/v2/build\project.jam:168: in project.find
I:/boost_1_41_0/tools/build/v2\build-system.jam:553: in load
I:\boost_1_41_0\tools\build\v2/kernel\modules.jam:283: in import
I:\boost_1_41_0\tools\build\v2/kernel/bootstrap.jam:142: in boost-build
I:\boost-sandbox\boost-build.jam:43: in module scope

I'm not clear if $(BOOST_ROOT) should be followed by a double // (but the error
message is till the same)

install css : [ glob $(BOOST_ROOT)//doc/src/boostbook.css ] : <location>html ;

Yours still confused :-(

Paul