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

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 there are none at present, use the "current" above

   make
   make install


Alternatively:

1. add to your  /etc/apt/sources list:

   deb-src http://debian.ethz.ch/pub/debian-local woody/local main contrib non-free

2. Fetch it with  apt-get source dphys-pkgtools


Binary install
==============

1. Download and unpack the .deb package file from:

   http://www.phys.ethz.ch/~franklin/Projects/dphys-pkgtools_<date>-1_all.deb
     where last milestone/release is <date>=20040611.172856

2. Install it with  dpkg --install dphys-pkgtools_<date>-1_all.deb


Alternatively:

1. add to your  /etc/apt/sources list:

   deb http://debian.ethz.ch/pub/debian-local woody/local main contrib non-free

2. Install it with  apt-get install dphys-pkgtools


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

To generate packages:

1. install this software (at least the makesourcepackage script)
2. set up the config file (system wide /etc/default/dphys-pkgtools or
   /etc/dphys-pkgtools or users specifix ~/.dphys-pkgtools or both)
   - your mail address (CONF_PRG_AND_MAIL)
   - your copyright (CONF_COPY)
3. run the makesourcepackage script for whatever functions you want to use
   (exept -u which requires an local packages site, see below)


To make an local packages site:

1. install this software (also only makesourcepackage script needed) on your
   client where you make packages
2. setup as above
3. make an HTTP virtual server which will host the site
   (directory, HTTP server config, DNS, etc)
4. install this software also on the server (at least the makelocalsite script)
5. set up the *same* config file(s) to use the virtualserver
   - server for copying packages to (CONF_PKG_SERVER), most likely by admin
   - user account for login in 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)
6. to upload an package run  makesourcepackage -u  which uploads and then
   automatically runs  makelocalsite  (unless surpressed with (CONF_RUN_INDEX)