From: Joey Hess Date: Wed, 28 Oct 2009 21:57:33 +0000 (-0400) Subject: clarify wording X-Git-Tag: 7.4.4~28 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=9835dfdc3db46dc6943e9f86b72a7d8f7728623e;p=debhelper.git clarify wording --- 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], 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 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, -I (if specified) or a build system specific limit. - -If value of I 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 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>