doc/TODO

   1 This is the TODO for debhelper. As more and more people use debhelper, this
   2 list grows - I welcome patches to fix items on it!
   3
   4 Wishlist items:
   5
   6 * All debhelper programs should only accept the options they are documented
   7   to accept (rather than accepting all debhelper options). They should
   8   be able to print breif usage summaries.
   9
  10   I think this calls for a restucturing. Make a Debhelper.pm class. Each
  11   program subclasses the class. The class provides command line parsing,
  12   useful functions, and so on. Skeleton of a debhelper command would then
  13   be:
  14
  15   use base qw{Debhelper};
  16
  17   sub startup {
  18         # Add initialization stuff here.
  19   }
  20
  21   sub perpackage {
  22         my $package=shift;
  23
  24         # Stuff to do for each package here.
  25   }
  26
  27   sub fini {
  28         # And final stuff here, if any.
  29   }
  30
  31   This needs more thought.
  32
  33 * All debhelper programs should be checked that they output files with the
  34   correct permissions no matter what the umask is set to. Currently, only
  35   those programs that run after dh_fixperms have been so checked. (Checking
  36   the rest is low priority, since dh_fixperms fixes any incorrect permissions
  37   they might have; still it would be nice to check them too, just to make
  38   debhelper more flexible.) One easy fix is to add umask 022 to dh_lib,
  39   however, there may be unforeseen ramifications of such a change.
  40 * All programs should also make sure the files they install are owned by
  41   root.root. Situation is currently the same as with permissions above, plus
  42   dh_installchangelogs is fixed.
  43 * Need a way to make dh_strip not strip any static libs. Also, it'd be nice
  44   if there were options to dh_strip, dh_compress, etc, to allow inclusion of
  45   directories and exclusion of files based on filename globbing. (Request from
  46   Matthias Klose <doko@cs.tu-berlin.de>)
  47 * Support use of environment variables in data taken from user, ie, in
  48   debian/dirs. The problem with doing this is that we really want to allow
  49   any filenames in that input, even those that look like environment
  50   variables. However, it may be worth adding a switch to make it parse
  51   environment variables. (#20964)
  52 * It's possible to speed up debhelper by having it cache some values that
  53   multiple commands call. One way to do this would be to write dh_cache,
  54   that generates the cache. The catch is that if the user runs that program,
  55   they are stating that they don't do anything later to invalidate the cache,
  56   without calling ch_cache again. (#23792)
  57 * Add a switch to dh_installdeb to allow it to do user defined
  58   substitutions. OTOH, maybe it's better if people just sed
  59   postinst.in before debhelper gets it's hands on it... (#25235)
  60 * objdump -p can get the soname of a library, try using that in dh_shlibs
  61   instead of parsing filenames.
  62
  63 Deprecated:
  64
  65 * DH_COMPAT 1. Can be removed once all packages are seen to be using 2 or
  66   higher. I won't hold my breath.
  67 * Also, grep the entire archive for all dh_* command lines, and check to
  68   see what other switches are not being used, and maybe remove some of
  69   them. I'd also like to depercate/remove debian/compress files, -X is
  70   a better idea.
  71 * dh_suidregister. Once nothing in the archive uses it.
  72 * dh_installmanpages. Only mildly deprecated right now. Once dh_installman
  73   catches on, make it emit a warning, and then wait for it to go away.
  74 * dh_testversion. Only mildly deprecated right now. Make it emit a warning
  75   by jan 2002, and remove as soon as nothing uses it.