path: root/doc
Commit message (Collapse)AuthorAge
* r518: * dh_movefiles has long been a sore point in debhelper. Inheritedjoey2002-04-12
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | from debstd, its interface and implementation suck, and I have maintained it while never really deigning to use it. Now there is a remplacment: dh_install, which ... - copies files, doesn't move them. Closes: #75360, #82649 - doesn't have that whole annoying debian/package.files vs. debian/files mess, as it uses debian/install. - supports copying empty subdirs. Closes: #133037 - doesn't use tar, thus no error reproting problems. Closes: #112538 - files are listed relative to the pwd, debian/tmp need not be used at all, so no globbing issues. Closes: #100404 - supports -X. Closes: #116902 - the whole concept of moving files out of a directory is gone, so this bug doesn't really apply. Closes: #120026 - This is exactly what Bill Allombert asked for in #117383, even though I designed it seemingly independantly. Thank you Bill! Closes: #117383 * Made debhelper's debian/rules a lot simpler by means of the above. * Updated example rules file to use dh_install. Also some reordering and other minor changes. * dh_movefiles is lightly deprecated, and when you run into its bugs and bad design, you are incouraged to just use dh_install instead. * dh_fixperms: in v4 only, make all files in bin/ dirs +x. Closes: #119039 * dh_fixperms: in v4 only, make all files in etc/init.d executable (of course there's -X ..) * dh_link: in v4 only, finds existing, non-policy-conformant symlinks and corrects them. This has the side effect of making dh_link idempotent. * Added a -h/--help option. This seems very obvious, but it never occured to me before.. * use v4 for building debhelper itself * v4 mode is done, you may now use it without fear of it changing. (This idea of this upload is to get v4 into woody so people won't run into many issues backporting from sarge to woody later on. Packages targeted for woody should continue to use whatever compatability level they are using.)
* r515: updatesjoey2002-03-24
* r510: * Thanks to Benjamin Drieu <>, dh_installdocs -X now ↵joey2002-02-17
| | | | | | | | | | | | works. I had to modify his patch to use cp --parents, since -P spews warnings now. Also, I made it continue to use cp -a if nothing is excluded, which is both faster, and means this patch is less likely to break anything if it turns out to be buggy. Also, stylistic changes. Closes: #40649 * Implemented -X for dh_installexamples as well. * dh_clean -X substvars will also work now. Closes: #66890
* r506: * Introduced the debian/compat file. This is the new, preferred way ↵joey2002-01-27
| | | | | | | | | | | | | | | | | | | | | | to say what debhelper compatability level your package uses. It has the big advantage of being available to debhelper when you run it at the command line, as well as in debian/rules. * A new v4 feature: dh_installinit, in v4 mode, will use invoke-rc.d. This is in v4 for testing, but I may well roll it back into v3 (and earlier) once woody is released and I don't have to worry about breaking things (and, presumably, once invoke-rc.d enters policy). * Some debhelper commands will now build up a new substvars variable, ${misc:Depends}, based on things they know your package needs to depend on. For example, dh_installinit in v4 mode adds sysvinit (>= 2.80-1) to that dep list, and dh_installxfonts adds a dep on xutils. This variable should make it easier to keep track of what your package needs to depends on, supplimenting the ${shlibs:Depends} and ${perl:Depends} substvars. Hmm, this appears to be based loosely on an idea by Masato Taruishi <>, filtered through a long period of mulling it over. Closes: #76352 * Use the addsubstvar function I wrote for the above in dh_perl too.
* r502: * Fixed programmer's documentation of DOINDEP and DOARCH, Closes: ↵joey2002-01-10
| | | | | | #128546 * Fixed dh_builddeb SYNOPSIS, Closes: #128548
* r501: * Began work on v4 support (and thus the large version number ↵joey2002-01-06
| | | | | | | | | | | | | | | | | | | | | jump), and it is only for the very brave right now since I will unhesitatingly break compatability in v4 mode as I'm developing it. Currently, updating to v4 mode will only make dh_makeshlibs -V generate shared library deps that omit the debian part of the version number. The reasoning behind this change is that the debian revision should not typically break binary compatability, that existing use of -V is causing too tight versioned deps, and that if you do need to include the debian revision for some reason, you can always write it out by hand. Closes: #101497 * dh_testversion is deprecated -- use build deps instead. A warning message is now output when it runs. Currently used by: 381 packages. * dh_installxaw is deprecated -- xaw-wrappers in no longer in the distribution. A warning message is now output when it runs. Currently used by: 3 packages (bugs filed). * Added referneces to menufile in dh_installmenu man page. Closes: #127978 (dh_make is not a part of debhelper, if you want it changed, file a bug on dh-make.)
* r498: * Typo, Closes: #122679joey2001-12-21
| | | | | * Export dirname from Dh_Lib, and related cleanup, Closes: #125770 * Document dirname, basename in PROGRAMMING
* r497: this and thatjoey2001-12-11
* r493: * dh_installman: documented translated man page support, and made ↵joey2001-10-09
| | | | | | | it work properly. It was not stripping the language part from the installed filenames.
* r487: * dh_movefiles: Typo, Closes: #106532joey2001-08-23
| | | | | | | | * Use -x to test for existance of init scripts, rather then -e since we'll be running them, Closes: #109692 * dh_clean: remove debian/*.debhelper. No need to name files specifically; any file matching that is a debhelper temp file. Closes: #106514, #85520
* r482: * Spellpatch, Closes: #101553joey2001-06-21
* r475: * dh_gencontrol: Added a documented interface for specifying substvarsjoey2001-06-03
| | | | | | | | | | | | | | | data in a file. Substvars data may be put in debian/package.substvars. (Those files used to be used by debhelper for automatically generated data, but it uses a different internal filename now). It will be merged with any automatically determined substvars data. See bug #98819 * I want to stress that no one should ever rely in internal, undocumented debhelper workings. Just because debhelper uses a certian name for some internally used file does not mean that you should feel free to modify that file to your own ends in a debian package. If you do use it, don't be at all suprised when it breaks. If you find that debhelper is lacking a documented interface for something that you need, ask for it! (debhelper's undocumented, internal use only files should now all be prefixed with ".debhelper")
* r438: typojoey2001-02-10
* r420: big monsta changesjoey2001-02-09
* r407: * suidmanager is obsolete now, and so is dh_suidmanager. Instead,joey2001-01-10
| | | | | | | | | | | | packages that contain suid binaries should include the binaries suid in the .deb, and dpkg-statoverride can override this. If this is done to a program that previously used suidmanager, though, you need to conflict with suidmanager (<< 0.50). * Made dh_suidmanager check to see if it would have done anything before. If so, it states that it is obsolete, and refer users to the man page, which now explains the situation, and then aborts the build. If it would have done nothing before, it just outputs a warning that it is an obsolete program.
* r398: * If DH_COMPAT=3 is set, the following happens:joey2000-11-28
| | | | | | | | - Various debian/foo files like debian/docs, debian/examples, etc, begin to support filename globbing. use \* to escape the wildcards of course. I doubt this will bite anyone (Debian doesn't seem to contain files with "*" or "?" in their names..), but it is guarded by v3 just to be sure. Closes: #34120, #37694, #39846, #46249
* r396: working toward config file globbing support. Need to modify a bunch ofjoey2000-11-28
| | | | function, and add support for escaped stuff
* r394: * Reverted the change to make debian/README be treated as ↵joey2000-11-27
| | | | | | | | | README.Debian, after I learned people use it for eg, documenting the source package itself. Closes: #34628, since it seems this is not such an "incredibly minor" change after all. Never underetimate the annoyance of backwards-compatability.
* r392: * DH_COMPAT=3 now enables the following new features which I can't justjoey2000-11-27
| | | | | | | | | | | | | | | | | | | | | | turn on by default for fear of breaking backwards compatability: - dh_makeshlibs makes the postinst/postrm call ldconfig. Closes: #77154 Patch from Masato Taruishi <> (modified). If you use this, be sure dh_makeshlibs runs before dh_installdeb; many old rules files have the ordering backwards. - dh_installdeb now causes all files in /etc to be registered as conffiles. - debian/README is now supported: it is treated exactly like debian/README.Debian. Either file is installed as README.Debian in non-native packages, and now as just README in native packages. Closes: #34628 * This is really only the start of the changes for v3, so use with caution.. * dh_du has finally been removed. It has been deprecated for ages, and a grep of the archive shows that nothing is using it except biss-awt and scsh. I filed bugs on both almost exactly a year ago. Those bugs should now be raised to severity important.. * --number option (to dh_installemacsen) is removed. It has been deprecated for a while and nothing uses it. Use --priority instead.
* r380: * dh_builddeb: added a --filename option to specify the output ↵joey2000-10-28
| | | | | | | filename. This is intended to be used when building .udebs for the debian installer.
* r378: * dh_movefiles: fixed a regexp quoting problem with --sourcedir.joey2000-10-23
| | | | | | | | | | | | | | | | | | Closes: #75434 * Whoops, I think I overwrote bod's NMU with 2.2.15. Let's merge those in: . debhelper (2.1.14-0.1) unstable; urgency=low . * Non-maintainer upload (thanks Joey). * dh_installchangelogs, dh_installdocs: allow dangling symlinks for $TMP/usr/share/doc/$PACKAGE (useful for multi-binary packages). Closes: #53381 . -- Brendan O'Dea <> Fri, 20 Oct 2000 18:11:59 +1100 . I also added some documentation to debhelper.1 about this, and removed the TODO entry about it.
* r367: * debian/package.filename.arch is now checked for first, beforejoey2000-08-21
| | | | | | | debian/package.filename. Closes: #69453 * Added a section to debhelper(1) about files in debian/ used by debhelper, which documents this. Removed scattered references to debian/filename from all over the man pages.
* r363: good lord, did I forget to add this?joey2000-08-04
* r359: * I started work on debhelper v2 over a year ago, with a long list ofjoey2000-07-19
| | | | | | | | | | | | | | | | | | | | changes I hoped to get in that broke backwards compatability. That development stalled after only the most important change was made, although I did get out over 100 releases in the debhelper 2.0.x tree. In the meantime, lots of packages have switched to using v2, despite my warnings that doing so leaves packages open to being broken without notice until v2 is complete. * Therefore, I am calling v2 complete, as it is. Future non-compatabile changes will happen in v3, which will be started soon. This means that by using debhelper v2, one major thing changes: debhelper uses debian/<package> as the temporary directory for *all* packages; debian/tmp is no longer used to build binary packages out of. This is very useful for multi-binary packages, and I reccommend everyone switch to v2. * Updated example rules files to use v2 by default. * Updated all documentation to assume that v2 is being used. * Added a few notes for people still using v1. * Moved all of the README into debhelper(1).
* r355: merged in stuff from global todojoey2000-07-06
* r338: * Patch from Jorgen `forcer' Schaefer <forcer at> (muchjoey2000-03-02
| | | | | | | | | | | | | | | | | modified)to make dh_installwm use new window manager registration method, update-alternatives. Closes: #52156, #34684 (latter bug is obsolete) * Fixed $dh{flavor} to be upper-case. * Deprecated dh_installemavcsen --number; use --priority instead. Also, the option parser requires the parameter be a number now. And, dh_installwm now accepts --priority, and window manager packages should start using it. * dh_installwm now behaves like a proper debhelper command, and reads debian/<package>.wm too. This is a small behavior change; filenames specified on the command line no longer apply to all packages it acts on. I can't belive this program existed for 2 years with such a glaring problem; I guess most people don't need ot register 5 wm's in 3 sub-packages. Anyway, it can handle such things now. :-) * Moved Dh_*.pm to /usr/lib/perl5/Debian/Debhelper. *big* change.
* r336: * Documented that lynx is used to convert html changelogs. Closes: ↵joey2000-02-08
| | | | #54055
* r333: um.joey2000-01-17
* r326: * Type fix, Closes: #52652joey1999-12-13
* r325: * Corrected mispellings, Closes: #52013joey1999-12-06
* r316: dh_installdebfiles is no longer a part of debhelper. This affects exactlyjoey1999-11-29
| | | | | | one package in unstable, biss-awt, which has had a bug filed against it for 200+ days now asking that it stop using the program. dh_installdebfiles has been depreacted for nearly 2 years now..
* r313: testjoey1999-11-28
* r312: testjoey1999-11-28
* r311: added itemjoey1999-11-28
* r309: removed 'master'joey1999-11-23
* r308: * dh_suidregister: Die with understandable error message if asked tojoey1999-11-23
| | | | | | | | | | | | act on files that don't exist. * dh_installchangelogs: to comply with policy, if it's told to act on a html changelog, it installs it as changelog.html.gz and dumps a plain text version to changelog.gz. The dumping is done with lynx. (Closes: #51099) * Modified it so any options specified after -- are added to U_PARAMS. This means that instead of passing '-u"something nasty"' to dh_gencontrol and the like, you can pass '-- something nasty' without fiddling to get the quoting right, etc.
* r303: * Added build dependancies to this package. That was easy; it just usesjoey1999-11-05
| | | | | | | | perl5 for regression testing, the rest of its build-deps are things in base. * dh_version.1: Added note that this program is quickly becoming obsolete. * doc/README, doc/from-debstd: Added reminders that if you use debhelper, you need to add debhelper to your Build-Depends line.
* r302: * dh_shlibdeps: added -l option, which lets you specify a path thatjoey1999-11-04
| | | | | | | | | | | | | | LD_LIBRARY_PATH is then set to when dpkg-shlibdeps is run. This should make it easier for library packages that also build binary packages to be built with correct dependancies. Closes: #36751 * In honor of Burn all GIFs Day (hi Don!), I added alternative image formats .png, .jpg (and .jpeg) to the list of extentions dh_compress does not compress. Closes: #41733 * Also, made all extentions dh_compress skips be looked at case insensitively. * dh_movefiles: force owner and group of installed files to be root. Closes: #46039 * Closes: #42650, #47175 -- they've been fixed forever.
* r271: Hm.joey1999-09-11
* r266: * FHS complience. Patch from Johnie Ingram <>.joey1999-09-06
| | | | | | | | | | | | | | | For the most part, this was a straight-forward substitution, dh_installmanpages needed a non-obvious change though. * Closes: #42489, #42587, #41732. * dh_installdocs: Adds code to postinst and prerm as specified in, to make /usr/doc/<package> a compatability symlink to /usr/share/doc/<package>. Note that currently if something exists in /usr/doc/<package> when the postinst is run, it will silently not make the symlink. I'm considering more intellingent handing of this case. * Note that if you build a package with this version of debhelper, it will use /usr/share/man, /usr/share/doc, and /usr/share/info. You may need to modify other files in your package that reference the old locations.
* r189: Initial revisionjoey1999-08-17
* r84: Initial revisionjoey1999-08-17