logic simplification

[debhelper.git] / debhelper.pod

diff --git a/debhelper.pod b/debhelper.pod
index a903620ce94311adb4528d375a41cba0490928b3..238675ab6f084378057dbf7c5396e535365cf7e2 100644 (file)
--- a/debhelper.pod
+++ b/debhelper.pod
@@ -205,6 +205,19 @@ 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>]
+
+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).
+
+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>
 
 List all build systems supported by debhelper on this system. The list
@@ -471,17 +484,6 @@ none is specified.
 
 =back
 
-=head2 Doc directory symlinks
-
-Sometimes it is useful to make a package not contain a /usr/share/doc/package
-directory at all, instead placing just a dangling symlink in the binary
-package, that points to some other doc directory. Policy says this is ok if
-your package depends on the package whose doc directory it uses. To
-accomplish this, just don't tell debhelper to install any documentation
-files into the package, and use dh_link to set up the symlink (or do it by
-hand), and debhelper should do the right thing: notice it is a dangling
-symlink and not try to install a copyright file or changelog.
-
 =head2 udebs
 
 Debhelper includes support for udebs. To create a udeb with debhelper,