Re: [jamboost] [BBv2 doc editorial] tutorial/hierarchy

From: Vladimir Prus (ghost_at_[hidden])
Date: 2005-09-21 10:07:41

On Tuesday 20 September 2005 21:07, David Abrahams wrote:

> > the project root is top/. Because there is no Jamfile in top/util/,
> > the projects in top/app/ and top/util/foo/ are immediate children of
> > the root project.
>
> It is not at all clear what the significance of the latter statement
> is. I find it confusing to see it here with no explanation or way of
> relating it to what I'm going to do with BB.

I've just removed the "Because" clause. It did not add much value.

> > <include>/home/ghost/local
> >
> > in its requirements, then all of its sub-projects will have it in
> > their requirements, too. Of course, any project can add include paths
> > to those specified by its parents. ^[5] More details can be found in
> > the section called “Projects”.
> >
> > Invoking bjam without explicitly specifying any targets on the
> > command-line builds the project rooted in the current directory.
>
> "command-line" should only be hyphenated when used as an adjective,
> e.g.
>
> a command-line tool
>
> when used as a noun, command line is two separate words.

Noted.

> > Building a project does not automatically cause its sub-projects to
> > be built unless the parent project's Jamfile explicitly requests it.
> > In our example, top/Jamroot might contain:
> >
> > build-project app ;
>
> ^^^
> Is this a directory or a subproject name? It isn't
> clear from the example. It would be clearer to use a
> subdirectory like util/foo, to distinguish whether I'm
> going to be specifying a path

That will be problematic because of this:

However, targets in <filename>top/util/foo/</filename>
will be built only if they are needed by targets in
<filename>top/</filename> or <filename>top/app/</filename>.

You see, swapping app and util/foo will require saying that 'app' will be 
built only if neede by util/foo, which is strange.

- Volodya

-- 
Vladimir Prus
http://vladimir_prus.blogspot.com
Boost.Build V2: http://boost.org/boost-build2