path: root/debhelper.pod
Commit message (Collapse)AuthorAge
* solve the dh -Bbuild problemJoey Hess2010-01-04
| | | | | | | | | * Add -O option, which can be used to pass options to commands, ignoring options that they do not support. * dh: Use -O to pass user-specified options to the commands it runs. This solves the problem with passing "-Bbuild" to dh, where commands that do not support -B would see a bogus -u option. Closes: #541773 (It also ensures that the commands dh prints out can really be run.)
* changelog and doc rewordingJoey Hess2009-12-07
* Add --parallel option.Modestas Vainius2009-12-04
| | | | | | | | | This patch adds --parallel option that enables parallel builds and does not impose limits on maximum concurrent processes. --max-parallel (that implies --parallel) can be used to specify that maximum limit. Also make necessary adjustments to debhelper.pod and buildsystem_tests for this option.
* Parallel building support is no longer enabled by default. It can still be ↵Joey Hess2009-11-23
| | | | enabled by using the --max-parallel option. This was necessary because some buildds build with -j2 by default.
* Drop deprecated programs from the list of commands in debhelper(7). Closes: ↵Joey Hess2009-11-04
| | | | #548382
* --max-parallel requires a numberJoey Hess2009-11-04
* implement the other option: parallel enabled implicitly by DEB_BUILD_OPTIONSJoey Hess2009-10-29
| | | | | I renamed --parallel to --max-parallel to clarify that it doesn't enable parallelism, but only controls how much of it is allowed.
* remove implicit --parallel setting by dhJoey Hess2009-10-28
* clarify wordingJoey Hess2009-10-28
* Support parallel building in makefile buildsystemModestas Vainius2009-10-28
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | 1) Add routine to Dh_Lib (used by dh and which is capable of detecting make jobserver and job control options from the MAKEFLAGS environment variable. It also generates and returns a clean up MAKEFLAGS from these options. 2) Add --parallel option to build system framework which allows source packages to specify that they support parallel building. Optional value for this option is the number of maximum parallel process to allow. However, the actual number of parallel process (if any) for the specific build is determined from DEB_BUILD_OPTIONS env variable as specified by Debian Policy. By default (no --parallel option) parallel is neither enabled nor disabled (depends on the external environment). However, dh may pass --parallel to dh_auto_* implicitly in case 4) described below. 3) Add parallel support for makefile buildsystem. This implementation forcefully starts a new make job server (or disables parallel) for the number of process requested. If --parallel was not passed to the build system at all, the build system will only clean up MAKEFLAGS from stale jobserver options to avoid pointless make warnings. 4) If dh detects that it is being run by dpkg-buildpackage -jX and it is NOT run with "+" prefix from debian/rules (i.e. jobserver is not reachable), it enables --parallel implicitly. This closes: #532805. Signed-off-by: Modestas Vainius <>
* dh_installdocs: Add --link-doc option that can be used to link documentation ↵Joey Hess2009-09-08
| | | | directories. This is easier to use and more flexible than the old method of running dh_link first to make a broken symlink. Closes: #545676 Thanks, Colin Watson
* -a == -sJoey Hess2009-09-01
| | | | | | | The -a flag now does the same thing as the -s flag, so debhelper users do not need to worry about using the -s flag when building a package that only builds for some architectures, and dh will also work in that situation. Closes: #540794
* Revert "Add --help-buildsystem option to dh_auto."Joey Hess2009-06-28
| | | | | | | I'm unsure why we need this complication. Perl modules are allowed to install man pages documenting the module, if it really needs documentation. This reverts commit 49b64c7852744f54250121b1c60544e1f5de70b6.
* minimal build system option documentationJoey Hess2009-06-28
* Revert "Improvements in DH_OPTIONS handling and DH_AUTO_OPTIONS envvar support."Modestas Vainius2009-06-13
| | | | | | | | | | | | This mostly reverts commit f897611a77726655aea258af0c4d52a8ce759ebc. Remaining cosmetic changes (all functional changes have been reverted): * Refactoring of option string into split_options_string() sub (no semantic changes though). * Cosmetic change in Breaks testsuite.
* Improvements in DH_OPTIONS handling and DH_AUTO_OPTIONS envvar support.Modestas Vainius2009-06-08
| | | | | | | | | | | | | | * DH_AUTO_OPTIONS is like existing DH_OPTIONS, just only for dh_auto stuff. This also avoids "explosion" of separate DH_AUTO_* environment variables (i.e. exports in debian/rules) and encourages usage of dh_auto command line option names. DH_AUTO_OPTIONS is passed via "extra_args" to Dh_Lib::init() (API addition). * When splitting options from DH_OPTIONS and its flavours, allow arguments to include whitespaces if they are escaped with backslash (\) (see split_options_string()). Document this in debhelper.pod. * Short option for --buildsystem is -c (aka class). * Provide API to cancel option specs from default debhelper options. It will be used in the feature.
* releasing version 7.2.11Joey Hess2009-05-12
* Support debian/foo.os files to suppliment previous debian/foo.arch file ↵Joey Hess2009-05-12
| | | | support. Closes: #494914 (Thanks, Aurelien Jarno)
* Add a global --remaining-packages option.Modestas Vainius2009-03-23
| | | | | | | | Add a global --remaining-packages option which allows to skip the command on the packages which it has already been run on (i.e. if the command helper is already present in the package debhelper log). Signed-off-by: Modestas Vainius <>
* Compatability level 4 is now deprecated.Joey Hess2009-03-07
* debhelper.pod: Fix typo. Closes: #510180Joey Hess2008-12-30
* Ignore unknown options in DH_OPTIONS. Debhelper will always ignore such ↵Joey Hess2008-12-14
| | | | options, even when unknown command-line options are converted back to an error. This allows (ab)using DH_OPTIONS to pass command-specific options. (Note that getopt will warn about such unknown options. Eliminating this warning without reimplementing much of Getopt::Long wasn't practical.)
* Fix some docs that refered to --srcdir rather than --sourcedir. Closes: #504742Joey Hess2008-11-06
* Correct docs about dh_install and debian/tmp in v7 modeJoey Hess2008-06-25
| | | | | | | * Correct docs about dh_install and debian/tmp in v7 mode. It first looks in the current directory, or whatever is configured with --srcdir. Then it always falls back to looking in debian/tmp. * Medium urgency to get this doc fix into testing.
* Typo fix. Closes: #486464Joey Hess2008-06-16
* I lied, one more v7 change slipped in..Joey Hess2008-04-24
| | | | | * dh_installchangelogs: In v7 mode, if no upstream changelog is specified, and the package is not native, guess at a few common changelog filenames.
* dh_clean: In v7 mode, automatically delete *-stamp files.Joey Hess2008-04-23
* dh_clean: In v7 mode, read debian/clean and delete all files listed therein.Joey Hess2008-04-23
* initial version of dh, with option parsing and sequences in placeJoey Hess2008-04-23
* New v7 mode, which only has one change from v6, and is the new recommended ↵Joey Hess2008-04-23
| | | | | | | | | | | default. * New v7 mode, which only has one change from v6, and is the new recommended default. * dh_install: if --sourcedir is not specified, first look for files in debian/tmp, and then will look in the current directory. This allows dh_install to interoperate with dh_auto_install without needing any special parameters.
* updatesJoey Hess2008-01-08
* finialize v6 modeJoey Hess2008-01-07
* add .git to example DH_ALWAYS_EXCLUDE lineJoey Hess2007-10-22
* r2033: * Add --ignore option. This is intended to ease dealing with upstreamjoeyh2007-09-30
| | | | | | | | tarballs that contain debian directories, by allowing debhelper config files in those directories to be ignored, since there's generally no good way to delete them out of the upstream tarball, and they can easily get in the way if upstream is using debian/ differently than the Debian maintainer.
* r2016: fixjoeyh2007-07-09
* r2002: * Update urls to web page.joeyh2007-05-17
* r1997: * dh_installwm: Fix several stupid bugs, including:joeyh2007-04-20
| | | | | | | | | - man page handling was supposed to be v6 only and was not - typo in alternatives call - use the basename of the wm to get the man page name Closes: #420158 * dh_installwm: Also make the code to find the man page more robust and fall back to not registering a man page if it is not found.
* r1987: * Do script fragement reversal only in v6, since it can break certianjoeyh2007-04-13
| | | | third party programs such as dh_installtex. Closes: #419060
* r1980: * prerm and postrm scripts are now generated in a reverse order thanjoeyh2007-04-09
| | | | | | | | | | | | | | | | | preinst and postinst scripts. For example, if a package uses dh_pysupport before dh_installinit, the prerm will first stop the init script and then remove the python files. * Introducing beginning of v6 mode. * dh_installwm: In v6 mode, install a slave manpage link for x-window-manager.1.gz. Done in v6 mode because some window managers probably work around this longstanding debhelper bug by registering the slave on their own. This bug was only fixable once programs moved out of /usr/X11R6. Closes: #85963 * dh_builddeb: In v6 mode, fix bug in DH_ALWAYS_EXCLUDE handling, to work the same as all the other code in debhelper. This could only be fixed in v6 mode because packages may potentially legitimately rely on the old buggy behavior. Closes: #242834 * dh_installman: In v6 mode, overwrite exsiting man pages. Closes: #288250
* r1973: fixjoeyh2007-03-07
* r1836: * debhelper(7): document previous dh_install v5 change re wildcarding.joeyh2006-01-04
* r1824: * Man page type fixes (yes, more, nice to know people read the man ↵joey2005-11-29
| | | | | | pages). Closes: #341289
* r1805: releasing version 5.0.0joey2005-11-02
* r1763: releasing version 4.9.0joey2005-06-13
* r1753: * The infinite number of monkeys release.joey2005-04-22
| | | | * dh_md5sums: don't crash if PWD contains an apostrophe. Closes: #305226
* r1740: releasing version 4.2.31joey2005-02-16
* r1715: * dpkg-cross is fixed in unstable, version the conflict. Closes: ↵joey2004-08-25
| | | | | | #265777 * Complete Spanish translation of all man pages thanks to Rubén Porras
* r1711: releasing version 4.2.18joey2004-08-13
* r1655: * Added udeb support, as pioneered by di-packages-build. Understandsjoey2004-02-09
| | | | | | | | | | | | | | | "XC-Package-Type: udeb" in debian/control. See debhelper(1) for details. * Dh_Lib: add and export is_udeb and udeb_filename * dh_builddeb: name udebs with proper extension * dh_gencontrol: pass -n and filename to dpkg-gencontrol * dh_installdocs, dh_makeshlibs, dh_md5sums, dh_installchangelogs, dh_installexamples, dh_installman, dh_installmanpages: skip udebs * dh_shlibdeps: skip udebs. This may be temporary. * dh_installdeb: do not process conffiles, shlibs, preinsts, postrms, or prerms for udebs. Do not substiture #DEBHELPER# tokens in postinst scripts for udebs. * dh_installdebconf: skip config script for udebs, still do templates
* r1596: * Remove duplicate packages from DOPACKAGES after argument processing.joey2003-08-22
| | | | | | | | | | | | | | Closes: #112950 * dh_compress: deal with links pointing to links pointing to compressed files, no matter what order find returns them. Closes: #204169 * dh_installmodules, dh_installpam, dh_installcron, dh_installinit, dh_installogrotate: add --name= option, that can be used to specify the name to use for the file(s) installed by these commands. For example, dh_installcron --name=foo will install debian/ to etc/cron.daily/foo. Closes: #138202, #101003, #68545, #148844 (Thanks to Thomas Hood for connecting these bug reports.) * dh_installinit: deprecated --init-script option in favor of the above. * Add dh_installppp. Closes: #43403