path: root/debhelper.pod
diff options
authorJoey Hess <>2009-10-29 16:12:57 -0400
committerJoey Hess <>2009-10-29 16:12:57 -0400
commit7e35f3cf73dd5c6e4c8848217e33e2c6c8e00ed4 (patch)
tree5163d7a1610416ca018201e0003e420b382c8b17 /debhelper.pod
parent3c3ebf1ba6a7e93f7fb66d375ca8c1106d99af2c (diff)
implement the other option: parallel enabled implicitly by DEB_BUILD_OPTIONS
I renamed --parallel to --max-parallel to clarify that it doesn't enable parallelism, but only controls how much of it is allowed.
Diffstat (limited to 'debhelper.pod')
1 files changed, 8 insertions, 7 deletions
diff --git a/debhelper.pod b/debhelper.pod
index 20ca9d7..0a9ef41 100644
--- a/debhelper.pod
+++ b/debhelper.pod
@@ -205,15 +205,16 @@ If the build system prefers out of source tree building but still
allows in source building, the latter can be re-enabled by passing a build
directory path that is the same as the source directory path.
-=item B<-j>[I<maximum>], B<--parallel>[I<=maximum>]
+=item B<--max-parallel>[I<=maximum>]
-Indicate that a source package supports building using multiple parallel
-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).
+By default, the DEB_BUILD_OPTIONS environment variable can be used to
+enable parallel building, when supported by the build system.
-The number of parallel processes will be the smaller value specified by
-I<--parallel>, DEB_BUILD_OPTIONS, or a build system specific limit.
+This option allows controlling how many parallel jobs can be used in a
+build. If set to 1, concurrent builds are disabled -- do this if
+the package build is known not to work in parallel. If the package build
+is known to only work with certian levels of concurrency, you can set this
+to the maximum level that is known to work, or that you wish to support.
=item B<--list>, B<-l>