Boost logo

Boost-Build :

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:
> Hello,
> 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
> copying
> a few directories around ?
> Specifically, I have this directory structure:
> python/doc/
> Jamfile
> numpy/
> Makefile
> make.bat
> and I want to generate `python/doc/html/numpy/` ? (I suppose, to
> follow
> 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
> directions.
> 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 ;
actions sphinx
  ECHO calling sphinx... ;

but I get

  error: Unable to find file or target named
  error: 'numpy'
  error: referred to from project at
  error: '.'


      ...ich hab' noch einen Koffer in Berlin...

Boost-Build list run by bdawes at, david.abrahams at, gregod at, cpdaniel at, john at