X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=doc%2FPROGRAMMING;h=e1440c91e46451c8c0ab10b53d054d7ebb768921;hb=a3494762925e5a42a42ce82c688f62f163ffad1b;hp=0fca4722019a3efb6c9285ab5686b0f02c2b02e4;hpb=d8edabf803f9e687cd2a626a6b28c921a0c645ab;p=debhelper.git

diff --git a/doc/PROGRAMMING b/doc/PROGRAMMING
index 0fca472..e1440c9 100644
--- a/doc/PROGRAMMING
+++ b/doc/PROGRAMMING
@@ -191,13 +191,16 @@ isnative($package)
 	is a native debian package.
 	As a side effect, $dh{VERSION} is set to the version number of the
 	package.
-autoscript($package, $scriptname, $snippetname, $sedcommands)
+autoscript($package, $scriptname, $snippetname, $sedcommands || $sub)
 	Pass parameters:
 	 - binary package to be affected
 	 - script to add to
 	 - filename of snippet
-	 - sed commands to run on the snippet. Ie, s/#PACKAGE#/$PACKAGE/
-	   (optional)
+	 - (optional) EITHER sed commands to run on the snippet. Ie,
+	   s/#PACKAGE#/$PACKAGE/ Note: Passed to the shell inside double
+           quotes.
+	   OR a perl sub to invoke with $_ set to each line of the snippet in
+           turn.
 	This command automatically adds shell script snippets to a debian
 	maintainer script (like the postinst or prerm).
 	Note that in v6 mode and up, the snippets are added in reverse
@@ -216,9 +219,10 @@ addsubstvar($package, $substvar, $deppackage, $verinfo, $remove)
 	- version info for the package (optional) (ie: ">= 1.1")
 	- if this last parameter is passed, the thing that would be added
 	  is removed instead. This can be useful to ensure that a debhelper
-	  command is idempotent. Note that without this parameter, if you
-	  call the function twice with the same values it will only add one
-	  item to the substvars file.
+	  command is idempotent. (However, we generally don't bother,
+	  and rely on the user calling dh_prep.) Note that without this
+	  parameter, if you call the function twice with the same values it
+	  will only add one item to the substvars file.
 delsubstvar($package, $substvar)
 	This function removes the entire line for the substvar from the
 	package's shlibs file.
@@ -234,7 +238,9 @@ getpackages($type)
 	Returns a list of packages in the control file.
 	Pass "arch" or "indep" to specify arch-dependent or
 	-independent. If nothing is specified, returns all
-	packages.
+	packages (including packages that are not built
+	for this architecture). Pass "both" to get the union
+	of "arch" and "indep" packages.
 	As a side effect, populates %package_arches and %package_types with
 	the types of all packages (not only those returned).
 inhibit_log()