.\" /usr/share/man/man1/dphys-pkgtools.7(.gz)
.\" author Neil Franklin, last modification 2006.12.19
.\" copyright ETH Zuerich Physics Departement
.\"   use under either modified/non-advertising BSD or GPL license

.TH DPHYS-PKGTOOLS 7 "2005.12.19" "D-PHYS Package Tools"

.SH NAME

dphys-pkgtools \- make Debian packages and and local package site

.SH SYNOPSIS

.B makesourcepackage
[options]
.PP
.B makelocalsite
[options]

.SH DESCRIPTION

dphys-pkgtools is an system for making Debian packages with the least possible
amount of work, uploading them to an local package server, and managing the
index files of that server fully automatically. For this it consists of
2 commands:
.PP
\fBmakesourcepackage\fP makes and uploads the packages. It is run on the
package generators workstation, where the package source directory resides.
.PP
\fBmakelocalsite\fP manages the package server. It is run on the server after
a package has been uploaded, or any other change has been made. It is triggered
by \fBmakesourcepackage \-i\fP after uploading with
\fBmakesourcepackage \-u\fP.

.SH OPTIONS

See the individual commands man pages.

.SH CONFIG

The config files \fI/etc/dphys-pkgtools\fP (normal style),
\fI~/.dphys-pkgtools\fP (personal) and \fI./dphys-pkgtools\fP (particular
project) allow the admin and users to set up the working environment for both
commands.
.PP
These config files are sh script fragments full of assignments, which are
sourced, in above row, later config files assignments overriding earlier ones.
For which assignments are relevant for which command see this table:
.PP
.nf
Assignment               makesourcepackage makelocalsite

CONF_ARCH                        1
CONF_SECTION                     1
CONF_HOST_TO_PKG_PREFIX          1
CONF_AUTHOR                      1
CONF_MAINT_NAME                  1
CONF_MAINT_EMAIL                 1
CONF_COPY                        1
CONF_REMOVE_CHANGES_FILE         1
CONF_PKG_SERVER                  2
CONF_USER                        2
CONF_GROUP                       2               3
CONF_PKG_BASE                    2               3
CONF_DISTRIB                     2               3
CONF_INDEXER                     3
CONF_BINARCH                                     3

1 = allways used, in making package, even if only for local dpkg \-i
    and not used if only uploading packages generated by other methods
2 = only used if uploading to an local package server, for download or apt-get
3 = only used if indexing the local package server, for apt-get install
.fi
.PP
For the meaning and settings of the above assignments read see the individual
commands man pages. Identical assignments are allways used identically, so can
be set once for both commands.

.SH FILES

.TP
.B /etc/dphys-pkgtools
normal style site config
.TP
.B ~/.dphys-pkgtools
users personal config
.TP
.B ./dphys-pkgtools
individual projects config

.SH EXAMPLES

See the individual commands man pages.

.SH SEE ALSO

\fImakesourcepackage\fP(1), \fImakelocalsite\fP(1)

.SH AUTHOR

franklin@phys.ethz.ch, http://www.phys.ethz.ch/~franklin/