TODO

   1 Top priorities:
   2 * Fix up how 'clean' targets are handled (they should be handled like
   3   install, etc)
   4 * Make installdirs target.
   5
   6 Consider a --install-missing option to install missing files such as
   7 mdate-sh, texinfo.tex, etc.
   8
   9 Prettyprint macro definitions, eg:
  10         DIST_COMMON = Makefile.in Makefile.am \
  11         foo bar baz
  12
  13 It might be cool to generate .texi dependencies by grepping for
  14 @include.  (If done, it should be done the same way C dependency is
  15 done)
  16
  17 Rename --include-deps to --insert-deps?
  18
  19 Merge common parts of "dist" targets into dist-local.
  20
  21 It would be good to check some parts of GNU standards.  Already check
  22 for install-sh and mkinstalldirs.  What else is required to be in
  23 package by GNU standards or by automake?
  24
  25 Maybe it should be possible to disable all GNU-specific things with
  26 --no-gnu? --ignore-standards?  But what?  And why?
  27
  28 Think about modifications so automake can work with a standalone
  29 library, eg readline.  For instance we need a way to install a
  30 library, and a way to install header files.  It would also be nice to
  31 figure out some good way to deal with shared libs.  When doing this,
  32 make sure kpathsea can also be handled.
  33
  34 Allow ".h" files to appear in blah_SOURCES; just write them out of
  35 existence.  [ This is nixed for now because of the auto-dependency
  36 tracking stuff ]
  37
  38 should have (moral equivalent of) "all:: info" in texinfos.am?
  39
  40 automake.in: should ".cc" really -> ".${kr}o"?  This doesn't really
  41 seem right, but maybe it is so names can be rewritten uniformly?  Must
  42 check
  43
  44 automake.in should disallow setting of LC_ALL and LANG variables by
  45 Makefile.am. (?)
  46
  47 consider auto-including any file that matches "*.in".
  48   [ no: po/Makefile.in shouldn't be included ]
  49
  50 must look at mkid to see how it works (for subdir usage)
  51   [ right now, it doesn't.  i don't see a simple fix right now ]
  52
  53 clean.am: clean: if all the macros are empty, the rule expands to:
  54         rm -rf
  55 which should be fixed
  56
  57 Internationalize. [ gettext doesn't have the necessary machinery yet ]
  58
  59 ================================================================
  60
  61 For CONFIG_HEADER,
  62   automatically add its input file to the distribution.
  63
  64 Don't hardcode the name of the configuration header.  Get it from
  65 configure.in (AC_CONFIG_HEADER).
  66
  67 Get the list of Makefiles to create from configure.in AC_OUTPUT
  68 if none are given.
  69         [ right now we look for any Makefile.am's lying around
  70           I think this is better, because it allows use of subdirs
  71           which don't use automake -- eg, stuff from gettext ]
  72
  73 Should libexec programs have the name transform done on them?
  74
  75 Order the output rules sensibly, so FOO_SOURCES and FOO_OBJECTS are
  76 together and rules are in the usual order.
  77
  78 Make the output minimal: only output definitions for variables that
  79 are used.
  80
  81 Look at dist's jmake for ideas.  [what is this?]
  82
  83 Should handle directory hierarchies deeper than 2.  Right now there is
  84 no support for this at all.
  85
  86 ================================================================
  87
  88 Known Bugs:
  89
  90 version.texi handling is broken -- it assumes you only have one .texi
  91 file per directory.
  92    (*) In any case, the UPDATED information would be different for
  93    each .texi file included in a package -- that is my problem.
  94    Now, if no package will ever have more than one .texi file
  95    (in a given directory), I can just stop worrying about it.
  96
  97 If there is ever more than one, we will need to change the name of
  98 'version.texi' to be based on the name of the primary .texi file.
  99 Will have to be careful here not to violate MS-DOS name limits.  Also
 100 will need more than one stamp-vti.
 101
 102
 103 ================================================================
 104
 105 Document:
 106
 107
 108 Defined variables, their meanings, and their effects:
 109
 110 DEFS           cpp definitions
 111 INCLUDES       -I options to cpp
 112 CPPFLAGS       more cpp flags
 113 CFLAGS         flags to cc
 114 COMPILE        how to compile a C program
 115 LINK           how to link a C program
 116
 117 DIST_SUBDIRS   directories which are copied verbatim into the
 118                distribution.  Used eg for directories holding
 119                only example code (which don't have their own
 120                makefile).  This variable might be a bad idea.