From 8c6662502a915d99f4142110b613bf616f9d0326 Mon Sep 17 00:00:00 2001 From: joey Date: Tue, 17 Aug 1999 04:48:52 +0000 Subject: [PATCH] r71: Initial Import --- PROGRAMMING | 24 ++++++++++++------------ README | 4 ++-- TODO | 4 +--- debian/changelog | 6 ++++++ 4 files changed, 21 insertions(+), 17 deletions(-) diff --git a/PROGRAMMING b/PROGRAMMING index dcef3ed..c290c34 100644 --- a/PROGRAMMING +++ b/PROGRAMMING @@ -21,12 +21,12 @@ Debhelper programs should accept the options, -v, -i, -a, -p, --no-act, and options may be ignored. If debhelper commands need config files, they should use -debian/package.filename as the name of the confile file (replace filename +debian/package.filename as the name of the config file (replace filename with whatever your command wants), and debian/filename should also be -checked for config information for the first binart package in +checked for config information for the first binary package in debian/control. Also, debhelper commands should accept the same sort of information that appears in the config files, on their command lines, if -possible, and apply that information to the first package thay act on. +possible, and apply that information to the first package they act on. Debhelper programs should never modify the debian/postinst, debian/prerm, etc scripts, instead, they can add lines to debian/postinst.debhelper, etc. @@ -36,7 +36,7 @@ merge these modifications into the actual postinst scripts. There are always exceptions. Just ask me. -Intoroducing dh_lib: +Introducing dh_lib: ------------------- All debhelper programs use the dh_lib library (actually it's a shell script) @@ -51,13 +51,13 @@ PATH=debian:$PATH:/usr/lib/debhelper The path statement is there to make your program look first in debian/ for dh_lib (so users can install a modified version there if necessary), then the -rest of the path, then the canoical location of dh_lib, /usr/lib/debhelper. +rest of the path, then the canonical location of dh_lib, /usr/lib/debhelper. Argument processing: ------------------- -All debhelper programs should respond to certian arguemnts, such as -v, -i, --a, and -p. To help you make this work right, dh_lib handles argumeny +All debhelper programs should respond to certain arguments, such as -v, -i, +-a, and -p. To help you make this work right, dh_lib handles argument processing. As soon as dh_lib loads, it processes any arguments that have been passed to @@ -70,12 +70,12 @@ switch variable description --no-act DH_NO_ACT should the program not actually do anything? -i,-a,-p DH_DOPACKAGES a space delimited list of the binary packages to act on --i,-p DH_DOINDEP a space delimited list of the binary independant +-i,-p DH_DOINDEP a space delimited list of the binary independent packages to act on --a,-p DH_DOARCH a space delimited list of the binary dependant +-a,-p DH_DOARCH a space delimited list of the binary dependent packages to act on -n DH_NOSCRIPTS if set, do not make any modifications to the - package's postinst, posrtm, etc scripts. + package's postinst, postrm, etc scripts. -x DH_EXCLUDE exclude a something from processing (you decide what this means for your program) -d DH_D_FLAG you decide what this means to your program @@ -115,7 +115,7 @@ The following variables are also set, you can use any of them: MAINPACKAGE the name of the first binary package listed in debian/control DH_FIRSTPACKAGE the first package we were instructed to act on. This package - typically gets special tratment, addiiional arguments + typically gets special treatment, additional arguments specified on the command line may effect it. Functions: @@ -147,7 +147,7 @@ pkgfile() file, and it will return the actual filename to use. This is used for allowing debhelper programs to have configuration files in the debian/ directory, so there can be one config file per binary - package. The conversion is that the files are named + package. The convention is that the files are named debian/package.filename, and debian/filename is also allowable for the MAINPACKAGE. If the file does not exist, nothing is returned. pkgext() diff --git a/README b/README index fc9f95d..ae0e53a 100644 --- a/README +++ b/README @@ -51,7 +51,7 @@ were using debstd -m to tell it not to automatically install manpages, for example, you can just comment out the dh_installmanpages line. Finally, debstd automatically modified postinst, postrm, etc scripts. Some -of the dehelper apps do that too, but they do it differently. Debstd just +of the debhelper apps do that too, but they do it differently. Debstd just appends its commands to the end of the script. Debhelper requires that you insert a tag into your scripts, that will tell debhelper where to insert commands. So if you have postinst, postrm, etc scripts, add a line reading @@ -70,7 +70,7 @@ 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 -autogenerated code when you run dh_installdeb. +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. diff --git a/TODO b/TODO index 3e34c07..a6646b1 100644 --- a/TODO +++ b/TODO @@ -3,15 +3,13 @@ debmake (wishlist bug #17043). I just never saw the point of that file.. - Make dh_movefiles remove emptied directories after it's moved all the files out of them (wishlist bug #17111). - - .so files of compressed manpages -- change to symlinks. Policy says we - need only do this "if it's easy". The hard bit is implementing it ;-) * dh_fixperms: allow listing of files not to be touched (diffucult). * add a dh_debstd, which mimics debstd, but uses debhelper tools internally. Note thatthe idea here is not just another debstd. This program will have a -v switch, that lists all the other debhelper commands it needs to run to do what debstd had to do. The intent is to make it easy to switch from debstd to debhelper. -* dh_compress: add --exclude "*.conf" type-thingy, sincethat's the change +* dh_compress: add --exclude "*.conf" type-thingy, since that's the change you most often want to make to what it does, and a debian/conpress file is overkill in those cases. * info support for debhelper (currently implmented, but I hate how I did it, diff --git a/debian/changelog b/debian/changelog index f3219be..db3a28f 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,3 +1,9 @@ +debhelper (0.73) unstable; urgency=low + + * Fixed typo in dh_suidregister.1 + + -- Joey Hess Thu, 12 Mar 1998 16:30:27 -0800 + debhelper (0.72) unstable; urgency=low * Applied patch from Yann Dirson to add a -- 2.39.5