2
0
mirror of https://github.com/boostorg/build.git synced 2026-02-16 01:12:13 +00:00

Search for site-config.jam and user-config.jam not

only in BOOST_BUILD_PATH but also in HOME and
system locations. Document the search paths.


[SVN r16486]
This commit is contained in:
Vladimir Prus
2002-12-03 12:20:49 +00:00
parent cc3d8a96d2
commit 03fae257a8
3 changed files with 117 additions and 16 deletions

View File

@@ -4,14 +4,13 @@
<html>
<head>
<meta name="generator" content=
"HTML Tidy for Windows (vers 1st August 2002), see www.w3.org">
"HTML Tidy for Linux/x86 (vers 1st March 2002), see www.w3.org">
<!--tidy options: -i -wrap 78 -->
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" type="text/css" href="../../boost.css">
<title>Boost.Build v2 user manual</title>
<style type="text/css">
<style type="text/css">
hr { color: black }
p.revision { text-align: right; font-style: italic }
pre.code { margin-left: 2em }
@@ -21,12 +20,13 @@
br.clear { clear: left }
div.alert { color: red }
table { align: center; border: thin; }
</style>
</style>
</head>
<!-- Things yet to document:
- build request, build request expansion and directly requested targets
- conditional properties
-->
- build request, build request expansion and directly requested targets
- conditional properties
-->
<body>
<p><a href="../../index.htm"><img class="banner" height="86" width="277"
@@ -740,6 +740,51 @@ exe hello : hello.cpp : &lt;toolset&gt;yfc:&lt;cxxflags&gt;-disable-pointless-wa
In this case, running bjam anywhere in the project tree will
automatically find the build system.
<p>The default "bootstrap.jam", after loading some standard definitions,
loads two files, which can be provided/customised by user:
"site-config.jam" and "user-config.jam".</p>
<p>Locations where those files a search are summarized below:</p>
<table align="center" summary="search paths for configuration files">
<caption>
search paths for configuration files
</caption>
<tr>
<td>
</td>
<td>site-config.jam</td>
<td>user-config.jam</td>
</tr>
<tr>
<td>Linux</td>
<td>/etc<br>
$HOME<br>
$BOOST_BUILD_PATH</td>
<td>$HOME<br>
$BOOST_BUILD_PATH</td>
</tr>
<tr>
<td>Windows</td>
<td>$SystemRoot<br>
$HOME<br>
$BOOST_BUILD_PATH</td>
<td>$HOME<br>
$BOOST_BUILD_PATH</td>
</tr>
</table>
Boost.Build comes with default versions of those files, which can serve
as templates for customized versions.
<h3><a name="command_line">Command line</a></h3>
<p>The comamnd line may contain:</p>

View File

@@ -11,11 +11,22 @@ import errors : error ;
import builtin ;
import make ;
import os ;
import version ;
import site-config ;
import user-config ;
local user-path = [ modules.peek : HOME ] [ modules.peek : BOOST_BUILD_PATH ] ;
if [ os.name ] in NT CYGWIN
{
modules.load site-config : : [ modules.peek : SystemRoot ] $(user-path) ;
modules.load user-config : : $(user-path) ;
}
else
{
modules.load site-config : : /etc $(user-path) ;
modules.load user-config : : $(user-path) ;
}
if --version in [ modules.peek : ARGV ]
{

View File

@@ -4,14 +4,13 @@
<html>
<head>
<meta name="generator" content=
"HTML Tidy for Windows (vers 1st August 2002), see www.w3.org">
"HTML Tidy for Linux/x86 (vers 1st March 2002), see www.w3.org">
<!--tidy options: -i -wrap 78 -->
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" type="text/css" href="../../boost.css">
<title>Boost.Build v2 user manual</title>
<style type="text/css">
<style type="text/css">
hr { color: black }
p.revision { text-align: right; font-style: italic }
pre.code { margin-left: 2em }
@@ -21,12 +20,13 @@
br.clear { clear: left }
div.alert { color: red }
table { align: center; border: thin; }
</style>
</style>
</head>
<!-- Things yet to document:
- build request, build request expansion and directly requested targets
- conditional properties
-->
- build request, build request expansion and directly requested targets
- conditional properties
-->
<body>
<p><a href="../../index.htm"><img class="banner" height="86" width="277"
@@ -740,6 +740,51 @@ exe hello : hello.cpp : &lt;toolset&gt;yfc:&lt;cxxflags&gt;-disable-pointless-wa
In this case, running bjam anywhere in the project tree will
automatically find the build system.
<p>The default "bootstrap.jam", after loading some standard definitions,
loads two files, which can be provided/customised by user:
"site-config.jam" and "user-config.jam".</p>
<p>Locations where those files a search are summarized below:</p>
<table align="center" summary="search paths for configuration files">
<caption>
search paths for configuration files
</caption>
<tr>
<td>
</td>
<td>site-config.jam</td>
<td>user-config.jam</td>
</tr>
<tr>
<td>Linux</td>
<td>/etc<br>
$HOME<br>
$BOOST_BUILD_PATH</td>
<td>$HOME<br>
$BOOST_BUILD_PATH</td>
</tr>
<tr>
<td>Windows</td>
<td>$SystemRoot<br>
$HOME<br>
$BOOST_BUILD_PATH</td>
<td>$HOME<br>
$BOOST_BUILD_PATH</td>
</tr>
</table>
Boost.Build comes with default versions of those files, which can serve
as templates for customized versions.
<h3><a name="command_line">Command line</a></h3>
<p>The comamnd line may contain:</p>