|author||Joey Hess <email@example.com>||2009-10-28 17:57:33 -0400|
|committer||Joey Hess <firstname.lastname@example.org>||2009-10-28 17:57:33 -0400|
Diffstat (limited to 'debhelper.pod')
1 files changed, 9 insertions, 14 deletions
diff --git a/debhelper.pod b/debhelper.pod
index 8ea3f31..238675a 100644
@@ -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
-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>