Notes For Developers

====================

This document describes a few basic tasks for managing the codebase;

see http://wiki.zmanda.com/ for more detailed developer-oriented

documentation.

Adding Gnulib Modules

---------------------

Edit the clearly marked section in gnulib/regenerate/regenerate,

then re-run that script as directed below.

Updating Gnulib

---------------

This should probably be done after most releases, so that we have

adequate time to uncover any bugs or problems in the new gnulib before

we make another release.

To update the gnulib files included with Amanda, you'll first need a git

working copy of gnulib; let's call it $GNULIB_BR:

  cd /tmp

  git clone git://git.savannah.gnu.org/gnulib.git

  GNULIB_BR=/tmp/gnulib

See http://www.gnu.org/software/gnulib/ for more information.  Then, in the

root of the Amanda source, run

  GNULIB_TOOL=$GNULIB_BR/gnulib-tool ./gnulib/regenerate/regenerate

Use 'svn status' to figure out what changed, and 'svn add' / 'svn rm'

to inform Subversion.  Then re-run autogen, configure, make, and test

the result.

Get the object ID of the latest commit, using 'git show', and replace the

previous object ID in Amanda's gnulib/regenerate/regenerate, so that other

developers can access the same "release" of gnulib as you did.

Updating Libtool

----------------

Libtool includes such useful files as config/config.guess.

Occasionally (probably right after a release), these files should be

updated.  On a machine with libtool installed, simply run 

  libtoolize --force --copy

Then use 'svn status' to see what changed, test it out, and commit.

Updating Gettext

----------------

The gettext library contains a significant number of files.  Assuming

you have the proper version of gettext installed, these files can be

updated by running

  po/reautopoint

and then adjusting as appropriate with 'svn add' / 'svn rm', testing,

and committing.  Note that this script post-processes the results of

autopoint rather extensively, and will probably need to be adjusted

for a new version of autopoint.