summaryrefslogtreecommitdiff
path: root/debhelper.pod
AgeCommit message (Collapse)AuthorFilesLines
2011-08-06dpkg-buildflags is only used to set environment in v9Joey Hess1-4/+6
To avoid re-breaking packages that were already broken a first time by dpkg-buildpackage unconditionally setting the environment, and unbroke it by unsetting variables in the rules file. (Example: numpy)
2011-07-19doc tweak re target dependenciesJoey Hess1-2/+3
If a rules file has a custom install or binary target, those targets still need to explicitly depend on the build target. Unless dh is used in such a target (which it probably is of course). It's not possible to avoid the need for those dependencies. A rules file with a hand-written binary target simply does not run dh, so dh can do nothing to help it run the build target. Reword the docs to not give the wrong impression that dh somehow magically makes that work.
2011-07-16reorg notes sectionJoey Hess1-86/+80
2011-07-16dh: In v9, do not enable any python support commands.Joey Hess1-0/+4
dh_pysupport has started emitting a deprecation warning, which is very annoying since it clutters every build that uses dh -- even builds where it doesn't do anything. Since there is not just a dh_python2, but also a dh_python3 waiting in the wings, this is clearly too volatile a situation for dh to try to support further. I considered making dh_python detect and run the right dh_python[23] helper -- a python helper helper as it were -- but 70-odd packages still use that command.
2011-07-09typoJoey Hess1-1/+1
2011-07-04Typo fixes. Closes: #632662Joey Hess1-2/+2
2011-06-17Correct docs about multiarch and v9. Closes: #630826Joey Hess1-4/+1
2011-06-14Merge branch 'master' into smarter-targetsJoey Hess1-0/+4
Conflicts: dh
2011-06-14dpkg-buildflags supportJoey Hess1-0/+4
* dh_auto_build, dh_auto_configure, dh: Set environment variables listed by dpkg-buildflags --export. Any environment variables that are already set to other values will not be changed. Closes: #544844 * Also, support DEB_BUILD_OPTIONS=noopt, by changing -O2 to -O0.
2011-06-14Merge branch 'master' into smarter-targetsJoey Hess1-0/+5
Conflicts: debhelper.pod debian/changelog
2011-06-14dh_auto_configure: In v9, does not include the source package name in ↵Joey Hess1-0/+5
--libexecdir when using autoconf. Closes: #541458 Fixed rleigh's patch to be more correct in the edge case where there is a non-multiarch dpkg (ie, backports).
2011-06-13make standard targets support a v9 featureJoey Hess1-0/+5
2011-04-05reorder v9 section and add missing =backJoey Hess1-16/+18
2011-03-12Depend on dpkg-dev (>= 1.16.0) for multiarch support.Joey Hess1-3/+2
Note to backporters: If you remove that dependency, debhelper will fall back to not doing multiarch stuff in v9 mode, which is probably what you want.
2011-03-12documentationJoey Hess1-0/+17
2011-02-26typoJoey Hess1-1/+1
2010-11-02Apply manual pages conventionsDavid Prévot1-114/+114
As advised in man(1), always use: B<bold text> type exactly as shown. I<italic text> replace with appropriate argument. s/debian/Debian/ if needed. s/ / / also. s/perl/Perl/ s/python/Python/ and s/emacs/Emacs/ too.
2010-08-07Finalized v8 mode, which is the new recommended default.Joey Hess1-6/+3
2010-05-28In v8 mode, prefer the perl_build buildsystem over perl_makemaker. Closes: ↵Joey Hess1-0/+4
#578805
2010-05-27exampleJoey Hess1-1/+1
2010-05-27consistently use v7 not V7 (etc)Joey Hess1-15/+15
2010-05-27In v8 mode, dh expects the sequence to run is always its first parameter.Joey Hess1-0/+5
This avoids ambiguities when parsing options to be passed on to debhelper commands. (See #570039) In the end, the idea of putting the debhelper command options after -- seemed to need too much knowledge about whether an option like --buildsystem is a dh option or a command option. I did consider making no change.. The ambiguities this eliminates are small. But it seemed worth simplifying dh's option parser, and only about 1/6th of calls to dh in the archive don't put the sequence first already. (Docs have shown that as the right thing to do for some time.)
2010-05-23In v8 mode, dh_makeshlibs will run dpkg-gensymbols on all shared libraries ↵Joey Hess1-0/+8
it generates shlibs files for. This means that -X can be used to exclude libraries from processing by dpkg-gensymbols. It also means that libraries in unusual locations, where dpkg-gensymbols does not itself normally look will be passed to it, a behavior change which may break some packages. Closes: #557603
2010-05-23In v8 mode, do not allow directly passing unknown options to debhelper ↵Joey Hess1-0/+15
commands. (Unknown options in DH_OPTIONS still only result in warnings.)
2010-05-23update Package-Type docsJoey Hess1-1/+1
dpkg supports the field now, so no XC- needed
2010-01-04solve the dh -Bbuild problemJoey Hess1-0/+7
* 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.)
2009-12-07changelog and doc rewordingJoey Hess1-7/+6
2009-12-04Add --parallel option.Modestas Vainius1-9/+13
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.
2009-11-23Parallel building support is no longer enabled by default. It can still be ↵Joey Hess1-7/+10
enabled by using the --max-parallel option. This was necessary because some buildds build with -j2 by default.
2009-11-04Drop deprecated programs from the list of commands in debhelper(7). Closes: ↵Joey Hess1-2/+14
#548382
2009-11-04--max-parallel requires a numberJoey Hess1-1/+1
2009-10-29implement the other option: parallel enabled implicitly by DEB_BUILD_OPTIONSJoey Hess1-7/+8
I renamed --parallel to --max-parallel to clarify that it doesn't enable parallelism, but only controls how much of it is allowed.
2009-10-28remove implicit --parallel setting by dhJoey Hess1-3/+0
2009-10-28clarify wordingJoey Hess1-14/+9
2009-10-28Support parallel building in makefile buildsystemModestas Vainius1-0/+18
1) Add routine to Dh_Lib (used by dh and makefile.pm) 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 <modestas@vainius.eu>
2009-09-08dh_installdocs: Add --link-doc option that can be used to link documentation ↵Joey Hess1-11/+0
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
2009-09-01-a == -sJoey Hess1-8/+4
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
2009-06-28Revert "Add --help-buildsystem option to dh_auto."Joey Hess1-5/+0
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.
2009-06-28minimal build system option documentationJoey Hess1-0/+49
2009-06-13Revert "Improvements in DH_OPTIONS handling and DH_AUTO_OPTIONS envvar support."Modestas Vainius1-8/+2
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 Dh_Buildsystems.pm. Breaks testsuite.
2009-06-08Improvements in DH_OPTIONS handling and DH_AUTO_OPTIONS envvar support.Modestas Vainius1-2/+8
* 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.
2009-05-12releasing version 7.2.117.2.11Joey Hess1-2/+2
2009-05-12Support debian/foo.os files to suppliment previous debian/foo.arch file ↵Joey Hess1-3/+4
support. Closes: #494914 (Thanks, Aurelien Jarno)
2009-03-23Add a global --remaining-packages option.Modestas Vainius1-0/+8
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 <modestas@vainius.eu>
2009-03-07Compatability level 4 is now deprecated.Joey Hess1-0/+2
2008-12-30debhelper.pod: Fix typo. Closes: #510180Joey Hess1-2/+2
2008-12-14Ignore unknown options in DH_OPTIONS. Debhelper will always ignore such ↵Joey Hess1-4/+7
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.)
2008-11-06Fix some docs that refered to --srcdir rather than --sourcedir. Closes: #504742Joey Hess1-1/+1
2008-06-25Correct docs about dh_install and debian/tmp in v7 modeJoey Hess1-4/+4
* 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.
2008-06-16Typo fix. Closes: #486464Joey Hess1-1/+1