From 79ac38b7f40dbc7279ac7cee8e699f8a2bfa76b4 Mon Sep 17 00:00:00 2001 From: Vladimir Prus Date: Wed, 14 Sep 2005 06:50:39 +0000 Subject: [PATCH] Fix documentation of and features. [SVN r30971] --- doc/src/advanced.xml | 24 +++++++++++++----------- 1 file changed, 13 insertions(+), 11 deletions(-) diff --git a/doc/src/advanced.xml b/doc/src/advanced.xml index 967029076..3431e1800 100644 --- a/doc/src/advanced.xml +++ b/doc/src/advanced.xml @@ -1449,15 +1449,13 @@ unit-test helpers_test : helpers_test.cpp helpers ; - The <source>X feature has the same effect on building a target - as putting X in the list of sources. The feature - is sometimes more convenient: - - you can put <source>X in the - requirements for a project and X will - be included as a source in all of the project's main - targets. - + The <source>X feature has the same effect on + building a target as putting X in the list of sources. + It's useful when you want to add + the same source to all targets in the project + (you can put <source> in requirements) or to conditionally + include a source (using conditional requirements, see ) + See also the <library> feature. @@ -1466,8 +1464,12 @@ unit-test helpers_test : helpers_test.cpp helpers ; - This feature is equivalent to the <source> feature, and exists - for backward compatibility reasons. + This feature is almost equivalent to the <source> feature, + except that it takes effect only for linking. When you want to + link all targets in a Jamfile to certain library, the + <library> feature is preferred over + <source>X -- the latter will add the library to + all targets, even those that have nothing to do with libraries.