git.gag.com Git - debian/amanda/blob - DEVELOPING

   1 Notes For Developers
   2 ====================
   3
   4 This document describes a few basic tasks for managing the codebase;
   5 see http://wiki.zmanda.com/ for more detailed developer-oriented
   6 documentation.
   7
   8 Adding Gnulib Modules
   9 ---------------------
  10
  11 Edit the clearly marked section in gnulib/regenerate/regenerate,
  12 then re-run that script as directed below.
  13
  14 Updating Gnulib
  15 ---------------
  16
  17 This should probably be done after most releases, so that we have
  18 adequate time to uncover any bugs or problems in the new gnulib before
  19 we make another release.
  20
  21 To update the gnulib files included with Amanda, you'll first need a
  22 CVS checkout of gnulib; let's call it $GNULIB_CO.  Then, in the root
  23 of the Amanda source, run
  24
  25   GNULIB_TOOL=$GNULIB_CO/gnulib-tool ./gnulib/regenerate/regenerate
  26
  27 Use 'svn status' to figure out what changed, and 'svn add' / 'svn rm'
  28 to inform Subversion.  Then re-run autogen, configure, make, and test
  29 the result.  If all is well, commit.
  30
  31 Updating Libtool
  32 ----------------
  33
  34 Libtool includes such useful files as config/config.guess.
  35 Occasionally (probably right after a release), these files should be
  36 updated.  On a machine with libtool installed, simply run
  37   libtoolize --force --copy
  38
  39 Then use 'svn status' to see what changed, test it out, and commit.
  40
  41 Updating Gettext
  42 ----------------
  43
  44 The gettext library contains a significant number of files.  Assuming
  45 you have the proper version of gettext installed, these files can be
  46 updated by running
  47
  48   po/reautopoint
  49
  50 and then adjusting as appropriate with 'svn add' / 'svn rm', testing,
  51 and committing.  Note that this script post-processes the results of
  52 autopoint rather extensively, and will probably need to be adjusted
  53 for a new version of autopoint.