.\" /usr/share/man/man1/makesourcepackage.1(.gz) .\" author Neil Franklin, last modification 2004.07.23 .\" copyright ETH Zuerich Physics Deparement, use under either BSD or GPL license .TH MAKESOURCEPACKAGE 1 "2004.07.23" "D-Phys Package Tools" .SH NAME makesourcepackage \- make and upload packages .SH SYNOPSIS .B makesourcepackage \fB-g\fP [\fB-a\fP \fIarch\fP \fB-s\fP \fIsection\fP] [\fB-pnturivh\fP] [\fB-d\fP \fIdependancy\fP] [\fB-o\fP \fIoptionline\fP] [\fB-b\fP \fIbaseaddress\fP] [\fB-l\fP \fIlogtext\fP] \fIpackagename\fP .PP .B makesourcepackage \fB-c\fP \fIoldpackage\fP [\fB-pnturivh\fP] [\fB-d\fP \fIdependancy\fP] [\fB-o\fP \fIoptionline\fP] [\fB-b\fP \fIbaseaddress\fP] [\fB-l\fP \fIlogtext\fP] \fIpackagename\fP .PP .B makesourcepackage \fB-x\fP [\fB-pnturivh\fP] [\fB-d\fP \fIdependancy\fP] [\fB-o\fP \fIoptionline\fP] [\fB-b\fP \fIbaseaddress\fP] [\fB-l\fP \fIlogtext\fP] \fIpackagename\fP .PP .B makesourcepackage \fB-f\fP [\fB-pnturivh\fP] [\fB-d\fP \fIdependancy\fP] [\fB-o\fP \fIoptionline\fP] [\fB-b\fP \fIbaseaddress\fP] [\fB-l\fP \fIlogtext\fP] \fIpackagename\fP .SH DESCRIPTION makesourcepackage generates, copies, modfies, packages and uploads packages. .SH OPTIONS \fI[for creating]\fP .TP \fB-g\fP generate: Generate work directories and their content .TP \fB-a\fP \fIarch\fP architecture: Set architecture to this; default: all; examples: all, any, i386 .PP \fB-s\fP \fIsection\fP section: Set section to this; default: admin; examples: admin, misc, non-free/admin, contrib/misc .TP \fI[for cloning]\fP .TP \fB-c\fP \fIoldpackage\fP clone/copy: Clone contents from , instead of making new files do: .RS .TP * Makefile and README copied and package name in them changed .TP * control and copyright copied and package name in it changed .TP * rules file copied and package name in it changed .TP * all other files just copied unchanged .TP if no - in the oldpackage name, expand like packagename .TP if directory of old package clone that, else temporary unpack .RE .TP \fI[for expanding]\fP .TP \fB-x\fP (e)xpand: Take an .tar.gz and make work directories from it. This can not work from an .deb, as that no source in it. This can undo the effect of \fB-t\fP, so long an \fB-p\fP was done before doing the \fB-t\fP. \fIGotcha\fP: give only \fIpackage name\fP, not full .tar.gz file name .TP \fI[for fetching]\fP .TP \fB-f\fP fetch: Fetch the .tar.gz and .dsc from local Debian mirror and expand it to an working directory .TP [for modifying] after any of above or standalone .TP \fB-d\fP \fIdependancy\fP depend: Extend the Depends: line with this dependancy. If there is no Depends: line in control, it will be added. This option can be used multiple times, they get all added up .TP \fB-o\fP \fIoptionline\fP option: Add this option line to the control file, before Maintainer: line (places after Depends:, newer below) or extend existing line of this type, if there is one. Use this for Predepends:, Conflicts:, Provides:, Recommends: .TP [for packing] .TP \fB-l\fP \fIlogtext\fP log: Generate new changelog entry and (dated) version number using the given log text for the * line .TP \fB-p\fP pack: Pack up the work directory, making package files .TP \fB-n\fP nodelete: Do not delete temp files (.../debian/temp/*) .TP \fB-t\fP tidyup: Delete work directory after packaging, leaving only package .TP \fB-u\fP upload: Upload generated package files to local Debian mirror, and run indexing command there .TP \fB-b\fP \fIbaseaddr\fP base: Upload generated package files to this base directory .TP \fB-r\fP remove: Delete package files after upload .TP [other stuff] .TP \fB-i\fP info: Show information about an .deb package. This will not work if there is only an work directory .TP \fB-v\fP verbose: Show progress (debug information) .TP \fB-h\fP help: Output help text, and then abort operation .PP If (\fB-g\fP or \fB-c\fP or \fB-x\fP or \fB-f\fP) followed by multiple of \fB-d\fP \fB-o\fP \fB-r\fP \fB-p\fP \fB-t\fP \fB-u\fP \fB-i\fP are used, they are processed in the row they appear here in the man page section, not the row they are typed on the command line. Other options modify behaviour. .TP \fIpackagename\fP package name: Something like \fImy-\fP or \fI-\fP (here \fIdphys-\fP) .SH CONFIG \fI/etc/default/dphys-pkgtools\fP (Debian style) or \fI/etc/dphys-pkgtools\fP (normal style) allows the user to set up the working environment for makesourcepackage (and makelocalsite). This is a sh script fragment, which gets sourced by both of them. For detailled description of these variables read the comments at the beginning of the programs script file. .PP \fICONF_ARCH\fP: set our default architecture. Defaults to \fBall\fP .PP \fICONF_SECTION\fP: set our default section. Defaults to \fBadmin\fP .PP \fICONF_HOST_TO_PKG_PREFIX\fP: prepended site prefix to packagenames with no \- in the name .PP \fICONF_PRG\fP: used for author name in file headers .PP \fICONF_PRG_AND_MAIL\fP: used for maintainer in Debian control and changelog .PP \fICONF_COPY\fP: used for copyright remarks in file headers .PP \fICONF_REMOVE_CHANGES_FILE\fP: delete file not used for local sites. Defaults to deleting .PP \fICONF_PKG_SERVER\fP: server to connect to for \fB-u\fP uploads .PP \fICONF_USER\fP: user to login as for \fB-u\fP uploads .PP \fICONF_GROUP\fP: make all uploaded files and dirs writable by this group .PP \fICONF_PKG_BASE\fP: base directory on server for uploads to go into .PP \fICONF_INDEX_SITE\fP: program to run on server after upload, to eliminate duplicate packages and rebuild all index files and list files. Defaults to \fB/usr/bin/makelocalsite\fP .SH FILES \fI/etc/default/dphys-pkgtools\fP Debian style user config .TP 5 \fI/etc/dphys-pkgtools\fP normal style user config .SH AUTHOR franklin@phys.ethz.ch, http://www.phys.ethz.ch/~franklin/