r1750: document dh_clean removal

[debhelper.git] / doc / PROGRAMMING

diff --git a/doc/PROGRAMMING b/doc/PROGRAMMING
index 9fa79d1e579a97f53b8a56e097e5cc8b5d508ad6..8151c3ef065c15096f1c71e5a9b64db50e66233e 100644 (file)
--- a/doc/PROGRAMMING
+++ b/doc/PROGRAMMING
@@ -29,6 +29,8 @@ 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 they act on.
+The config file format should be as simple as possible, generally just a
+list of files to act on.
 
 Debhelper programs should never modify the debian/postinst, debian/prerm,
 etc scripts. Instead, they can add lines to debian/postinst.debhelper, etc. 
@@ -38,7 +40,7 @@ merge these modifications into the actual postinst scripts.
 
 In general, files named debian/*.debhelper are internal to debhelper, and
 their existence or use should not be relied on by external programs such as
-the build process of a package.
+the build process of a package. These files will be deleted by dh_clean.
 
 Debhelper programs should default to doing exactly what policy says to do.
 
@@ -136,6 +138,7 @@ switch              variable        description
 --priority     PRIORITY        will be set to a number
 --name         NAME            a name to use for installed files, instead of
                                the package name
+--error-handler        ERROR_HANDLER   a function to call on error
 
 Any additional command line parameters that do not start with "-" will be 
 ignored, and you can access them later just as you normally would.
@@ -235,6 +238,10 @@ delsubstvar($package, $substvar)
 excludefile($filename)
        This function returns true if -X has been used to ask for the file
        to be excluded.
+is_udeb($package)
+       Returns true if the package is marked as a udeb in the control
+       file.
+udeb_filename($package)
+       Returns the filename of the udeb package.
 
 -- Joey Hess <joeyh@debian.org>
-