diff options
author | Joey Hess <joey@gnu.kitenet.net> | 2009-06-28 15:40:15 -0400 |
---|---|---|
committer | Joey Hess <joey@gnu.kitenet.net> | 2009-06-28 15:40:15 -0400 |
commit | 93c1062bc3ee340fcd7318e91fe9758d86b760f3 (patch) | |
tree | 5ca5f93c23c84fb2c3f0ce3a4199e57c01f422d3 /debhelper.pod | |
parent | e0ed03ff224ee3a8053094f02bcd02d4dd3fa358 (diff) |
minimal build system option documentation
Diffstat (limited to 'debhelper.pod')
-rw-r--r-- | debhelper.pod | 49 |
1 files changed, 49 insertions, 0 deletions
diff --git a/debhelper.pod b/debhelper.pod index 388453c3..40147a50 100644 --- a/debhelper.pod +++ b/debhelper.pod @@ -174,6 +174,55 @@ in ALL packages acted on, not just the first. =back +=head1 BUILD SYSTEM OPTIONS + +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. + +=back + =head1 NOTES =head2 Multiple binary package support |