Fix typo in French translation, about debian/package.README.Debian files.

[debhelper.git] / doc / TODO

diff --git a/doc/TODO b/doc/TODO
index 188e3c6c7bb9a0b4f502018c7e9058d049f8b678..18cdb903e1ec76387e07410a4789be6600c604c1 100644 (file)
--- a/doc/TODO
+++ b/doc/TODO
@@ -1,26 +1,58 @@
-* add all other functionality of debstd (??)
-  - add a program to generate file similar to buildinfo.Debian generated by
-    debmake (wishlist bug #17043). I just never saw the point of that file..
-  - Make dh_movefiles remove emptied directories after it's moved all the
-    files out of them (wishlist bug #17111).
-* 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 fragements wouldn't go into the postinst. So maybe a
-  new script is called for.
-* info support for debhelper (currently implemented, but I hate how I did it,
-  so it's not in the package.) (wishlist bug #15717)
-* 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.
-* 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 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
-  the rest is low priority, since dh_fixperms fixes any incorrect permissions
-  they might have; still it would be nice to check them too, just to make
-  debhelper more flexible.) One easy fix is to add umask 022 to dh_lib,
-  however, there may be unforeseen ramifications of such a change.
+This is the TODO for debhelper. As more and more people use debhelper, this
+list grows - I welcome patches to fix items on it!
+
+Wishlist items:
+
+* 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 brief usage summaries.
+
+  I think this calls for a restructuring. 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.
+  
+v8:
+
+* escaping in config files (for whitespace)?
+* make dh_install use hard links for efficiency
+* dh_installinit --restart-after-upgrade as default?
+* #487006: dh_installman with 3-letter codes
+
+Deprecated:
+
+* DH_COMPAT 1, 2, 3. Can be removed once all packages are seen to be using
+  a newer version. I won't hold my breath. Now with evil warning messages
+  though.
+* Also, grep the entire archive for all dh_* command lines,
+  and check to see what other switches are not being used, and maybe remove
+  some of them. I'd also like to deprecate/remove debian/compress files, -X is
+  a better idea.
+* dh_suidregister. Once nothing in the archive uses it.
+* dh_installmanpages.
+* dh_testversion. Remove as soon as nothing uses it.
+* dh_movefiles. I won't hold my breath.
+* debconf-mergetemplates support and the debian/template.ll files and the
+  debconf-utils dependency.
+* dh_undocumented
+* dh_installinit --init-script
+* dh_python
+* dh_clean -k (make it warn)