X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;ds=sidebyside;f=doc%2FPROGRAMMING;h=b6d3d16e231aeaa9c744290667cddc4f0b271d21;hb=578c2257acdde4d97fc3b582bf7d146bd117d1e2;hp=211e57eef9570472a0c32fe8705f4d8a19a5c51f;hpb=391a6c42bc528de0e3ba34874346d290054f517e;p=debhelper.git

diff --git a/doc/PROGRAMMING b/doc/PROGRAMMING
index 211e57e..b6d3d16 100644
--- a/doc/PROGRAMMING
+++ b/doc/PROGRAMMING
@@ -216,9 +216,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.
@@ -232,9 +233,11 @@ udeb_filename($package)
 	Returns the filename of the udeb package.
 getpackages($type)
 	Returns a list of packages in the control file.
-	Must pass "arch" or "indep" or "same" to specify arch-dependent or
-	-independent or same arch packages. If nothing is specified, returns all
-	packages.
+	Pass "arch" or "indep" to specify arch-dependent or
+	-independent. If nothing is specified, returns all
+	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()
@@ -281,8 +284,7 @@ remove_command_options($command)
 
 remove_command_options($command, $opt1, $opt2, ...)
 	Remove $opt1, $opt2 etc. from the list of additional options which
-	dh passes when running the specified $command. $optX might be a string
-	or a regular expresion.
+	dh passes when running the specified $command.
 
 Buildsystem Classes:
 -------------------