http://www.phys.ethz.ch/~franklin/Projects/dphys-pkgtools/INSTALL
author Neil Franklin, last modification 2006.12.19
copyright ETH Zuerich Physics Departement
  use under either modified/non-advertising BSD or GPL license

To install/config/use dphys-pkgtools do the following:


Source install
==============

1. Download and unpack the .tar.gz archive file from:

   http://www.phys.ethz.ch/~franklin/Projects/dphys-pkgtools.tar.gz or
   http://www.phys.ethz.ch/~franklin/Projects/dphys-pkgtools-<date>.tar.gz
     where last milestone/release is <date>=20061219

   make
   make install


Configuration
=============

To generate packages:

1. ensure that dpkg-dev, debhelper and fakeroot are installed on the system
2. install this software (at least the makesourcepackage script)
3. set up the config file (system wide /etc/dphys-pkgtools or users specific
   ~/.dphys-pkgtools or ./dphys-pkgtools or combination)
     - your mail address (CONF_MAINT_NAME and CONF_MAINT_EMAIL)
     - your copyright (CONF_COPY)
4. run the makesourcepackage script for whatever functions you want to use
   (exept -u and -i which require an local packages site, see below)


To make an local packages site:

1. ensure that rsync is installed on the system
2. install this software (also only makesourcepackage script needed) on your
   client where you make packages
3. setup as above
4. on your server make an HTTP virtual server which will host the site
   (directory, HTTP server config, DNS, etc)
5. install this software also on the server (at least the makelocalsite script)
6. set up the *same* config file(s) (/etc/dphys-pkgtools or ~/.dphys-pkgtools
   or ./dphys-pkgtools) to access the virtualserver
     - server for copying packages to (CONF_PKG_SERVER), most likely by admin
     - user account for login to server (CONF_USER), most likely user specific
     - if you are multiple uploaders, then put all these users in an /etc/group
       group and configure which one that is (CONF_GROUP)
     - base directory where the package tree goes in (CONF_PKG_BASE)
7. to upload an package run  makesourcepackage -u  which uploads and then
   trigger  makelocalsite  to (re-)index by using  makesourcepackage -i