Re: [Boost-build] Running `make` from BB

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