summaryrefslogtreecommitdiff
path: root/debhelper.pod
diff options
context:
space:
mode:
authorJoey Hess <joey@gnu.kitenet.net>2009-10-28 17:57:33 -0400
committerJoey Hess <joey@gnu.kitenet.net>2009-10-28 17:57:33 -0400
commit9835dfdc3db46dc6943e9f86b72a7d8f7728623e (patch)
tree966998481d8426e4987fa7329f6e4b08a4eff3b0 /debhelper.pod
parent22272aacfd9a988e722ba3fcb9b93432f5a1e29a (diff)
clarify wording
Diffstat (limited to 'debhelper.pod')
-rw-r--r--debhelper.pod23
1 files changed, 9 insertions, 14 deletions
diff --git a/debhelper.pod b/debhelper.pod
index 8ea3f31..238675a 100644
--- a/debhelper.pod
+++ b/debhelper.pod
@@ -208,20 +208,15 @@ directory path that is the same as the source directory path.
=item B<-j>[I<maximum>], B<--parallel>[I<=maximum>]
Indicate that a source package supports building using multiple parallel
-processes. However, the package will be built in this mode only if the build
-system supports this feature and tag I<parallel=n> is present in the
-DEB_BUILD_OPTIONS environment variable (as per Debian Policy section 4.9.1).
-The number of spawned parallel processes will be the smallest value of I<n>,
-I<maximum> (if specified) or a build system specific limit.
-
-If value of I<maximum> is 1, parallel building will be forcefully disabled.
-Such construct can be used to negate effects of the previously specified
-I<--parallel> option.
-
-If I<--parallel> is not specified, a debhelper build system will neither
-attempt to enforce nor prevent parallel building. This typically means a source
-package does not to support parallel building or enforces it in other ways
-(e.g. by modifying MAKEFLAGS manually).
+processes. This only enables parallel building if the build system supports
+it, and I<parallel=n> is present in the DEB_BUILD_OPTIONS environment
+variable (as per Debian Policy section 4.9.1).
+
+The number of parallel processes will be the smaller value specified by
+I<--parallel>, DEB_BUILD_OPTIONS, or a build system specific limit.
+So, I<--parallel=1> can be used to disable parallel building, or a larger
+number can be specified if a package is known to only successfully build
+with a limited number of parallel processes.
=item B<--list>, B<-l>