r1988: releasing version 5.0.45

[debhelper.git] / doc / PROGRAMMING

diff --git a/doc/PROGRAMMING b/doc/PROGRAMMING
index 8151c3ef065c15096f1c71e5a9b64db50e66233e..97f85650f5c6bb2e420ac4cdc644f389e894cc0c 100644 (file)
--- a/doc/PROGRAMMING
+++ b/doc/PROGRAMMING
@@ -93,13 +93,18 @@ switch              variable        description
                                packages
 -n             NOSCRIPTS       if set, do not make any modifications to the 
                                package's postinst, postrm, etc scripts.
+-o             ONLYSCRIPTS     if set, only make modifications to the
+                               package's scripts, but don't look for or
+                               install associated files.
 -X             EXCLUDE         exclude a something from processing (you
                                decide what this means for your program)
                                (This is an array)
                 EXCLUDE_FIND   same as DH_EXCLUDE, except all items are put
                                into a string in a way that they will make
                                find find them. (Use ! in front to negate
-                               that, of course)
+                               that, of course) Note that this should
+                               only be used inside complex_doit(), not in
+                               doit().
 -x             INCLUDE_CONFFILES
                                include conffiles. It's -x for obscure
                                historical reasons.
@@ -139,6 +144,8 @@ switch              variable        description
 --name         NAME            a name to use for installed files, instead of
                                the package name
 --error-handler        ERROR_HANDLER   a function to call on error
+--language     LANGUAGE        specify what language a file is in
+--add-udeb     SHLIBS_UDEB     used by dh_makeshlibs
 
 Any additional command line parameters that do not start with "-" will be 
 ignored, and you can access them later just as you normally would.
@@ -215,6 +222,8 @@ autoscript($package, $scriptname, $snippetname, $sedcommands)
           (optional)
        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
+       order for the removal scripts.
 dirname($pathname)
        Return directory part of pathname.
 basename($pathname)
@@ -243,5 +252,12 @@ is_udeb($package)
        file.
 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.
+       As a side effect, populates %package_arches and %package_types with
+       the types of all packages (not only those returned).
 
 -- Joey Hess <joeyh@debian.org>