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 brief 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 * install-info, as of dpkg 1.10, parses the info file for section if
  34   --section is not given. So I should be able to stop parsing it myself for
  35   section, after dpkg 1.10 has been around long enough.
  36
  37 v5:
  38
  39 * comments in config files
  40 * escaping in config files (for whitespace)?
  41 * make dh_installman set up slave links, always assuming wm and man page
  42   are in same area (/usr/bin and /usr/share/man, or /usr/X11/). Or, if the
  43   .1x extension stuff is a problem, only look for man pages in
  44   /usr/share/man. #85963
  45
  46 Deprecated:
  47
  48 * DH_COMPAT 1. Can be removed once all packages are seen to be using 2 or
  49   higher. I won't hold my breath.
  50 * Also, grep the entire archive for all dh_* command lines (I do this now),
  51   and check to see what other switches are not being used, and maybe remove
  52   some of them. I'd also like to deprecate/remove debian/compress files, -X is
  53   a better idea.
  54 * dh_suidregister. Once nothing in the archive uses it.
  55 * dh_installmanpages.
  56 * dh_testversion. Remove as soon as nothing uses it.
  57 * dh_movefiles. I won't hold my breath.
  58 * debconf-mergetemplates support and the debian/template.ll files and the
  59   debconf-utils dependency.
  60 * dh_undocumented
  61 * dh_installinit --init-script