From fb269aa45cb294f8f4afd82338aef6bc2937a375 Mon Sep 17 00:00:00 2001 From: Ian Jackson Date: Thu, 8 Aug 1996 02:36:04 +0100 Subject: [PATCH] dpkg (1.3.1) experimental; urgency=LOW * manpage for dpkg-source et al now available. * dpkg-changelog-mode.el installed in site-lisp, but still no autoload. * dpkg-source prints correct string for not-understood tar -vvt output. * dpkg-source parsing of tar -vvt output made more robust. * dpkg-buildpackage prints usage message on usage error. * dpkg-gencontrol can print usage message. * -T option added to dpkg-source. * Description of -f corrected in dpkg-distaddfile usage. * -m synopsis changed in dpkg-genchanges usage. * debian/substvars may now contain blank lines. -- Ian Jackson Thu, 8 Aug 1996 02:36:04 +0100 --- Makefile.in | 6 +- debian/changelog | 21 ++ scripts/Makefile.in | 13 +- scripts/controllib.pl | 2 +- scripts/dpkg-buildpackage.sh | 3 +- scripts/dpkg-changelog-mode.el | 208 +++++++++++++++++ scripts/dpkg-distaddfile.pl | 2 +- scripts/dpkg-genchanges.pl | 6 +- scripts/dpkg-gencontrol.pl | 2 +- scripts/dpkg-source.1 | 400 +++++++++++++++++++++++++++++++++ scripts/dpkg-source.8 | 249 ++++++++++++++++++++ scripts/dpkg-source.pl | 19 +- version.h | 2 +- 13 files changed, 915 insertions(+), 18 deletions(-) create mode 100644 scripts/dpkg-changelog-mode.el create mode 100644 scripts/dpkg-source.1 create mode 100644 scripts/dpkg-source.8 diff --git a/Makefile.in b/Makefile.in index 4f595803..062c5bd6 100644 --- a/Makefile.in +++ b/Makefile.in @@ -30,6 +30,7 @@ libdir = $(prefix)/lib dpkglibdir = $(libdir)/dpkg methodsdir = $(dpkglibdir)/methods parsechangelogdir = $(dpkglibdir)/parsechangelog +elispdir = $(libdir)/emacs/site-lisp datadir = /var/lib/dpkg methodsdatadir = $(datadir)/methods methodsmnt = $(datadir)/methods/mnt @@ -78,8 +79,9 @@ install: all $(BOURNESHELL) $(srcdir)/mkinstalldirs $(bindir) $(sbindir) \ $(man1dir) $(man5dir) $(man8dir) $(devdocdir) $(infodir) \ $(libdir) $(dpkglibdir) $(methodsdir) $(parsechangelogdir) \ - $(datadir) $(pinfodir) $(pupdatesdir) $(methodsdatadir) \ - $(methodsmnt) $(altsdatadir) $(altsetcdir) $(partsdir) + $(elispdir) $(datadir) $(pinfodir) $(pupdatesdir) \ + $(methodsdatadir) $(methodsmnt) $(altsdatadir) \ + $(altsetcdir) $(partsdir) set -e; for d in $(SUBDIRS) ; do \ cd $$d ; \ $(MAKE) 'CC=$(CC)' 'LDFLAGS=$(LDFLAGS)' 'XLIBS=$(XLIBS)' \ diff --git a/debian/changelog b/debian/changelog index 85255418..07025f1c 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,3 +1,20 @@ +dpkg (1.3.1) experimental; urgency=LOW + + * manpage for dpkg-source et al now available. + * dpkg-changelog-mode.el installed in site-lisp, but still no autoload. + + * dpkg-source prints correct string for not-understood tar -vvt output. + * dpkg-source parsing of tar -vvt output made more robust. + + * dpkg-buildpackage prints usage message on usage error. + * dpkg-gencontrol can print usage message. + * -T option added to dpkg-source. + * Description of -f corrected in dpkg-distaddfile usage. + * -m synopsis changed in dpkg-genchanges usage. + * debian/substvars may now contain blank lines. + + -- Ian Jackson Thu, 8 Aug 1996 02:36:04 +0100 + dpkg (1.3.0) experimental; urgency=LOW * dpkg can install named pipes. @@ -1519,3 +1536,7 @@ Thu Aug 25 11:46:27 1994 Ian Murdock (imurdock@debra.debian.org) link never being removed at all. ChangeLog begins Thu Aug 25 11:46:27 1994 for dpkg 0.93.5. + +Local variables: +mode: dpkg-changelog +End: diff --git a/scripts/Makefile.in b/scripts/Makefile.in index 2d1d8ce5..4cc50235 100644 --- a/scripts/Makefile.in +++ b/scripts/Makefile.in @@ -31,11 +31,15 @@ man8 = 8 libdir = $(prefix)/lib dpkglibdir = $(libdir)/dpkg parsechangelogdir = $(dpkglibdir)/parsechangelog +elispdir = $(libdir)/emacs/site-lisp etcdir= /etc altsetcdir = $(etcdir)/alternatives perlpath = @perlpath@ -MAN1 = dpkg-name +MAN1 = dpkg-name dpkg-source +LSMAN = dpkg-source.$(man1) +LSMANL= dpkg-gencontrol dpkg-genchanges dpkg-buildpackage \ + dpkg-distaddfile dpkg-parsechangelog EXC = dpkg-name dpkg-source dpkg-genchanges dpkg-gencontrol \ dpkg-buildpackage dpkg-parsechangelog dpkg-distaddfile MAN8 = update-rc.d start-stop-daemon update-alternatives install-info \ @@ -43,7 +47,8 @@ MAN8 = update-rc.d start-stop-daemon update-alternatives install-info \ SBIN = update-rc.d start-stop-daemon update-alternatives install-info \ dpkg-scanpackages dpkg-divert cleanup-info LIB = controllib.pl -CHGLGS = cl-dpkg +ELISP = dpkg-changelog-mode.el +CHGLGS= cl-dpkg INSTALL = @INSTALL@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ @@ -82,9 +87,11 @@ distclean: clean install: all for f in $(EXC) ; do $(INSTALL_PROGRAM) $$f $(bindir)/$$f ; done for f in $(MAN1) ; do $(INSTALL_DATA) $$f.1 $(man1dir)/$$f.$(man1) ; done + for f in $(LSMANL) ; do ln -s $(LSMAN) $(man1dir)/$$f.$(man1) ; done for f in $(SBIN) ; do $(INSTALL_PROGRAM) $$f $(sbindir)/$$f ; done for f in $(MAN8) ; do $(INSTALL_DATA) $$f.8 $(man8dir)/$$f.$(man8) ; done - for f in $(LIB) ; do $(INSTALL_DATA) $$f $(dpkglibdir)/$$f; done + for f in $(LIB) ; do $(INSTALL_DATA) $$f $(dpkglibdir)/$$f ; done + for f in $(ELISP) ; do $(INSTALL_DATA) $$f $(elispdir)/$$f ; done for f in $(CHGLGS) ; do $(INSTALL_PROGRAM) $$f \ $(dpkglibdir)/parsechangelog/`echo $$f | sed -e 's/^cl-//'` ; \ done diff --git a/scripts/controllib.pl b/scripts/controllib.pl index f6ce8758..151a56e7 100644 --- a/scripts/controllib.pl +++ b/scripts/controllib.pl @@ -42,7 +42,7 @@ sub outputclose { $varlistfile="./$varlistfile" if $varlistfile =~ m/\s/; if (open(SV,"< $varlistfile")) { while () { - next if m/^\#/; + next if m/^\#/ || !m/\S/; s/\s*\n$//; m/^(\w+)\=/ || &error("bad line in substvars file $varlistfile at line $."); diff --git a/scripts/dpkg-buildpackage.sh b/scripts/dpkg-buildpackage.sh index dbb5603c..024419bc 100644 --- a/scripts/dpkg-buildpackage.sh +++ b/scripts/dpkg-buildpackage.sh @@ -36,7 +36,8 @@ do -us) signsource=: ;; -uc) signchanges=: ;; -b|-B) binaryonly=$1 ;; - *) echo >&2 "$progname: unknown option or argument $1"; exit 2 ;; + *) echo >&2 "$progname: unknown option or argument $1" + usageversion; exit 2 ;; esac shift done diff --git a/scripts/dpkg-changelog-mode.el b/scripts/dpkg-changelog-mode.el new file mode 100644 index 00000000..5b003a71 --- /dev/null +++ b/scripts/dpkg-changelog-mode.el @@ -0,0 +1,208 @@ +;; dpkg-changelog.el --- change log maintenance for dpkg-style changelogs + +;; Keywords: maint + +;; Copyright (C) 1996 Ian Jackson +;; This file is part of dpkg. +;; +;; It is free software; you can redistribute it and/or modify +;; it under the terms of the GNU General Public License as published by +;; the Free Software Foundation; either version 2, or (at your option) +;; any later version. +;; +;; dpkg is distributed in the hope that it will be useful, +;; but WITHOUT ANY WARRANTY; without even the implied warranty of +;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +;; GNU General Public License for more details. +;; +;; You should have received a copy of the GNU General Public License +;; along with your Debian installation, in /usr/doc/copyright/GPL. +;; If not, write to the Free Software Foundation, 675 Mass Ave, +;; Cambridge, MA 02139, USA. + +(require 'add-log) + +(defvar dpkg-changelog-urgencies + '((?l."LOW") (?m."MEDIUM") (?h."HIGH")) + "alist of keystrokes vs. urgency values dpkg-changelog-urgency ^c^u.") + +(defvar dpkg-changelog-distributions + '((?s."stable") (?u."unstable") (?c."contrib") (?n."non-free") (?e."experimental")) + "alist of keystrokes vs. distribution values for dpkg-changelog-distribution ^c^d.") + +(defvar dpkg-changelog-mode-map nil + "Keymap for dpkg changelog major mode.") +(if dpkg-changelog-mode-map + nil + (setq dpkg-changelog-mode-map (make-sparse-keymap)) + (define-key dpkg-changelog-mode-map "\C-c\C-a" 'dpkg-changelog-add-entry) + (define-key dpkg-changelog-mode-map "\C-c\C-f" 'dpkg-changelog-finalise-last-version) + (define-key dpkg-changelog-mode-map "\C-c\C-c" 'dpkg-changelog-finalise-and-save) + (define-key dpkg-changelog-mode-map "\C-c\C-v" 'dpkg-changelog-add-version) + (define-key dpkg-changelog-mode-map "\C-c\C-d" 'dpkg-changelog-distribution) + (define-key dpkg-changelog-mode-map "\C-c\C-u" 'dpkg-changelog-urgency) + (define-key dpkg-changelog-mode-map "\C-c\C-e" + 'dpkg-changelog-unfinalise-last-version)) + +(defun dpkg-changelog-add-entry () + "Add a new change entry to a dpkg-style changelog." + (interactive) + (if (eq (dpkg-changelog-finalised-p) t) + (error "most recent version has been finalised - use ^c^e or ^c^v")) + (goto-char (point-min)) + (re-search-forward "\n --") + (backward-char 5) + (if (prog1 (looking-at "\n") (forward-char 1)) + nil + (insert "\n")) + (insert " * ") + (save-excursion (insert "\n"))) + +(defun dpkg-changelog-headervalue (arg re alist) + (let (a b v k + (lineend (save-excursion (end-of-line) (point)))) + (save-excursion + (goto-char (point-min)) + (re-search-forward re lineend) + (setq a (match-beginning 1) + b (match-end 1)) + (goto-char a) + (if arg nil + (message (mapconcat + (function (lambda (x) (format "%c:%s" (car x) (cdr x)))) + alist " ")) + (while (not v) + (setq k (read-char)) + (setq v (assoc k alist)))) + (delete-region a b) + (if arg nil (insert (cdr v)))) + (if arg (goto-char a)))) + +(defun dpkg-changelog-urgency (arg) + "Without argument, prompt for a key for a new urgency value (using +dpkg-changelog-urgencies). With argument, delete the current urgency +and position the cursor to type a new one." + (interactive "P") + (dpkg-changelog-headervalue + arg + "\\;[^\n]* urgency=\\(\\sw+\\)" + dpkg-changelog-urgencies)) + +(defun dpkg-changelog-distribution (arg) + "Without argument, prompt for a key for a new distribution value (using +dpkg-changelog-distributions). With argument, delete the current distribution +and position the cursor to type a new one." + (interactive "P") + (dpkg-changelog-headervalue + arg + ") \\(.*\\)\\;" + dpkg-changelog-distributions)) + +(defun dpkg-changelog-finalised-p () + "Check whether the most recent dpkg-style changelog entry is +finalised yet (ie, has a maintainer name and email address and a +release date." + (save-excursion + (goto-char (point-min)) + (if (re-search-forward "\n\\S-" (point-max) t) nil + (goto-char (point-max))) + (if (re-search-backward "\n --" (point-min) t) + (forward-char 4) + (beginning-of-line) + (insert " --\n\n") + (backward-char 2)) + (cond + ((looking-at "[ \n]+\\S-[^\n\t]+\\S- <[^ \t\n<>]+> \\S-[^\t\n]+\\S-[ \t]*\n") + t) + ((looking-at "[ \t]*\n") + nil) + ("finalisation line has bad format (not ` -- maintainer date')")))) + +(defun dpkg-changelog-add-version () + "Add a new version section to a dpkg-style changelog file." + (interactive) + (let ((f (dpkg-changelog-finalised-p))) + (and (stringp f) (error f)) + (or f (error "previous version not yet finalised"))) + (goto-char (point-min)) + (let ((headstring + (if (looking-at "\\(\\S-+ ([^()\n\t ]*[^0-9\n\t()]\\)\\([0-9]+\\)\\()[^\n]*\\)") + (concat (match-string 1) + (number-to-string (+ 1 (string-to-number (match-string 2)))) + (match-string 3)) + (let ((pkg (read-string "Package name: ")) + (ver (read-version "New version (including any revision): "))) + (concat pkg " (" ver ") unstable; urgency=" + (cdr (car dpkg-changelog-urgencies))))))) + (insert headstring "\n\n * ") + (save-excursion + (if (re-search-backward "\;[^\n]* urgency=\\(\\sw+\\)" (point-min) t) + (progn (goto-char (match-beginning 1)) + (delete-region (point) (match-end 1)) + (insert (cdr (car dpkg-changelog-urgencies)))))) + (save-excursion (insert "\n\n --\n\n")))) + +(defun dpkg-changelog-finalise-and-save () + "Finalise, if necessary, and then save a dpkg-style changelog file." + (interactive) + (let ((f (dpkg-changelog-finalised-p))) + (and (stringp f) (error f)) + (or f (dpkg-changelog-finalise-last-version))) + (save-buffer)) + +(defun dpkg-changelog-finalise-last-version () + "Remove the `finalisation' information (maintainer's name and email +address and release date) so that new entries can be made." + (interactive) + (or add-log-full-name (setq add-log-full-name (user-full-name))) + (or add-log-mailing-address (setq add-log-mailing-address user-mail-address)) + (and (dpkg-changelog-finalised-p) (dpkg-changelog-unfinalise-last-version)) + (save-excursion + (goto-char (point-min)) + (re-search-forward "\n --\\([ \t]*\\)") + (delete-region (match-beginning 1) (match-end 1)) + (insert " " add-log-full-name " <" add-log-mailing-address "> ") + (let* ((dp "822-date") + (r (call-process dp nil t))) + (or (= r 0) (error (concat dp " returned error status " (prin1-to-string r))))) + (backward-char) + (or (looking-at "\n") + (error (concat "expected newline after date from " dp))) + (delete-char 1))) + +(defun dpkg-changelog-unfinalise-last-version () + "Remove the `finalisation' information (maintainer's name and email +address and release date) so that new entries can be made." + (interactive) + (if (dpkg-changelog-finalised-p) nil + (error "most recent version is not finalised")) + (save-excursion + (goto-char (point-min)) + (re-search-forward "\n --") + (let ((dels (point))) + (end-of-line) + (delete-region dels (point))))) + +(defun dpkg-changelog-mode () + "Major mode for editing dpkg-style change logs. +Runs `dpkg-changelog-mode-hook'." + (interactive) + (kill-all-local-variables) + (text-mode) + (setq major-mode 'dpkg-changelog-mode + mode-name "dpkg changelog" + left-margin 2 + fill-prefix " " + fill-column 74) + (use-local-map dpkg-changelog-mode-map) + ;; Let each entry behave as one paragraph: + (set (make-local-variable 'paragraph-start) "\\*") + (set (make-local-variable 'paragraph-separate) "\\*\\|\\s-*$|\\S-") + ;; Let each version behave as one page. + ;; Match null string on the heading line so that the heading line + ;; is grouped with what follows. + (set (make-local-variable 'page-delimiter) "^\\<") + (set (make-local-variable 'version-control) 'never) + (run-hooks 'dpkg-changelog-mode-hook)) + +(provide 'dpkg-changelog) diff --git a/scripts/dpkg-distaddfile.pl b/scripts/dpkg-distaddfile.pl index a5f5d2ed..ddbdb345 100644 --- a/scripts/dpkg-distaddfile.pl +++ b/scripts/dpkg-distaddfile.pl @@ -19,7 +19,7 @@ version 2 or later for copying conditions. There is NO warranty. Usage: dpkg-addfile
-Options: -f get files list from this file +Options: -f write files here instead of debian/files "; } diff --git a/scripts/dpkg-genchanges.pl b/scripts/dpkg-genchanges.pl index 0994330a..53d0ee3c 100644 --- a/scripts/dpkg-genchanges.pl +++ b/scripts/dpkg-genchanges.pl @@ -30,13 +30,13 @@ Options: -b binary-only build - no source files -f get .deb files list from this file -v include all changes later than version -d use change description from this file - -m override changelog's maintainer value + -m override changelog's maintainer value -u directory with files (default is \`..' -F force change log format - -D= override or add a field and value - -U remove a field -V= set a substitution variable -T read variables here, not debian/substvars + -D= override or add a field and value + -U remove a field "; } diff --git a/scripts/dpkg-gencontrol.pl b/scripts/dpkg-gencontrol.pl index f91cb479..e2176b2e 100644 --- a/scripts/dpkg-gencontrol.pl +++ b/scripts/dpkg-gencontrol.pl @@ -14,7 +14,7 @@ use POSIX qw(:errno_h); push(@INC,$dpkglibdir); require 'controllib.pl'; -sub usage { +sub usageversion { print STDERR "Debian GNU/Linux dpkg-gencontrol $version. Copyright (C) 1996 Ian Jackson. This is free software; see the GNU General Public Licence diff --git a/scripts/dpkg-source.1 b/scripts/dpkg-source.1 new file mode 100644 index 00000000..bfead974 --- /dev/null +++ b/scripts/dpkg-source.1 @@ -0,0 +1,400 @@ +.\" Hey, Emacs! This is an -*- nroff -*- source file. +.\" Authors: Ian Jackson +.TH DPKG\-SOURCE 1 "7th Auguest" "Debian Project" "Debian GNU/Linux manual" +.SH NAME +dpkg\-source, dpkg\-gencontrol, dpkg\-genchanges, +dpkg\-buildpackage, dpkg\-distaddfile, dpkg\-parsechangelog +\- Debian source package tools +.SH SYNOPSIS +.B dpkg-source +.BI "-x " filename .dsc +.br +.B dpkg-source -b +.RI [ options "] " directory " [" orig-directory |''] +.br +.B dpkg-gencontrol +.RI [ options ] +.br +.B dpkg-genchanges +.RI [ options ] +.br +.B dpkg-buildpackage +.RI [ options ] +.br +.B dpkg-distaddfile +.RI [ options ] " filename section priority" +.br +.B dpkg-parsechangelog +.RI [ options ] +.SH DESCRIPTION +.B dpkg-source +packs and unpacks Debian source archives. + +.B dpkg-gencontrol +reads information from an unpacked Debian source tree and generates a +binary package control file on standard output; it also adds an entry +for the binary package to +.BR debian/files . + +.B dpkg-genchanges +reads information from an unpacked and built Debian source tree and +from the files it has generated and generates a Debian upload control +file +.RB ( .changes " file)." + +.B dpkg-buildpackage +Is a control script which can be used to help automate the building of +a package. + +.B dpkg-distaddfile +adds an entry for a named file to +.BR debian/files . + +.B dpkg-parsechangelog +reads and parses the changelog of an unpacked Debian source tree and +outputs the information in it to standard output in a machine-readable +form. + +None of these commands allow multiple options to be combined into one, +and they do not allow the value for an option to be specified in a +separate argument. +.SH COMMON OPTIONS +Many of these programs share options; these are described here, +together with the programs that accept them. +.TP +.BI -h +Display the particular program's version and usage message, including +a synopsis of the options it understands. This option is understood +by all the source package tools. +.TP +.BI -v version +In +.BR dpkg-genchanges " and " dpkg-parsechangelog +this causes changelog information from all versions strictly later +than +.I version +(which must appear in the changelog file) to be used. + +In +.BR dpkg-gencontrol +it sets the version number of the binary package which will be +generated. +.TP +.BI -V name = value +Set an output substitution variable. +This option is understood by +.BR dpkg-source ", " dpkg-gencontrol " and " dpkg-genchanges . +See below for a discussion of output substitution. +.TP +.BI -T substvarsfile +Read substitution variables from +.IR substvarsfile ; +the default is +.BR debian/substvars . +This option is understood by +.BR dpkg-source ", " dpkg-gencontrol " and " dpkg-genchanges . +.TP +.BI -D field = value +Override or add an output control file field. +This option is understood by +.BR dpkg-source ", " dpkg-gencontrol " and " dpkg-genchanges . +.TP +.BI -U field +Remove an output control file field. +This option is understood by +.BR dpkg-source ", " dpkg-gencontrol " and " dpkg-genchanges . +.TP +.BR -b | -B +For +.BR dpkg-genchanges " and " dpkg-buildpackage +this specifies that a binary-only build is taking place. +.B -b +indicates that no source files are to be built and/or distributed, and +.B -B +that no architecture-independent binary package files are to be +distributed either. + +.B -b +tells +.B dpkg-source +to build a source package (rather than to extract one) - see below. +.TP +.BI -c controlfile +Specifies the main source control file to read information from. The +default is +.BR debian/control . +This option is understood by +.BR dpkg-source ", " dpkg-gencontrol " and " dpkg-genchanges . +.TP +.BI -l changelogfile +Specifies the change log file to read information from. The +default is +.BR debian/changelog . +This option is understood by +.BR dpkg-source ", " dpkg-gencontrol " and " dpkg-genchanges . +.TP +.BI -f fileslistfile +Read or write the list of files to be uploaded here, rather than using +.BR debian/files . +This option is understood by +.BR dpkg-gencontrol ", " dpkg-genchanges " and " dpkg-distaddfile . +.TP +.BI -F changelogformat +Specifies the format of the changelog. By default the format is read +from a special line near the bottom of the changelog (see the +programmers' manual) or failing that defaults to +.BR dpkg . +This option is understood by +.BR dpkg-source ", " dpkg-gencontrol " and " dpkg-genchanges . +.SH DPKG-SOURCE OPTIONS +.TP +.B -x +Extract a source package. One non-option argument should be supplied, +the name of the Debian source control file +.RB ( .dsc ). +No options are useful with +.BR "dpkg-source -x" . +.B dpkg-source +will read the names of the other file(s) making up the source package +from the control file; they are assumed to be in the same directory as +the +.BR .dsc . +.TP +.B -b +Build: pack up a source tree. One or two non-option arguments should +be supplied. The first is taken as the name of the directory +containing the unpacked source tree. If a second argument is supplied +it should either be the name of the original source directory or the +empty string if the package is a Debian-specific one and so has no +Debianisation diffs. If no second argument is supplied then +.B dpkg-source +will assume the directory +.IB directory .orig +if exists or the empty string (no original source, and so no diff) if +it doesn't. +.SH DPKG-GENCONTROL OPTIONS +.B dpkg-gencontrol +does not take any non-option arguments. +.TP +.BI -p package +Generate information for the binary package +.IR package . +If the source control file lists several binary packages then this +option may be omitted; otherwise it is essential to select which +binary package's information to generate. +.TP +.BR -is ", " -ip ", " -isp +Include the +.BR Section " and " Priority +fields for this package from the main source control file in the +binary package control file being generated. Usually this information +is not included here, but only in the +.B .changes +file. +.B -isp +includes both fields, +.BR -is " only the " Section " and " -ip " only the " Priority . +.SH DPKG-GENCHANGES OPTIONS +.B dpkg-gencontrol +does not take any non-option arguments. +.TP +.BI -d changesdescription +Read the description of the changes from the file +.I changesdescription +rather than using the information from the source tree's changelog +file. +.TP +.BI -m maintaineraddress +Use +.I maintaineraddress +as the name and email address of the maintainer for this upload, +rather than using the information from the source tree's changelog. +.TP +.BI -u uploadfilesdir +Look for the files to be uploaded in +.I uploadfilesdir +rather than +.B .. +.RB ( dpkg-genchanges +needs to find these files so that it can include their sizes and +checksums in the +.B .changes +file). +.SH DPKG-BUILDPACKAGE OPTIONS +.B dpkg-buildpackage +does not take any non-option arguments. +.TP +.BI -r gain-root-command +When +.B dpkg-buildpackage +needs to execute part of the build process as root, it prefixes the +command it executes with +.I gain-root-command +if one has been specified. +.I gain-root-command +should be the name of a program on the +.B PATH +and will get as arguments the name of the real command to run and the +arguments it should take. +.I gain-root-command +should not contain spaces or any other shell metacharacters. +.TP +.BI -p pgp-command +When +.B dpkg-buildpackage +needs to execute PGP to sign a source control +.RB ( .dsc ) +file or a +.B .changes +file it will run +.I pgp-command +(searching the +.B PATH +if necessary) instead of +.BR pgp . +.I pgp-command +will get all the arguments that +.B pgp +would have done. +.I pgp-command +should not contain spaces or any other shell metacharacters. +.TP +.BR -us ", " -uc +Do not PGP-sign the source package or the changelog, respectively. +.SH DPKG-DISTADDFILE ARGUMENTS +.B dpkg-distaddfile +does not take any non-common options. It takes three non-option +arguments, the filename and the section and priority for the +.B .changes +file. + +The filename should be specified relative to the directory where +.B dpkg-genchanges +will expect to find the files, usually +.BR .. , +rather than being a pathname relative to the current directory when +.B dpkg-distaddfile +is run. +.SH DPKG-PARSECHANGELOG ARGUMENTS +.B dpkg-parsechangelog +does not take any non-common options or non-option arguments. +.SH VARIABLE SUBSTITUTION +Before +.BR dpkg-source ", " dpkg-gencontrol " and " dpkg-genchanges +write their control information (to the source control file +.B .dsc +for +.B dpkg-source +and to standard output for +.BR dpkg-gencontrol " and " dpkg-genchanges ) +they perform some variable substitutions on the output file. + +A variable substitution has the form +.BI ${ variable-name }\fR. +Variable substitutions are performed repeatedly until none are left; +the full text of the field after the substitution is rescanned to look +for more substitutions. + +After all the substitutions have been done each occurence of the +string +.B ${} +(which is not a legal substitution) is replaced with a +.B $ +sign. + +Variables whose names consist entirely of alphanumerics can be set +using the +.B -V +common option. + +They can be also specified in the file +.B debian/substvars +(or whatever other file is specified using the +.B -T +option). This file consists of lines of the form +.IB name = value +(where +.B name +is a string of alphanumerics). Trailing whitespace on each line, +blank lines, and lines starting with a +.B # +symbol (comments) are ignored. + +Additionally, the following standard variables are available: +.TP +.BI arch +The current build architecture (from +.BR "dpkg \-\-print-architecture" ). +.TP +.B sourceversion +The source package version (from the changelog file). +.TP +.BI f: fieldname +The value of the output field +.IR fieldname . +.TP +.B Format +The +.B .changes +file format version generated by this version of the source packaging +scripts. If you set this variable the contents of the +.B Format +field in the +.B .changes +file will change too. +.TP +.BR newline ", " space ", " tab +These variables each hold the corresponding character. +.SH FILES +.TP +.B debian/control +The main source control information file, giving version-independent +information about the source package and the binary packages it can +produce. +.TP +.B debian/changelog +The changelog file, used to obtain version-dependent information about +the source package, such as the urgency and distribution of an upload, +the changes made since a particular release, and the source version +number itself. +.TP +.B debian/files +The list of generated files which are part of the upload being +prepared. +.B dpkg-gencontrol +adds the presumed filenames of binary packages whose control files it +generates here; +.B dpkg-distaddfile +can be used to add additional files. +.B dpkg-genchanges +reads the data here when producing a +.B .changes +file. +.TP +.B debian/substvars +List of substitution variables and values. +.SH BUGS +The point at which field overriding occurs compared to certain +standard output field settings is rather confused. + +The binary package entries in the +.B debian/files +file will be passed through variable substitution twice. This should +not matter, since +.BR $ ", " { " and " } +are not legal in package names or version numbers. +.SH SEE ALSO +.B dpkg +.IR "programmers' manual" , +.IR "Debian policy manual" , +.BR dpkg\-deb (8), +.BR dpkg (8), +.BR dselect (8). +.SH AUTHOR +The utilities and this manpage were written by Ian Jackson. They are +Copyright (C)1995-1996 by him and released under the GNU General +Public Licence; there is NO WARRANTY. See +.B /usr/doc/copyright/dpkg +and +.B /usr/doc/copyright/GPL +for details. diff --git a/scripts/dpkg-source.8 b/scripts/dpkg-source.8 new file mode 100644 index 00000000..c7d6951a --- /dev/null +++ b/scripts/dpkg-source.8 @@ -0,0 +1,249 @@ +.\" Hey, Emacs! This is an -*- nroff -*- source file. +.\" Authors: Ian Jackson +.TH DPKG\-SOURCE 8 "7th Auguest" "Debian Project" "Debian GNU/Linux manual" +.SH NAME +dpkg\-source, dpkg\-genchanges, dpkg\-gencontrol, +dpkg\-buildpackage, dpkg\-distaddfile, dpkg\-parsechangelog +\- Debian source packaging tools +.SH SYNOPSIS +.B dpkg-deb +.BR -b | --build +.IR directory " [" archive | directory ] +.br +.B dpkg-deb +.BR -I | --info +.IR archive " [" control\-file\-name " ..]" +.br +.B dpkg-deb +.BR -f | --field +.IR archive " [" control\-field\-name " ...]" +.br +.B dpkg-deb +.BR -c | --contents +.I archive +.br +.B dpkg-deb +.BR -x | --extract | -X | --vextract +.I archive directory +.br +.B dpkg-deb --fsys-tarfile +.I archive +.br +.B dpkg-deb --control +.I archive directory +.SH DESCRIPTION +.B dpkg-deb +packs, unpacks and provides information about Debian archives. + +Use +.B dpkg +to install and remove packages from your system. + +You can also invoke +.B dpkg\-deb +by calling +.B dpkg +with whatever options you want to pass to +.BR dpkg\-deb ". " dpkg +will spot that you wanted +.B dpkg\-deb +and run it for you. +.SH ACTION OPTIONS +.TP +.BR --build ", " -b +Creates a debian archive from the filesystem tree stored in +.IR directory ". " directory +must have a +.B DEBIAN +subdirectory, which contains the control information files such +as the control file itself. This directory will +.I not +appear in the binary package's filesystem archive, but instead +the files in it will be put in the binary package's control +information area. + +Unless you specify +.BR \-\-no\-check ", " dpkg\-deb " +will read +.B DEBIAN/control +and parse it. It will check it for syntax errors and other problems, +and display the name of the binary package being built. +.B dpkg\-deb +will also check the permissions of the maintainer scripts and other +files found in the +.B DEBIAN +control information directory. + +If no +.I archive +is specified then +.B dpkg\-deb +will write the package into the file +.IR directory \fB.deb\fR. + +If the archive to be created already exists it will be overwritten. + +If the second argument is a directory then +.B dpkg\-deb +will write to the file +.IB package _ version _ arch .deb\fR, +or +.IB package _ version .deb +if no +.B Architecture +field is present in the package control file. When a target directory +is specified, rather than a file, the +.B \-\-no\-check +option may not be used (since +.B dpkg\-deb +needs to read and parse the package control file to determine which +filename to use). +.TP +.BR \-\-info ", " -I +Provides information about a binary package archive. + +If no +.IR control\-file\-name s +are specified then it will print a summary of the contents of the +package as well as its control file. + +If any +.IR control\-file\-name s +are specified then +.B dpkg\-deb +will print them in the order they were specified; if any of the +components weren't present it will print an error message to stderr +about each one and exit with status 2. +.TP +.BR \-\-field ", " -f +Extracts control file information from a binary package archive. + +If no +.BR control\-file\-field s +are specified then it will print the whole control file. + +If any are specified then +.B dpkg\-deb +will print their contents, in the order in which they appear in the +control file. If more than one +.BR control\-file\-field +is specified then +.B dpkg\-deb +will precede each with its field name (and a colon and space). + +No errors are reported for fields requested but not found. +.TP +.BR --contents ", " -c +Lists the contents of the filesystem tree archive portion of the +package archive. It is currently produced in the format generated by +.BR tar 's +verbose listing. +.TP +.BR --extract ", " -x ", " \-\-vextract ", " -X +Extracts the filesystem tree from a package archive into the specified +directory. + +.BR \-\-vextract " (" -X ")" +prints a listing of the files extracted as it goes, while +.BR \-\-extract " (" -x ")" +is silent unless an error occurs. + +Note that extracting a package to the root directory will +.I not +result in a correct installation ! Use +.B dpkg +to install packages. + +.I directory +(but not its parents) will be created if necessary. +.TP +.BR --fsys-tarfile +Extracts the filesystem tree data from a binary package and sends it +to standard output in +.B tar +format. Together with +.B tar +this can be used to extract a particular file from a package archive. +.TP +.BR --control ", " -e +Extracs the control information files from a package archive into the +specified directory. + +If no directory is specified then a subdirectory +.B DEBIAN +in the current directory is used. + +The target directory (but not its parents) will be created if +necessary. +.TP +.BR --help ", " -h +Prints +.BR dpkg\-deb 's +usage message, giving a summary of its options and their uses. +.TP +.BR --version +Prints +.BR dpkg\-deb 's +version number. +.TP +.BR --licence +Prints information about +.BR dpkg\-deb 's +copyright licensing and lack of warranty. (The American spelling +.B \-\-license +is also supported.) +.SH OTHER OPTIONS +.TP +.BR --new +Ensures that +.B dpkg\-deb +builds a `new' format archive. This is the default. +.TP +.BR --old +Forces +.B dpkg\-deb +to build an `old' format archive. This old archive format is less +easily parsed by non-Debian tools and is now obsolete; its only use is +when building packages to be parsed by versions of dpkg older than +0.93.76 (September 1995), which was released as i386 a.out only. +.TP +.BR --no-check +Inhibit's +.BR "dpkg\-deb \-\-build" 's +usual checks on the proposed contents of an archive. You can build +any archive you want, no matter how broken, this way. +.TP +.BR --debug ", " -D +Enables debugging output. This is not very interesting. +.SH BUGS +.B dpkg-deb -I +.IB package1 .deb +.IB package2 .deb +does the wrong thing. + +There is no authentication on +.B .deb +files; in fact, there isn't even a straightforward checksum. + +Do not attempt to use just +.B dpkg\-deb +to install software ! You must use +.B dpkg +proper to ensure that all the files are correctly placed and the +package's scripts run and its status and contents recorded. +.SH SEE ALSO +.BR deb (5), +.BR deb-control (5), +.BR dpkg (5), +.BR dpkg (8), +.BR dselect (8). +.SH AUTHOR +.B dpkg\-deb +and this manpage were written by Ian Jackson. They are +Copyright (C)1995-1996 +by him and released under the GNU General Public Licence; there is NO +WARRANTY. See +.B /usr/doc/copyright/dpkg +and +.B /usr/doc/copyright/GPL +for details. diff --git a/scripts/dpkg-source.pl b/scripts/dpkg-source.pl index 51a5ae7c..ba33a53c 100644 --- a/scripts/dpkg-source.pl +++ b/scripts/dpkg-source.pl @@ -21,9 +21,10 @@ Usage: Options: -c get control info from this file\n". "(for -b) -l get per-version info from this file -F force change log format + -V= set a substitution variable + -T read variables here, not debian/substvars -D= override or add a .dsc field and value -U remove a field - -V= set a substitution variable -h print this message Relative filenames for -c and -l are interpreted starting at the source tree's top level directory. If is omitted then @@ -53,6 +54,8 @@ while (@ARGV && $ARGV[0] =~ m/^-/) { $remove{$1}= 1; } elsif (m/^-V(\w+)[=:]/) { $substvar{$1}= $'; + } elsif (m/^-T/) { + $varlistfile= $'; } elsif (m/^-h$/) { &usageversion; exit(0); } elsif (m/^--$/) { @@ -392,6 +395,7 @@ if ($opmode eq 'build') { " ($expectprefix)"); $fn =~ m,/\.\./, && &error("tarfile contains object with /../ in its name ($pname)"); + push(@filesinarchive,$fn); } close(CPIO); $? && subprocerr("cpio"); $/= "\n"; @@ -405,12 +409,17 @@ if ($opmode eq 'build') { exec('tar','-vvtf','-'); &syserr("exec tar -vvtf -"); } close(GZIP); + $efix= 0; file: - while (defined($fn= )) { - $fn =~ s/\n$//; - $fn =~ m,^(\S{10})\s+\S+/\S+\s+\d+\s+\w+\s+\d+\s+\d+:\d\d\s+\d+ (.*)$, || + while (length($_= )) { + s/\n$//; + m,^(\S{10})\s, || &error("tarfile contains unknown object listed by tar as \`$_'"); - $_= $1; $fn= $2; + $fn= $filesinarchive[$efix++]; + substr($_,length($_)-length($fn)-1) eq " $fn" || + &error("tarfile contains unexpected object listed by tar as \`$_',". + " expected \`$fn'"); + $_= $1; s/^([-dpsl])// || &error("tarfile contains object \`$fn' with unknown or forbidden type \`". substr($_,0,1)."'"); diff --git a/version.h b/version.h index 5692879a..ff826e2e 100644 --- a/version.h +++ b/version.h @@ -1 +1 @@ -#define DPKG_VERSION "1.3.0" /* This line modified by Makefile */ +#define DPKG_VERSION "1.3.1" /* This line modified by Makefile */ -- 2.39.5