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 git
  22 working copy of gnulib; let's call it $GNULIB_BR:
  23
  24   cd /tmp
  25   git clone git://git.savannah.gnu.org/gnulib.git
  26   GNULIB_BR=/tmp/gnulib
  27
  28 See http://www.gnu.org/software/gnulib/ for more information.  Then, in the
  29 root of the Amanda source, run
  30
  31   GNULIB_TOOL=$GNULIB_BR/gnulib-tool ./gnulib/regenerate/regenerate
  32
  33 Use 'svn status' to figure out what changed, and 'svn add' / 'svn rm'
  34 to inform Subversion.  Then re-run autogen, configure, make, and test
  35 the result.
  36
  37 Get the object ID of the latest commit, using 'git show', and replace the
  38 previous object ID in Amanda's gnulib/regenerate/regenerate, so that other
  39 developers can access the same "release" of gnulib as you did.
  40
  41 Updating Libtool
  42 ----------------
  43
  44 Libtool includes such useful files as config/config.guess.
  45 Occasionally (probably right after a release), these files should be
  46 updated.  On a machine with libtool installed, simply run
  47   libtoolize --force --copy
  48
  49 Then use 'svn status' to see what changed, test it out, and commit.
  50
  51 Updating Gettext
  52 ----------------
  53
  54 The gettext library contains a significant number of files.  Assuming
  55 you have the proper version of gettext installed, these files can be
  56 updated by running
  57
  58   po/reautopoint
  59
  60 and then adjusting as appropriate with 'svn add' / 'svn rm', testing,
  61 and committing.  Note that this script post-processes the results of
  62 autopoint rather extensively, and will probably need to be adjusted
  63 for a new version of autopoint.