Subject: Re: [Boost-build] Running `make` from BB
From: Stefan Seefeld (stefan_at_[hidden])
Date: 2016-10-14 10:42:01
On 14.10.2016 10:28, Rene Rivera wrote:
> On Fri, Oct 14, 2016 at 8:20 AM, Stefan Seefeld <stefan_at_[hidden]
> <mailto:stefan_at_[hidden]>> wrote:
> I want to integrate documentation that uses its own build system. (The
> Boost.Python NumPy extension uses sphinx.)
> What do I need to add to my Jamfile to run `make` in addition to
> a few directories around ?
> Specifically, I have this directory structure:
> and I want to generate `python/doc/html/numpy/` ? (I suppose, to
> BB conventions I should copy the `numpy/` subdirectory above into
> bin.v2/, invoke `make` there, then copy the generatd `html/` directory
> back into `python/doc/html/numpy`.)
> What do I need to do here ? Define a rule ? Use an existing rule
> with a
> custom action ? I'd appreciate if someone could give me some
> Is this documentation that will be integrated into the general Boost
> release build? I ask because there are special requirements for that..
> In an ideal world I, personally, wouldn't need to do anything. But
> since the release building rebuilds all the documentation I need to
> know what tools need to be installed to build it.
Yes, this will build the NumPy part of the Boost.Python doc.
"Integration" simply means that the toplevel index contains a relative
URL to the NumPy doc. The development environment needs to have sphinx
(python-sphinx in a typical Linux distro) installed.
> Most likely, you can just use the "make" target type
I tried that, by adding the following snippet to doc/Jamfile:
make html/numpy : numpy : @sphinx ;
ECHO calling sphinx... ;
but I get
error: Unable to find file or target named
error: referred to from project at
-- ...ich hab' noch einen Koffer in Berlin...
Boost-Build list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk