Libiberty development files are now included in libiberty-dev, rather
than binutils-dev.

* INSTALL (QUICK SUMMARY): Update accordingly.

Fixes issue 85

installed, you need to also have Python.h installed before building distcc.

Reviewer: Craig Silverstein

1) Replace http://distcc.samba.org with the new google code location
2) Add favicon.ico from the distcc.samba.org site
3) Use distcc@lists.samba.org as the only distcc mailing list (there
   were at least three mailing lists scattered around the docs, some of
   which don't even exist anymore!)
4) Update man pages and other docs to not use "distcc-pump" anywhere;
   it's now "pump mode" or "distcc's pump mode", or "distcc-pump
   mode".

I also add, to the README, some discussion of scaling to hundreds of
machines.

Reviewed by fergus and klarlund

explain the effects of installing via RPM or Debian package.
Also a bunch of other minor edits.

Reviewers: Craig Silverstein

configure.ac):

1) Create a .gz tarfile as well as a .bz2 tarfile, with "make dist".
   I've also added a few more dist rules: "make rpm", "make deb", and
   "make alldist", though currently they're commented out since the
   scripts they call have yet to be written.

2) setup.py looks at os.environ("BUILDDIR"), so make sure that
   environment variable is always set properly.

3) setup.py was hard-coding the version number.  Instead, have it get
   it from the environment ("DISTCC_VERSION"), and set that envvar
   before calling setup.py in the Makefile.  (The alternate solution,
   of making a setup.py.in and having configure set the version number
   in setup.py, did not work well because the Makefile really wants
   setup.py to be in $srcdir, that the configure option puts it in
   builddir.)

4) Clean up distcheck to have three separate directories: src, build,
   and install.  Before src and build were the same.  This pulled up
   several places that were using srcdir instead of builddir, which I
   fixed.

5) Clean up distcheck to make sure that 'make distclean' cleans all
   the build files created during the build.  At first it didn't
   quite, so I fixed that up as well.

6) Added some new files to 'make dist': particularly, the files used
   to build rpm and deb files.

7) Have maintainer-check and maintainer-installcheck both call the
   same routine (via recursive make) rather than copy all that code.
   This simplifies things surprisingly, especially since the main
   check logic no longer has be inside a big "if $(PYTHON)".

8) (Various rules:) replace $^, which is not very portable, with a
   repetition of the dependency line.

9) Rename GZIP to GZIP_BIN, since GZIP as an envvar is read by gzip
   and parsed as gzip options.

10) In include_server/setup.py, we weren't setting builddir/src as an
    include dir, and it needs to be (as 'make distcheck' shows).  I'm
    not sure builddir/../../src really needs to be anymore, but I guess
    it can't hurt, so I've left it in.

11) Updated INSTALL to refer to autogen.sh, which will create
    configure if it's not already there.

include_server/configure.ac into a single, top-level configure.ac
script.  Likewise with the three Makefile.in scripts.  Now one config
file at the top level controls everything.

I had to rewrite quite a bit of code to account for the new level-up.
In particular, I had to add "distcc/" in front of many things in order
to refer to the same files I used to refer to when the
configure.ac/Makefile.in text lived in the distcc/ directory rather
than the top-level directory.  Likewise (though to a lesser extent)
for include_server.

I also had to do a bit of merge work.  Typically I'd leave the
originally-distcc-directory content as close to the original as
possible, and then try to put in the include_server directory stuff.

Most of the top-level configure.ac and Makefile.in could go away,
since they were glue before.  I also could get rid of other top-level
helper scripts that were used for the glue, such as version.sh.

I also fixed a number of typos and other bugs:

Makefile.in:
1) Removed obsolete CVS comment (we're 3 source-control systems past
   that now!)

2) distcc/Makefile.in was using top_builddir without importing it from
   the configure script.

3) Add zeroconf.h to HEADERS, which is needed for 'make dist'.  I also
   added all the include_server files to 'make dist'.

4) "make dist" was passing 'h' ("no symlinks") to tar.  This does not
   work with the include_server test-suite, which includes symlinks.
   I verified no other part of the distribution uses symlinks.
   Removed the h.

5) "make dist" was missing a lot of stuff (including almost all the
   include-server files).  Updated it to get it all now.  Likewise,
   updated "make clean" and its cousins to be more precise.  Also made
   "make distcheck" more careful in checking that kind of thing.

6) Declared more phony targets .PHONY.

7) The include-server build commands do a lot of 'cd'-ing (since
   setup.py requires it), and then using make variables that might
   store relative directory paths.  I now go through some hoops to
   make those directory paths absolute before the cd.

8) "make pump-check" was not setting the path, so it was using the
   installed distcc instead of the local one in the client.  Fixed
   that, and added a new target, "make pump-installcheck", to use the
   installed distcc instead (parallel to the maintainer-check and
   maintainer-installcheck targets).

configure.ac:
1) popt test was using $srcdir rather than required ${srcdir}, and
   thus was always getting the empty string.  (Luckily, srcdir is
   usually ".", and the empty string is usually equivalent.)
   Likewise when setting CPPFLAGS, which again didn't matter because
   it turns out the relevant code was redundant with what autoconf
   already does automatically.

2) A merge error: apparently the avahi check was added twice.  Get rid
   of the second one.

3) Was using obsolete AC_OUTPUT format.  Use AC_CONFIG_FILES instead.

4) Added pkg.m4 to the m4/ directory.  Before it only lived in
   autoconf.m4.  But my system, at least, doesn't have it.

5) include-server requires python2.4, so remove checks for earlier
   pythons.

autogen.sh:
1) Added aclocal call.  I think it was a bug that it was left out
   before.

pump.in:
1) Fixed it to notice when it can't find the .so file it needs.

I also modified INSTALL to point to the new file locations, and the
new instructions to run them (eg no more run_all_autoconf.sh).

Despite all these bugfixes, I made the minimal changes possible to get
things to work.  I marked with "TODO" further improvements I'd like to
make later.

One particular TODO is that I had to rename the "distcc" target -- the
main executable -- because it conflicts with the existing distcc
directory.  This is a temporary breakage which will be fixed in the
next submit after this one, where I move the subdirs under distcc to
the top level, getting rid of the artificial extra directory
introduced.

Tested by running 'make maintainer-check', 'make distcheck', and 'make
pump-check' on my local machine, which passed.  I've not tested all
the various configurations and options (including using avahi, using
the library popt library, building without python, etc).  I've also
not tried 'make benchmark'.

Reviewed by klarlund@google.com and fergus@google.com

location:
   README                     Our blurp, tooting our horn
   INSTALL                    The run_all_autoconf and friends incantations
   COPYING                    GPL 2.0 license
   distcc/README              Martin's blurp
   distcc/INSTALL             Also: more on masquerading, host lists,
   distcc/COPYING             GPL 2.0 license
   distcc/NEWS                Recently updated
   distcc/AUTHORS             Martin Pool
   distcc/README.packaging    Various advice (version numbering etc)
   distcc/TODO                A very long list (not updated)
   distcc/ChangeLog	      All changes under arch and under bzr
   distcc/ChangeLog.old	      All changes from before arch.

Now all live in the top-level directory.  This is the first step
towards our eventual goal of getting rid of the second-level distcc
and include_server directories, and just having everything under one
top-level directory.  We're all part of the same project now!

Here's how I merged and updated content:

. README became README.pump.  It was slightly edited for clarity.  (I
  also redid all the line-wrapping, which makes diff-ing
  difficult. :-( )  distcc/README became README, with a small amount
  of text added to describe 'pump' mode, and point to README.pump.

. distcc/NEWS became NEWS.  pump functionality was added (a new
  "distcc-3.0" entry).  I also added all new features and bug-fixes
  since we moved from arch to bzr.  It looks like NEWS was
  well-maintained before the move to bzr, so this might be pretty
  complete.  There may be some more pump-developed bugfixes we need to
  add, though.

. I got rid of distcc/COPYING.  Now COPYING is the only license in
  this directory.  This file was not changed.  It remains the GPL 2.0
  license.

. distcc/AUTHORS became AUTHORS.  I changed Martin to maintainer
  emeritus.  I added the Google authors as authors of the "pump"
  functionality, and current maintainers.  I set the Google email
  address to be distcc@googlegroups.com, which is a new group I've set
  up to be the clearinghouse for distcc discussions.

. distcc/README.packaging became README.packaging.  It was not
  otherwise changed.

. distcc/TODO became TODO.  It was not otherwise changed, except I
  added that folks should look for FIXMEs in source files, not just
  TODOs.

. I merged INSTALL and distcc/INSTALL (in that order).  I rearranged
  the text a little bit to remove redundancy (both talked about
  running 'configure'), but did not make any contentful changes.

. I merged distcc/ChangeLog and distcc/ChangeLog.old to have a single
  changelog again going all the way to 2002.  Comments now separate
  the various version control systems used.  (svn is #4!)  The single
  ChangeLog file now lives in the top-level directory.