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
> <http://www.boost.org/build/doc/html/bbv2/builtins/raw.html>.

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: '.'

Thanks,
        Stefan

-- 
      ...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