r506: * Introduced the debian/compat file. This is the new, preferred way to say

[debhelper.git] / doc / TODO

diff --git a/doc/TODO b/doc/TODO
index 64215b7a7c9be303a42d2c8f22f85fec2be394fa..548a394958c1a2e3e3067330a12c227bc848c52d 100644 (file)
--- a/doc/TODO
+++ b/doc/TODO
@@ -3,18 +3,33 @@ list grows - I welcome patches to fix items on it!
 
 Wishlist items:
 
 
 Wishlist items:
 

-* Move the perl libs into the correct perl lib dirs. Makes all debehelper
-  scripts shorter..
-* Make dh_* "use strict".
-* Make dh_movefiles remove emptied directories after it's moved all the
-  files out of them (#17111).
-* enhance dh_installmanpages so it associates binaries and man pages and
-  installs the man pages into the correct areas to suit the binaries they
-  document. I may need to make this only happen when a switch is given, to
-  preserve backward compatibility. (#16933, #17061)
-* maybe make dh_installmanpages look at the .TH line of man pages whose
-  filenames end in .man, to figure out what section they go it. This would
-  require a switch to turn on, for backwards compatibility.
+* All debhelper programs should only accept the options they are documented
+  to accept (rather than accepting all debhelper options). They should
+  be able to print breif usage summaries.
+
+  I think this calls for a restucturing. Make a Debhelper.pm class. Each
+  program subclasses the class. The class provides command line parsing,
+  useful functions, and so on. Skeleton of a debhelper command would then
+  be:
+
+  use base qw{Debhelper};
+
+  sub startup {
+       # Add initialization stuff here.
+  }
+
+  sub perpackage {
+       my $package=shift;
+
+       # Stuff to do for each package here.
+  }
+
+  sub fini {
+       # And final stuff here, if any.
+  }
+
+  This needs more thought.
+  

 * All debhelper programs should be checked that they output files with the
   correct permissions no matter what the umask is set to. Currently, only
   those programs that run after dh_fixperms have been so checked. (Checking
 * All debhelper programs should be checked that they output files with the
   correct permissions no matter what the umask is set to. Currently, only
   those programs that run after dh_fixperms have been so checked. (Checking


@@ -25,16 +40,6 @@ Wishlist items:
 * All programs should also make sure the files they install are owned by
   root.root. Situation is currently the same as with permissions above, plus
   dh_installchangelogs is fixed.
 * All programs should also make sure the files they install are owned by
   root.root. Situation is currently the same as with permissions above, plus
   dh_installchangelogs is fixed.

-* something should add ldconfig calls properly to the postinst of packages
-  that contain shared libraries. maybe dh_makeshlibs? But it wasn't designed
-  to do that originally, and even worse, it is often run after
-  dh_installdeb, so the fragments wouldn't go into the postinst. So maybe a
-  new script is called for. But it's probably be best to just have a switch
-  to enable this.
-* Need a way to make dh_strip not strip any static libs. Also, it'd be nice
-  if there were options to dh_strip, dh_compress, etc, to allow inclusion of
-  directories and exclusion of files based on filename globbing. (Request from
-  Matthias Klose <doko@cs.tu-berlin.de>)

 * Support use of environment variables in data taken from user, ie, in
   debian/dirs. The problem with doing this is that we really want to allow
   any filenames in that input, even those that look like environment
 * Support use of environment variables in data taken from user, ie, in
   debian/dirs. The problem with doing this is that we really want to allow
   any filenames in that input, even those that look like environment


@@ -44,15 +49,33 @@ Wishlist items:
   multiple commands call. One way to do this would be to write dh_cache,
   that generates the cache. The catch is that if the user runs that program,
   they are stating that they don't do anything later to invalidate the cache,
   multiple commands call. One way to do this would be to write dh_cache,
   that generates the cache. The catch is that if the user runs that program,
   they are stating that they don't do anything later to invalidate the cache,

-  without calling ch_cache again. (#23792)
+  without calling dh_cache again. (#23792)

 * Add a switch to dh_installdeb to allow it to do user defined
   substitutions. OTOH, maybe it's better if people just sed
   postinst.in before debhelper gets it's hands on it... (#25235)
 * Add a switch to dh_installdeb to allow it to do user defined
   substitutions. OTOH, maybe it's better if people just sed
   postinst.in before debhelper gets it's hands on it... (#25235)

+* dh_installdocs needs -X support, which probably means going with tar
+  instead of cp -a. Ugh.
+
+v4:
+
+See debhelper's man page for what's implemented so far.
+
+These items are planned:
+
+* Maybe make dh_fixperms make all files in bin/ dirs +x. (#119039)

 
 Deprecated:
 
 
 Deprecated:
 

-* remove dh_installdebfiles, dh_du. 
-  - need to wait a reasonable length of
-    time. I'm currently planning on doing this after slink is released or
-    one year after they were deprecated, whichever comes first. Be sure to
-    grep whole debian archive for all of them before removing them, though!
+* DH_COMPAT 1. Can be removed once all packages are seen to be using 2 or
+  higher. I won't hold my breath.
+* Also, grep the entire archive for all dh_* command lines (I do this now),
+  and check to see what other switches are not being used, and maybe remove
+  some of them. I'd also like to depercate/remove debian/compress files, -X is
+  a better idea.
+* dh_suidregister. Once nothing in the archive uses it.
+* dh_installmanpages. Only mildly deprecated right now. Once dh_installman
+  catches on, make it emit a warning, and then wait for it to go away.
+* dh_testversion. Remove as soon as nothing uses it.
+* dh_installxaw. xaw replacments are dying, nothing uses it validly (bugs
+  filed on the few packages that use it by accident). Remove as soon as
+  nothing uses it, or by april 2002.