path: root/debhelper.pod
diff options
authorJoey Hess <>2009-06-28 15:40:15 -0400
committerJoey Hess <>2009-06-28 15:40:15 -0400
commit93c1062bc3ee340fcd7318e91fe9758d86b760f3 (patch)
tree5ca5f93c23c84fb2c3f0ce3a4199e57c01f422d3 /debhelper.pod
parente0ed03ff224ee3a8053094f02bcd02d4dd3fa358 (diff)
minimal build system option documentation
Diffstat (limited to 'debhelper.pod')
1 files changed, 49 insertions, 0 deletions
diff --git a/debhelper.pod b/debhelper.pod
index 388453c..40147a5 100644
--- a/debhelper.pod
+++ b/debhelper.pod
@@ -174,6 +174,55 @@ in ALL packages acted on, not just the first.
+The following command line options are supported by all of the dh_auto_*
+debhelper programs. These programs support a variety of build systems,
+and normally heuristically determine which to use, and how to use them.
+You can use these command line options to override the default behavior.
+=over 4
+=item B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>
+Force use of the specified I<buildsystem>, instead of trying to auto-select
+one which might be applicable for the package.
+=item B<-D>I<directory>, B<--sourcedirectory=>I<directory>
+Assume that the original package source tree is at the specified
+I<directory> rather than the top level directory of the Debian
+source package tree.
+=item B<-B>[I<directory>], B<--builddirectory>=[I<directory>]
+Enable out of source building and use the specified I<directory> as the build
+directory. If I<directory> parameter is omitted, a default build directory
+will chosen.
+If this option is not specified, building will be done in source by default
+unless the build system requires or prefers out of source tree building.
+In such a case, the default build directory will be used even if
+L<--builddirectory> is not specified.
+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<--list>, B<-l>
+List all build systems supported by debhelper on this system. The list
+includes both default and third party build systems (marked as such). Also
+shows which build system would be automatically selected, or which one
+is manually specified with the I<--buildsystem> option.
+=item B<--help-buildsystem>
+Print detailed help about a build system which would be auto-selected or which
+is manually specified with the L<--buildsystem> option.
=head1 NOTES
=head2 Multiple binary package support