From a7afc7fccd48b73037a32e511a219016ba9fee17 Mon Sep 17 00:00:00 2001 From: joey Date: Wed, 19 Jul 2000 00:33:24 +0000 Subject: r359: * I started work on debhelper v2 over a year ago, with a long list of 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/ 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). --- doc/README | 74 +------------------------------------------------------------- 1 file changed, 1 insertion(+), 73 deletions(-) (limited to 'doc/README') diff --git a/doc/README b/doc/README index 93351579..6ae07976 100644 --- a/doc/README +++ b/doc/README @@ -1,74 +1,2 @@ -Debhelper is a collection of programs that can be used in debian/rules files -to automate common tasks related to building debian binary packages. For -further documentation, see the man pages for dh_* commands. For an overview -of debhelper, including a list of all the available commands, see the -debhelper(1) man page. - -To help you get started, I've included examples of debian/rules files -that use debhelper commands extensively. See -/usr/share/doc/debhelper/examples/ . These files are also useful as they give -one good order you can run the various debhelper scripts in (though other -variations are possible). - -For a more gentle introduction, the maint-guide debian package contains a -tutorial about making your first package using Debhelper. - -Debhelper v2: ------------- - -Debhelper v2 is a major new version of Debhelper, still under development. -Debhelper will continue to work in v1 compatability mode for now, if you're -interested in trying the new versiln, read the file named "v2". - -Starting a new package: ----------------------- - -You can just use the example rules files and do the rest of the new package -set up by hand, or you could try the dh-make package, which contains a -"dh_make" command that is similar to debmake, and tries to automate the -process. - -Converting from debstd to debhelper: ------------------------------------ - -See the file "from-debstd" for documentation on how to do this. - -Automatic generation of debian install scripts: ----------------------------------------------- - -Some debhelper commands will automatically generate parts of debian install -scripts. If you want these automatically generated things included in your -debian install scripts, then you need to add "#DEBHELPER#" to your scripts, -in the place the code should be added. "#DEBHELPER#" will be replaced by any -auto-generated code when you run dh_installdeb. - -All scripts that automatically generate code in this way let it be disabled -by the -n parameter. - -Note that it will be shell code, so you cannot directly use it in a perl -script. If you would like to embed it into a perl script, here is one way to -do that (note that I made sure that $1, $2, etc are set with the set command): - -my $temp="set -e\nset -- @ARGV\n" . << 'EOF'; -#DEBHELPER# -EOF -system ($temp) / 256 == 0 - or die "Problem with debhelper scripts: $!\n"; - -Other notes: ------------ - -* Note that if you are generating a debian package that has arch-indep and - arch-dependent portions, and you are using dh_movefiles to move the - arch-indep files out of debian/tmp, you need to make sure that dh_movefiles - does this even if only the arch-dependent package is being built (for ports - to other architectures). I handle this in debian/rules.multi by calling - dh_movefiles in the install target. - -* Once your package uses debhelper to build, be sure to add - debhelper to your Build-Depends line in debian/control. - -* Debhelper's home page is at http://kitenet.net/programs/debhelper/ - --- Joey Hess +Please see the debhelper(1) man page for documentation. -- cgit v1.2.3