Re: [Boost-build] How is a module found when using import

Subject: Re: [Boost-build] How is a module found when using import
From: Steven Watanabe (watanabesj_at_[hidden])
Date: 2013-05-27 23:39:19

AMDG

On 05/27/2013 05:07 PM, Edward Diener wrote:
> On 5/27/2013 7:04 PM, Steven Watanabe wrote:
>> On 05/27/2013 03:52 PM, Edward Diener wrote:
>>> If I write 'import somemodule ;' in a jamfile how is 'somemodule' found
>>> ? I know 'somemodule' is just a jamfile called 'somemodule.jam' but how
>>> does Boost build find it in o0rder to import it ?
>>>
>>
>> It searches the directories in BOOST_BUILD_PATH.
> 
> I have no environment variable called BOOST_BUILD_PATH so there must be
> an alternative. Also does it search in subdirectories ? I expect so.
> 

kernel/bootstrap.jam (which is called at startup)
adds kernel, util, build, tools, and contrib to
BOOST_BUILD_PATH.  Oh. and import also searches
in the same directory as the importer.

>>
>>> If I wanted to contribute a new module to Boost build, how do I do it ?
>>>
>>
>> It would go in tools/build/v2/tools with the
>> other modules.
> 
> I see Boost build jamfiles in other places beneath tools/build/v2 :
> tools/build/v2/build, tools/build/v2/util etc. So I am guessing that it
> should be placed in tools/build/v2/tools but will be found elsewhere also.
> 

Yes.  util/ is for general purpose library
components.  (string processing, algorithms,
etc.) build/ is the core build system.
tools/ is for toolsets.  kernel/
is for a few critical components that
are tightly coupled to the Jam engine.

>> You can post it here for
>> review.
> 
> Will do if/when I finish. Thanks !
> 

In Christ,
Steven Watanabe