From 31689412b55f81b20f2fff9d5386bcd88b9906a9 Mon Sep 17 00:00:00 2001 From: Guillem Jover Date: Mon, 12 Mar 2007 22:51:46 +0000 Subject: [PATCH] Split dpkg-source(1) into independent man pages, namely dpkg-buildpackage(1), dpkg-distaddfile(1), dpkg-genchanges(1), dpkg-gencontrol(1), dpkg-parsechangelog(1), dpkg-shlibdeps(1), deb-shlibs(5) and deb-substvars(5). --- TODO | 2 - debian/changelog | 4 + man/ChangeLog | 38 ++ man/Makefile.am | 33 +- man/deb-shlibs.5 | 30 + man/deb-substvars.5 | 146 ++++ man/dpkg-buildpackage.1 | 199 ++++++ man/dpkg-distaddfile.1 | 53 ++ man/dpkg-genchanges.1 | 162 +++++ man/dpkg-gencontrol.1 | 125 ++++ man/dpkg-parsechangelog.1 | 54 ++ man/dpkg-shlibdeps.1 | 136 ++++ man/dpkg-source.1 | 757 +++------------------ man/po/add_es/deb-shlibs.5.es.add | 5 + man/po/add_es/deb-substvars.5.es.add | 5 + man/po/add_es/dpkg-buildpackage.1.es.add | 5 + man/po/add_es/dpkg-distaddfile.1.es.add | 5 + man/po/add_es/dpkg-genchanges.1.es.add | 5 + man/po/add_es/dpkg-gencontrol.1.es.add | 5 + man/po/add_es/dpkg-parsechangelog.1.es.add | 5 + man/po/add_es/dpkg-shlibdeps.1.es.add | 5 + man/po/add_fr/deb-shlibs.5.fr.add | 4 + man/po/add_fr/deb-substvars.5.fr.add | 4 + man/po/add_fr/dpkg-buildpackage.1.fr.add | 4 + man/po/add_fr/dpkg-distaddfile.1.fr.add | 4 + man/po/add_fr/dpkg-genchanges.1.fr.add | 4 + man/po/add_fr/dpkg-gencontrol.1.fr.add | 4 + man/po/add_fr/dpkg-parsechangelog.1.fr.add | 4 + man/po/add_fr/dpkg-shlibdeps.1.fr.add | 4 + man/po/po4a.cfg | 40 ++ 30 files changed, 1157 insertions(+), 694 deletions(-) create mode 100644 man/deb-shlibs.5 create mode 100644 man/deb-substvars.5 create mode 100644 man/dpkg-buildpackage.1 create mode 100644 man/dpkg-distaddfile.1 create mode 100644 man/dpkg-genchanges.1 create mode 100644 man/dpkg-gencontrol.1 create mode 100644 man/dpkg-parsechangelog.1 create mode 100644 man/dpkg-shlibdeps.1 create mode 100644 man/po/add_es/deb-shlibs.5.es.add create mode 100644 man/po/add_es/deb-substvars.5.es.add create mode 100644 man/po/add_es/dpkg-buildpackage.1.es.add create mode 100644 man/po/add_es/dpkg-distaddfile.1.es.add create mode 100644 man/po/add_es/dpkg-genchanges.1.es.add create mode 100644 man/po/add_es/dpkg-gencontrol.1.es.add create mode 100644 man/po/add_es/dpkg-parsechangelog.1.es.add create mode 100644 man/po/add_es/dpkg-shlibdeps.1.es.add create mode 100644 man/po/add_fr/deb-shlibs.5.fr.add create mode 100644 man/po/add_fr/deb-substvars.5.fr.add create mode 100644 man/po/add_fr/dpkg-buildpackage.1.fr.add create mode 100644 man/po/add_fr/dpkg-distaddfile.1.fr.add create mode 100644 man/po/add_fr/dpkg-genchanges.1.fr.add create mode 100644 man/po/add_fr/dpkg-gencontrol.1.fr.add create mode 100644 man/po/add_fr/dpkg-parsechangelog.1.fr.add create mode 100644 man/po/add_fr/dpkg-shlibdeps.1.fr.add diff --git a/TODO b/TODO index b48d5728..b6eaadc9 100644 --- a/TODO +++ b/TODO @@ -28,8 +28,6 @@ lenny * Support lzma compression. - * Split dpkg-source man page into independent pages. - 1.14.x ------ diff --git a/debian/changelog b/debian/changelog index 28bf72aa..7227ccda 100644 --- a/debian/changelog +++ b/debian/changelog @@ -46,6 +46,10 @@ dpkg (1.14.0) UNRELEASED; urgency=low * Refactor compression filtering code. * Split override file information from dpkg-scanpackages(1) into deb-override(5) manual page. + * Split dpkg-source(1) into independent man pages, namely + dpkg-buildpackage(1), dpkg-distaddfile(1), dpkg-genchanges(1), + dpkg-gencontrol(1), dpkg-parsechangelog(1), dpkg-shlibdeps(1), + deb-shlibs(5) and deb-substvars(5). [ Updated dpkg translations ] * Romanian (Eddy Petrișor). diff --git a/man/ChangeLog b/man/ChangeLog index a47773bd..08371388 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -1,3 +1,41 @@ +2007-03-12 Guillem Jover + + * dpkg-source.1: Split individual man pages to ... + * deb-shlibs.5: ... here and ... + * deb-substvars.5: ... here and ... + * dpkg-buildpackage.1: ... here and ... + * dpkg-distaddfile.1: ... here and ... + * dpkg-genchanges.1: ... here and ... + * dpkg-gencontrol.1: ... here and ... + * dpkg-parsechangelog.1: ... here and ... + * dpkg-shlibdeps.1: ... here. + * Makefile.am (all-local): Do not make the symlinks anymore. + (dpkg_source_aliases): Move to ... + (dist_man_MANS): ... here. + (man_MANS): Remove variable. + (CLEANFILES): Likewise. + * po/po4a.cfg: Add stanzas for deb-shlibs.5, deb-substvars.5, + dpkg-buildpackage.1, dpkg-distaddfile.1, dpkg-genchanges.1, + dpkg-gencontrol.1, dpkg-parsechangelog.1 and dpkg-shlibdeps.1. + * po/add_fr/dpkg-source.1.fr.add: Copy to ... + * po/add_fr/deb-shlibs.5.fr.add: ... here and ... + * po/add_fr/deb-substvars.5.fr.add: ... here and ... + * po/add_fr/dpkg-buildpackage.1.fr.add: ... here and ... + * po/add_fr/dpkg-distaddfile.1.fr.add: ... here and ... + * po/add_fr/dpkg-genchanges.1.fr.add: ... here and ... + * po/add_fr/dpkg-gencontrol.1.fr.add: ... here and ... + * po/add_fr/dpkg-parsechangelog.1.fr.add: ... here and ... + * po/add_fr/dpkg-shlibdeps.1.fr.add: ... here. + * po/add_es/dpkg-source.1.es.add: Copy to ... + * po/add_es/deb-shlibs.5.es.add: ... here and ... + * po/add_es/deb-substvars.5.es.add: ... here and ... + * po/add_es/dpkg-buildpackage.1.es.add: ... here and ... + * po/add_es/dpkg-distaddfile.1.es.add: ... here and ... + * po/add_es/dpkg-genchanges.1.es.add: ... here and ... + * po/add_es/dpkg-gencontrol.1.es.add: ... here and ... + * po/add_es/dpkg-parsechangelog.1.es.add: ... here and ... + * po/add_es/dpkg-shlibdeps.1.es.add: ... here. + 2007-03-12 Guillem Jover * Makefile.am (dist_man_MANS): Add deb-override.5. diff --git a/man/Makefile.am b/man/Makefile.am index 6f0bce85..9a19e3fe 100644 --- a/man/Makefile.am +++ b/man/Makefile.am @@ -3,13 +3,6 @@ all-local: po4a --no-backups --variable srcdir=$(srcdir) \ $(srcdir)/po/po4a.cfg -# Make the symlink - for lang in $(LINGUAS); do \ - cd $$lang; \ - $(MAKE) -f ../Makefile -B $(dpkg_source_aliases) \ - srcdir="$(realpath $(srcdir))/$$lang"; \ - cd ..; \ - done clean-local: po4a --rm-backups --rm-translations --variable srcdir=$(srcdir) \ @@ -35,17 +28,25 @@ dist_man_MANS = \ 822-date.1 \ cleanup-info.8 \ deb-control.5 \ + deb-shlibs.5 \ + deb-substvars.5 \ deb-old.5 \ deb-override.5 \ deb.5 \ dpkg-architecture.1 \ + dpkg-buildpackage.1 \ dpkg-checkbuilddeps.1 \ dpkg-deb.1 \ + dpkg-distaddfile.1 \ dpkg-divert.8 \ + dpkg-genchanges.1 \ + dpkg-gencontrol.1 \ dpkg-name.1 \ + dpkg-parsechangelog.1 \ dpkg-query.1 \ dpkg-scanpackages.1 \ dpkg-scansources.1 \ + dpkg-shlibdeps.1 \ dpkg-source.1 \ dpkg-split.1 \ dpkg-statoverride.8 \ @@ -57,21 +58,3 @@ dist_man_MANS = \ start-stop-daemon.8 \ update-alternatives.8 -dpkg_source_aliases = \ - dpkg-buildpackage.1 \ - dpkg-distaddfile.1 \ - dpkg-genchanges.1 \ - dpkg-gencontrol.1 \ - dpkg-parsechangelog.1 \ - dpkg-shlibdeps.1 - -man_MANS = $(dpkg_source_aliases) -CLEANFILES = $(dpkg_source_aliases) - - -$(dpkg_source_aliases): - if [ -f dpkg-source.1 ] || [ -f $(srcdir)/dpkg-source.1 ]; then \ - echo ".so man1/dpkg-source.1" > $@; \ - chmod 644 $@; \ - fi - diff --git a/man/deb-shlibs.5 b/man/deb-shlibs.5 new file mode 100644 index 00000000..b7f9494b --- /dev/null +++ b/man/deb-shlibs.5 @@ -0,0 +1,30 @@ +.\" This manpage is copyright (C) 1996 Michael Shields . +.\" +.\" This is free software; you may 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. +.\" +.\" This 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 dpkg; if not, write to the Free Software +.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +.TH deb\-shlibs 5 "2007-03-08" "Debian Project" "dpkg utilities" +.SH NAME +deb\-shlibs \- Debian shared library information file +. +.SH SYNOPSIS +shlibs +. +.SH DESCRIPTION +The format for a shared library dependency information entry in these +files is (see the Debian Policy Manual for details): +.PP + +. +.SH SEE ALSO +.BR dpkg\-shlibdeps (1). diff --git a/man/deb-substvars.5 b/man/deb-substvars.5 new file mode 100644 index 00000000..a4bd06ca --- /dev/null +++ b/man/deb-substvars.5 @@ -0,0 +1,146 @@ +.\" Authors: Ian Jackson +.TH deb\-substvars 1 "2007-03-06" "Debian Project" "dpkg utilities" +.SH NAME +deb\-substvars +\- Debian source substitution variables +. +.SH SYNOPSIS +substvars +. +.SH DESCRIPTION +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 names consist of alphanumerics, hyphens and colons and start +with an alphanumeric. 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 occurrence of the +string +.B ${} +(which is not a legal substitution) is replaced with a +.B $ +sign. + +Variables 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\fR. +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 source:Version +The source package version. +.TP +.B source:Upstream\-Version +The upstream source package version, including the Debian version epoch if +any. +.TP +.B binary:Version +The binary package version (which may differ from source:Version in a binNMU +for example). +.TP +.B Source\-Version +The source package version (from the changelog file). This variable is now +\fBdeprecated\fP as its meaning is different from its function, please use +the \fBsource:Version\fP or \fBbinary:Version\fP as appropriate. +.TP +.B Installed\-Size +The total size of the package's installed files. This value is copied +into the corresponding control file field; setting it will modify the +value of that field. If this variable isn't set +.B dpkg\-gencontrol +will use +.B du \-k debian/tmp +to find the default value. +.TP +.B Extra\-Size +Additional disk space used when the package is installed. If this +variable is set its value is added to that of the +.B Installed\-Size +variable (whether set explicitly or using the default value) before it +is copied into the +.B Installed\-Size +control file field. +.TP +.BI F: fieldname +The value of the output field +.IR fieldname +(which must be given in the canonical capitalisation). Setting these +variables has no effect other than on places where they are expanded +explicitly. +.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. +.TP +.BI shlibs: dependencyfield +Variable settings with names of this form are generated by +.BR dpkg\-shlibdeps . +.TP +.B dpkg:Upstream\-Version +The upstream version of dpkg. +.TP +.B dpkg:Version +The full version of dpkg. +.LP +If a variable is referred to but not defined it generates a warning +and an empty value is assumed. +. +.SH FILES +.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. + +.SH SEE ALSO +.BR dpkg (1), +.BR dpkg\-genchanges (1), +.BR dpkg\-gencontrol (1), +.BR dpkg\-shlibdeps (1), +.BR dpkg\-source (1). +. +.SH AUTHOR +The utilities and this manpage were written by Ian Jackson. +. +.SH COPYRIGHT +Copyright (C) 1995-1996 Ian Jackson +.br +Copyright (C) 2000 Wichert Akkerman +.sp +This is free software; see the GNU General Public Licence version 2 or later +for copying conditions. There is NO WARRANTY. diff --git a/man/dpkg-buildpackage.1 b/man/dpkg-buildpackage.1 new file mode 100644 index 00000000..0570d18f --- /dev/null +++ b/man/dpkg-buildpackage.1 @@ -0,0 +1,199 @@ +.TH dpkg\-buildpackage 1 "2007-03-07" "Debian Project" "dpkg utilities" +.SH NAME +dpkg\-buildpackage \- build source packages +. +.SH SYNOPSIS +.B dpkg\-buildpackage +.RI [ options ] +. +.SH DESCRIPTION +.B dpkg\-buildpackage +is a control script which can be used to help automate the building of +a package. +. +.SH OPTIONS +.TP +.B \-b +Specifies a binary-only build, no source files are to be built and/or +distributed, and +.TP +.B \-B +Specifies a binary-only build, no architecture independent binary package +files are to be distributed either. +.TP +.B \-S +Specifies a source-only build, no binary packages need to be made. +.PP +These options control whether the original source archive is included +in the upload generated by +.BR dpkg\-buildpackage +if any source is being generated (i.e., +.BR \-b " or " \-B +haven't been used). +.TP +.B \-si +Include the original source if the version number ends in +.BR \-0 " or " \-1 , +i.e. if the Debian revision part of the version number is +.BR 0 " or " 1 . +.B This is the default. +.TP +.B \-sa +Forces the inclusion of the original source. +.TP +.B \-sd +Forces the exclusion of the original source and includes only the diff. +.TP +.BI \-a architecture +Specify the Debian architecture we build for. The architecture of the +machine we build on is determined automatically, and is also the default +for the host machine. +.TP +.BI \-v version +Use changelog information from all versions strictly later than +.IR version . +.TP +.BI \-C 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 package, +rather than using the information from the source tree's control file. +.TP +.BI \-e 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 +.B \-D +Check build dependencies and conflicts; abort if unsatisfied. +.TP +.B \-d +Do not check build dependencies and conflicts. +.TP +.BI \-W +Turn certain errors into warnings. Only dpkg\-source uses this, but +.BR dpkg\-buildpackage +recognizes it, and passes it thru to +.BR dpkg\-source "." +.TP +.BI \-E +Negates a previously set +.BR \-W "." +Only dpkg\-source uses this, but +.BR dpkg\-buildpackage +recognizes it, and passes it thru to +.BR dpkg\-source "." +.TP +.B \-nc +Do not clean the source tree (implies \fB\-b\fP). +.TP +.B \-tc +Clean the source tree (using +.I gain-root-command +.BR "debian/rules clean" ) +after the package has been built. +.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. +.\" what happens, if it contains spaces? (hs) +.I gain-root-command +might typically be +.BR fakeroot ", " sudo ", " super " or " really . +.B su +is not suitable, since it requires a +.B \-c +option to run a command and even then it can only invoke the user's +shell with +.B \-c +instead of passing arguments individually to the command to be run. +.TP +.BI \-p sign-command +When +.B dpkg\-buildpackage +needs to execute GPG or PGP to sign a source control +.RB ( .dsc ) +file or a +.B .changes +file it will run +.I sign-command +(searching the +.B PATH +if necessary) instead of +.BR pgp . +.I sign-command +will get all the arguments that +.B pgp +would have gotten. If +.I sign-command +takes its arguments in GPG rather than PGP style, you should give +the +.B \-sgpg +option. +.I sign-command +should not contain spaces or any other shell metacharacters. +.TP +.BI \-k key-id +Specify a key-ID to use when signing packages. +.TP +.BR \-us +Do not sign the source package. +.TP +.BR \-uc +Do not sign the .changes file. +.TP +.BR \-i [\fIregexp\fP] +Passed unchanged to +.BR dpkg\-source . +.TP +.BI \-I filename +Passed unchanged to +.BR dpkg\-source . +May be repeated multiple times. +.TP +.BI \-\-admindir= dir +Change the location of the \fBdpkg\fR database. The default location is +\fI/var/lib/dpkg\fP. +.TP +.BR \-h ", " \-\-help +Show the usage message and exit. +.TP +.BR \-\-version +Show the version and exit. +. +.SH BUGS +It should be possible to specify spaces and shell metacharacters in +and initial arguments for +.IR gain-root-command " and " sign-command . +. +.SH FILES +.BR dpkg\-source (1), +.BR dpkg\-architecture (1), +.BR dpkg\-genchanges (1), +.BR gpg (1), +.BR pgp (1). +. +.SH AUTHORS +Copyright (C) 1995-1996 Ian Jackson +.br +Copyright (C) 2000 Wichert Akkerman +.sp +This is free software; see the GNU General Public Licence version 2 or later +for copying conditions. There is NO WARRANTY. diff --git a/man/dpkg-distaddfile.1 b/man/dpkg-distaddfile.1 new file mode 100644 index 00000000..acd81ed5 --- /dev/null +++ b/man/dpkg-distaddfile.1 @@ -0,0 +1,53 @@ +.TH dpkg\-distaddfile 1 "2007-03-07" "Debian Project" "dpkg utilities" +.SH NAME +dpkg\-distaddfile \- add entries to debian/files +. +.SH SYNOPSIS +.B dpkg\-distaddfile +.RI [ options ] " filename section priority" +. +.SH DESCRIPTION +.B dpkg\-distaddfile +adds an entry for a named file to +.BR debian/files . + +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 OPTIONS +.TP +.BI \-f fileslistfile +Read or write the list of files to be uploaded here, rather than using +.BR debian/files . +.TP +.BR \-h ", " \-\-help +Show the usage message and exit. +.TP +.BR \-\-version +Show the version and exit. +. +.SH FILES +.TP +.B debian/files +The list of generated files which are part of the upload being +prepared. +.B dpkg\-distaddfile +can be used to add additional files. +. +.SH AUTHORS +Copyright (C) 1995-1996 Ian Jackson +.br +Copyright (C) 2000 Wichert Akkerman +.sp +This is free software; see the GNU General Public Licence version 2 or later +for copying conditions. There is NO WARRANTY. diff --git a/man/dpkg-genchanges.1 b/man/dpkg-genchanges.1 new file mode 100644 index 00000000..896ab374 --- /dev/null +++ b/man/dpkg-genchanges.1 @@ -0,0 +1,162 @@ +.TH dpkg\-genchanges 1 "2007-03-07" "Debian Project" "dpkg utilities" +.SH NAME +dpkg\-genchanges \- generate Debian .changes files +. +.SH SYNOPSIS +.B dpkg\-genchanges +.RI [ options ] +.br +. +.SH DESCRIPTION +.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)." +. +.SH OPTIONS +.TP +.BI \-v version +Causes changelog information from all versions strictly later than +.I version +to be used. +.TP +.BI \-C 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 package, +rather than using the information from the source tree's control file. +.TP +.BI \-e 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 +.BR \-si ", " \-sa ", " \-sd +These options control whether the original source archive is included +in the upload generated by +.BR dpkg\-genchanges +if any source is being generated (i.e., +.BR \-b " or " \-B +haven't been used). + +By default, or if +.B \-si +is specified, the original source will be included if the version +number ends in +.BR \-0 " or " \-1 , +i.e. if the Debian revision part of the version number is +.BR 0 " or " 1 . + +.B \-sa +forces the inclusion of the original source; +.B \-sd +forces its exclusion and includes only the diff. +.TP +.BI \-V name = value +Set an output substitution variable. +See \fBdpkg\-substvars\fP(5) for a discussion of output substitution. +.TP +.BI \-T substvarsfile +Read substitution variables in +.IR substvarsfile ; +the default is +.BR debian/substvars . +.TP +.BI \-D field = value +Override or add an output control file field. +.TP +.BI \-U field +Remove an output control file field. +.TP +.BR \-b ", " \-B ", " \-S +For +.BR dpkg\-genchanges " and " dpkg\-buildpackage +.BR \-b " and " \-B +specify 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 \-S +specifies that only the source should be uploaded and no binary packages +need to be made. The distinction between +.BR \-b " and " \-B +is only used by +.BR dpkg\-buildpackage ; +.B dpkg\-genchanges +just produces a +.B .changes +file for whatever files were produced by the +.B binary\-* +target(s) of the package being built. +.TP +.BI \-c controlfile +Specifies the main source control file to read information from. The +default is +.BR debian/control . +.TP +.BI \-l changelogfile +Specifies the change log file to read information from. The +default is +.BR debian/changelog . +.TP +.BI \-f fileslistfile +Read the list of files to be uploaded here, rather than using +.BR debian/files . +.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 or failing that +defaults to the debian standard format. +.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). +.TP +.B \-q +Usually +.B dpkg\-genchanges +will produce informative messages on standard error, for example about +how many of the package's source files are being uploaded. +.B \-q +suppresses these messages. +.TP +.BR \-h ", " \-\-help +Show the usage message and exit. +.TP +.BR \-\-version +Show the version and exit. +. +.SH FILES +.TP +.B debian/files +The list of generated files which are part of the upload being +prepared. +.B dpkg\-genchanges +reads the data here when producing a +.B .changes +file. +. +.SH AUTHORS +Copyright (C) 1995-1996 Ian Jackson +.br +Copyright (C) 2000 Wichert Akkerman +.sp +This is free software; see the GNU General Public Licence version 2 or later +for copying conditions. There is NO WARRANTY. diff --git a/man/dpkg-gencontrol.1 b/man/dpkg-gencontrol.1 new file mode 100644 index 00000000..ddb9a557 --- /dev/null +++ b/man/dpkg-gencontrol.1 @@ -0,0 +1,125 @@ +.TH dpkg\-gencontrol 1 "2007-03-07" "Debian Project" "dpkg utilities" +.SH NAME +dpkg\-gencontrol \- generate Debian control files +. +.SH SYNOPSIS +.B dpkg\-gencontrol +.RI [ options ] +. +.SH DESCRIPTION +.B dpkg\-gencontrol +reads information from an unpacked Debian source tree and generates a +binary package control file (which defaults to debian/tmp/DEBIAN/control); +it also adds an entry for the binary package to +.BR debian/files . +. +.SH OPTIONS +.TP +.BI \-v version +Sets the version number of the binary package which will be generated. +.TP +.BI \-V name = value +Set an output substitution variable. See \fBdpkg-substvars\fP(5) for +discussion of output substitution. +.TP +.BI \-T substvarsfile +Read substitution variables in +.IR substvarsfile ; +the default is +.BR debian/substvars . +.TP +.BI \-D field = value +Override or add an output control file field. +.TP +.BI \-U field +Remove an output control file field. +.TP +.BI \-c controlfile +Specifies the main source control file to read information from. The +default is +.BR debian/control . +.TP +.BI \-l changelogfile +Specifies the change log file to read information from. The +default is +.BR debian/changelog . +.TP +.BI \-f fileslistfile +Read or write the list of files to be uploaded here, rather than using +.BR debian/files . +.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 or failing that +defaults to the debian standard format. +.TP +.BI \-p package +Generate information for the binary package +.IR package . +If the source control file lists only one binary package then this +option may be omitted; otherwise it is essential to select which +binary package's information to generate. +.TP +.BI \-n filename +Assume the filename of the package will be +.I filename +instead of the normal package_version_arch.deb filename. +.TP +.BR \-is ", " \-ip ", " \-isp +These options are ignored for compatibility with older versions of +dpkg-dev but are now deprecated. Previously they were used to tell +dpkg-gencontrol to include the Section and Priority fields in the +control file. This is now the default behaviour. If you want to +get the old behaviour you can use the +.B \-U +option to delete the fields from the control file. +.TP +.BI \-P packagebuilddir +Tells +.B dpkg\-source +that the package is being built in +.I packagebuilddir +instead of +.BR debian/tmp . +This value is used to find the default value of the +.B Installed\-Size +substitution variable and control file field (using +.BR du ), +and for the default location of the output file. +.TP +.B \-O +Print the control file to standard output, rather than to +.B debian/tmp/DEBIAN/control +(or +.IB packagebuilddir /DEBIAN/control +if +.B \-P +was used). +.TP +.BR \-h ", " \-\-help +Show the usage message and exit. +.TP +.BR \-\-version +Show the version and exit. +. +.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/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; +. +.SH AUTHORS +Copyright (C) 1995-1996 Ian Jackson +.br +Copyright (C) 2000 Wichert Akkerman +.sp +This is free software; see the GNU General Public Licence version 2 or later +for copying conditions. There is NO WARRANTY. diff --git a/man/dpkg-parsechangelog.1 b/man/dpkg-parsechangelog.1 new file mode 100644 index 00000000..0367dcc1 --- /dev/null +++ b/man/dpkg-parsechangelog.1 @@ -0,0 +1,54 @@ +.TH dpkg\-parsechangelog 1 "2007-03-07" "Debian Project" "dpkg utilities" +.SH NAME +dpkg\-parsechangelog \- parse Debian changelog files +. +.SH SYNOPSIS +.B dpkg\-parsechangelog +.RI [ options ] +. +.SH DESCRIPTION +.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. +. +.SH OPTIONS +.TP +.BI \-l changelogfile +Specifies the change log file to read information from. The +default is +.BR debian/changelog . +.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 or failing that +defaults to the debian standard format. +.TP +.BI \-L libdir +FIXME not used in the source!? +.TP +.BI \-v version +Use changelog information from all versions strictly later than +.IR version . +.TP +.BR \-h ", " \-\-help +Show the usage message and exit. +.TP +.BR \-\-version +Show the version and exit. +. +.SH FILES +.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. +. +.SH AUTHORS +Copyright (C) 1995-1996 Ian Jackson +.br +Copyright (C) 2000 Wichert Akkerman +.sp +This is free software; see the GNU General Public Licence version 2 or later +for copying conditions. There is NO WARRANTY. diff --git a/man/dpkg-shlibdeps.1 b/man/dpkg-shlibdeps.1 new file mode 100644 index 00000000..fb825786 --- /dev/null +++ b/man/dpkg-shlibdeps.1 @@ -0,0 +1,136 @@ +.TH dpkg\-shlibdeps 1 "2007-03-07" "Debian Project" "dpkg utilities" +.SH NAME +dpkg\-shlibdeps +. +.SH SYNOPSIS +.B dpkg\-shlibdeps +.RI [ options ] +.IR executable | \fB-e\fPexecutable +.RI [ options ] +. +.SH DESCRIPTION +.B dpkg\-shlibdeps +calculates shared library dependencies for executables named in its +arguments. The dependencies are added to the substitution +variables file +.B debian/substvars +as variable names +.BI shlibs: dependencyfield +where +.I dependencyfield +is a dependency field name. Any other variables starting +.I shlibs: +are removed from the file. +.B dpkg\-shlibdeps +will read shared library dependency information from +.BR debian/shlibs.local , +.BR /etc/dpkg/shlibs.override , +the +.B shlibs +control area file of the package containing the file which +.B objdump +reports as satisfying the library dependency, or +.BR /etc/dpkg/shlibs.default . +The first match will be used. +. +.SH OPTIONS +.B dpkg\-shlibdeps +interprets non-option arguments as executable names, just as if they'd +been supplied as +.BI \-e executable\fR. +.TP +.BI \-e executable +Include dependencies appropriate for the shared libraries required by +.IR executable . +.TP +.BI \-d dependencyfield +Add dependencies to be added to the control file dependency field +.IR dependencyfield . +(The dependencies for this field are placed in the variable +.BI shlibs: dependencyfield\fR.) + +The +.BI \-d dependencyfield +option takes effect for all executables after the option, until the +next +.BI \-d dependencyfield\fR. +The default +.I dependencyfield +is +.BR Depends . + +If the same dependency entry (or set of alternatives) appears in more +than one of the recognised dependency field names +.BR Pre\-Depends ", " Depends ", " Recommends ", " Enhances " or " Suggests +then +.B dpkg\-shlibdeps +will automatically remove the dependency from all fields except the +one representing the most important dependencies. +.TP +.BI \-p varnameprefix +Start substitution variables with +.IB varnameprefix : +instead of +.BR shlibs: . +Likewise, any existing substitution variables starting with +.IB varnameprefix : +(rather than +.BR shlibs: ) +are removed from the the substitution variables file. +.TP +.B \-O +Print substitution variable settings to standard output, rather than being +added to the substitution variables file +.RB ( debian/substvars +by default). +.TP +.BI \-t type +Prefer shared library dependency information tagged for the given +package type. If no tagged information is available, falls back to untagged +information. The default package type is "deb". Shared library dependency +information is tagged for a given type by prefixing it with the name of the +type, a colon, and whitespace. +.TP +.BI \-L localshlibsfile +Read overriding shared library dependency information from +.I localshlibsfile +instead of +.BR debian/shlibs.local . +.TP +.BI \-T substvarsfile +Write substitution variables in +.IR substvarsfile ; +the default is +.BR debian/substvars . +.TP +.BI \-\-admindir= dir +Change the location of the \fBdpkg\fR database. The default location is +\fI/var/lib/dpkg\fP. +.TP +.BR \-h ", " \-\-help +Show the usage message and exit. +.TP +.BR \-\-version +Show the version and exit. +. +.SH FILES +.TP +.B debian/shlibs.local +Package-local overriding shared library dependency information. +.TP +.B /etc/dpkg/shlibs.override +Per-system overriding shared library dependency information. +.TP +.B /etc/dpkg/shlibs.default +Per-system default shared library dependency information. +. +.SH "SEE ALSO" +.BR deb\-shlibs (5). +. +.SH AUTHORS +Copyright (C) 1995-1996 Ian Jackson +.br +Copyright (C) 2000 Wichert Akkerman +.sp +This is free software; see the GNU General Public Licence version 2 or later +for copying conditions. There is NO WARRANTY. diff --git a/man/dpkg-source.1 b/man/dpkg-source.1 index a30a2265..0a957b5b 100644 --- a/man/dpkg-source.1 +++ b/man/dpkg-source.1 @@ -1,283 +1,34 @@ .\" Authors: Ian Jackson -.TH dpkg\-source 1 "2007-02-28" "Debian Project" "dpkg utilities" +.TH dpkg\-source 1 "2007-03-07" "Debian Project" "dpkg utilities" .SH NAME -dpkg\-source, dpkg\-gencontrol, dpkg\-shlibdeps, dpkg\-genchanges, -dpkg\-buildpackage, dpkg\-distaddfile, dpkg\-parsechangelog +dpkg\-source, \- Debian source package tools . .SH SYNOPSIS .B dpkg\-source -.BI "\-x " filename .dsc -.RI [ output-directory ] -.br -.B dpkg\-source \-b -.RI [ options "] " directory " [" orig-directory | orig-targz |''] -.br -.B dpkg\-gencontrol -.RI [ options ] -.br -.B dpkg\-shlibdeps -.IR 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 ] +.I command +. .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 (which defaults to debian/tmp/DEBIAN/control); -it also adds an entry for the binary package to -.BR debian/files . - -.B dpkg\-shlibdeps -calculates shared library dependencies for executables named in its -arguments. The dependencies are added to the substitution -variables file -.B debian/substvars -as variable names -.BI shlibs: dependencyfield -where -.I dependencyfield -is a dependency field name. Any other variables starting -.I shlibs: -are removed from the file. -.B dpkg\-shlibdeps -will read shared library dependency information from -.BR debian/shlibs.local , -.BR /etc/dpkg/shlibs.override , -the -.B shlibs -control area file of the package containing the file which -.B objdump -reports as satisfying the library dependency, or -.BR /etc/dpkg/shlibs.default . -The first match will be used. -The format for a shared library dependency information entry in these -files is (see the Debian Policy Manual for details): -.br - - -.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 -.BR \-h , \-\-help -Display the particular program's usage message, including a synopsis of -the options it understands. -This option is understood by all the source package tools. -.TP -.BR \-\-version -Display the particular program's version, including copyright and license -information. -This option is understood by all the source package tools. -.TP -.BI \-\-admindir= dir -In -.BR dpkg\-buildpackage " and " dpkg\-shlibdeps -change the location of the \fBdpkg\fR database. The default location is -\fI/var/lib/dpkg\fP. -.TP -.BI \-v version -In -.BR dpkg\-buildpackage ", " dpkg\-genchanges " and " dpkg\-parsechangelog -this causes changelog information from all versions strictly later -than -.I version -to be used. - -In -.BR dpkg\-gencontrol -it sets the version number of the binary package which will be -generated. -.TP -.BI \-C changesdescription -Read the description of the changes from the file -.I changesdescription -rather than using the information from the source tree's changelog -file. This is understood by -.BR dpkg\-buildpackage " and " dpkg\-genchanges . -.TP -.BI \-m maintaineraddress -Use -.I maintaineraddress -as the name and email address of the maintainer for this package, -rather than using the information from the source tree's control file. -This is understood by -.BR dpkg\-buildpackage " and " dpkg\-genchanges . -.TP -.BI \-e 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. -This is understood by -.BR dpkg\-buildpackage " and " dpkg\-genchanges . -.TP -.BR \-si ", " \-sa ", " \-sd -These options control whether the original source archive is included -in the upload generated by -.BR dpkg\-buildpackage " or " dpkg\-genchanges -if any source is being generated (i.e., -.BR \-b " or " \-B -haven't been used). - -By default, or if -.B \-si -is specified, the original source will be included if the version -number ends in -.BR \-0 " or " \-1 , -i.e. if the Debian revision part of the version number is -.BR 0 " or " 1 . - -.B \-sa -forces the inclusion of the original source; -.B \-sd -forces its exclusion and includes only the diff. -.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 (or, for -.BR dpkg\-shlibdeps , -write) substitution variables in -.IR substvarsfile ; -the default is -.BR debian/substvars . -This option is understood by -.BR dpkg\-source ", " dpkg\-gencontrol ", " dpkg\-shlibdeps " 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 | \-S -For -.BR dpkg\-genchanges " and " dpkg\-buildpackage -.BR \-b " and " \-B -specify 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 \-S -specifies that only the source should be uploaded and no binary packages -need to be made. The distinction between -.BR \-b " and " \-B -is only used by -.BR dpkg\-buildpackage ; -.B dpkg\-genchanges -just produces a -.B .changes -file for whatever files were produced by the -.B binary\-* -target(s) of the package being built. - -.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 or failing that -defaults to the debian standard format. -This option is understood by -.BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges . -.TP -.BI \-W -This option turns certain errors into warnings. Only dpkg\-source uses -this, but -.BR dpkg\-buildpackage -recognizes it, and passes it thru to -.BR dpkg\-source "." -.TP -.BI \-E -This option negates a previously set -.BR \-W "." -It is currently only understood by -.BR dpkg\-buildpackage " and " dpkg\-source "." -.SH dpkg\-SOURCE OPTIONS -When the common options -.BR \-c " and " \-l -are given with relative pathnames these are interpreted starting at -the source tree's top level directory. +. +.SH COMMANDS .TP -.B \-x +.BI "\-x " filename ".dsc " \fR[\fPoutput-directory\fR]\fP Extract a source package. One non-option argument must be supplied, the name of the Debian source control file .RB ( .dsc ). An optional second non-option argument may be supplied to specify the directory to extract the source package to, this must not exist. If no output directory is specified, the source package is extracted into -a directory named \fIsource\fR-\fIversion-\fR under the current working +a directory named \fIsource\fR-\fIversion\fR under the current working directory. -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 @@ -292,8 +43,8 @@ extractors' umask; if the parent directory is setgid then the extracted directories will be too, and all the files and directories will inherit its group ownership. .TP -.B \-b -Build: pack up a source tree. One or two non-option arguments should +.RI "\fB\-b\fP [" options "] " directory " [" orig-directory | orig-targz |''] +Build a source package. 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 be the name of the original source directory or tarfile or @@ -307,7 +58,57 @@ or the original source directory or the empty string (no original source, and so no diff) depending on the arguments. .TP -.B \-i[] +.BR \-h ", " \-\-help +Show the usage message and exit. +.TP +.BR \-\-version +Show the version and exit. +. +.SH OPTIONS +.TP +.BI \-c controlfile +Specifies the main source control file to read information from. The +default is +.BR debian/control . +If given with relative pathname this is interpreted starting at +the source tree's top level directory. +.TP +.BI \-l changelogfile +Specifies the change log file to read information from. The +default is +.BR debian/changelog . +If given with relative pathname this is interpreted starting at +the source tree's top level directory. +.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 or failing that +defaults to the debian standard format. +.TP +.BI \-V name = value +Set an output substitution variable. +See \fBdpkg\-substvars\fP(5) for a discussion of output substitution. +.TP +.BI \-T substvarsfile +Read substitution variables in +.IR substvarsfile ; +the default is +.BR debian/substvars . +.TP +.BI \-D field = value +Override or add an output control file field. +.TP +.BI \-U field +Remove an output control file field. +.TP +.BI \-W +This option turns certain errors into warnings. +.TP +.BI \-E +This option negates a previously set +.BR \-W "." +.TP +.BR \-i [\fIregexp\fP] You may specify a perl regular expression to match files you want filtered out of the list of files for the diff. (This list is generated by a find command.) \fB\-i\fR by itself enables the option, @@ -327,13 +128,34 @@ from the ones in your working directory, thus causing them to be unnecessarily included in every .diff.gz, unless you use the \fB\-i\fR switch. .TP -.B \-I +.BI \-I filename If this option is specified, the filename will be passed to tar's \-\-exclude option when it is called to generate a .orig.tar.gz or .tar.gz file. For example, \-ICVS will make tar skip over CVS directories when generating a .tar.gz file. The option may be repeated multiple times to list multiple filenames to exclude. .TP +.BR \-si ", " \-sa ", " \-sd +These options control whether the original source archive is included +in the upload generated by +.BR dpkg\-buildpackage +if any source is being generated (i.e., +.BR \-b " or " \-B +haven't been used). + +By default, or if +.B \-si +is specified, the original source will be included if the version +number ends in +.BR \-0 " or " \-1 , +i.e. if the Debian revision part of the version number is +.BR 0 " or " 1 . + +.B \-sa +forces the inclusion of the original source; +.B \-sd +forces its exclusion and includes only the diff. +.TP .BR \-sa , \-sp , \-su , \-sk , \-sA , \-sP , \-sU , \-sK , \-ss " with " \-b If .BR \-sk " or " \-sp @@ -438,396 +260,7 @@ All the .B \-sX options are mutually exclusive. If you specify more than one only the last one will be used. -.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 only one binary package then this -option may be omitted; otherwise it is essential to select which -binary package's information to generate. -.TP -.BI \-n filename -Assume the filename of the package will be -.I filename -instead of the normal package_version_arch.deb filename. -.TP -.BR \-is ", " \-ip ", " \-isp -These options are ignored for compatibility with older versions of -dpkg-dev but are now deprecated. Previously they were used to tell -dpkg-gencontrol to include the Section and Priority fields in the -control file. This is now the default behaviour. If you want to -get the old behaviour you can use the -.B \-U -option to delete the fields from the control file. -.TP -.BI \-P packagebuilddir -Tells -.B dpkg\-source -that the package is being built in -.I packagebuilddir -instead of -.BR debian/tmp . -This value is used to find the default value of the -.B Installed\-Size -substitution variable and control file field (using -.BR du ), -and for the default location of the output file. -.TP -.B \-O -Causes the control file to be printed to standard output, rather than -to -.B debian/tmp/DEBIAN/control -(or -.IB packagebuilddir /DEBIAN/control -if -.B \-P -was used). -.SH dpkg\-SHLIBDEPS OPTIONS -.B dpkg\-shlibdeps -interprets non-option arguments as executable names, just as if they'd -been supplied as -.BI \-e executable\fR. -.TP -.BI \-e executable -Include dependencies appropriate for the shared libraries required by -.IR executable . -.TP -.BI \-d dependencyfield -Add dependencies to be added to the control file dependency field -.IR dependencyfield . -(The dependencies for this field are placed in the variable -.BI shlibs: dependencyfield\fR.) - -The -.BI \-d dependencyfield -option takes effect for all executables after the option, until the -next -.BI \-d dependencyfield\fR. -The default -.I dependencyfield -is -.BR Depends . - -If the same dependency entry (or set of alternatives) appears in more -than one of the recognised dependency field names -.BR Pre\-Depends ", " Depends ", " Recommends ", " Enhances " or " Suggests -then -.B dpkg\-shlibdeps -will automatically remove the dependency from all fields except the -one representing the most important dependencies. -.TP -.BI \-p varnameprefix -Causes substitution variables to start with -.IB varnameprefix : -instead of -.BR shlibs: . -Likewise, any existing substitution variables starting with -.IB varnameprefix : -(rather than -.BR shlibs: ) -are removed from the the substitution variables file. -.TP -.BI \-L localshlibsfile -Causes -.B dpkg\-shlibdeps -to read overriding shared library dependency information from -.I localshlibsfile -instead of -.BR debian/shlibs.local . -.TP -.B \-O -Causes the substitution variable settings to be printed to standard -output, rather than being added to the substitution variables file -.RB ( debian/substvars -by default). -.TP -.BI \-t type -Causes -.B dpkg\-shlibdeps -to prefer shared library dependency information tagged for the given -package type. If no tagged information is available, falls back to untagged -information. The default package type is "deb". Shared library dependency -information is tagged for a given type by prefixing it with the name of the -type, a colon, and whitespace. -.SH dpkg\-GENCHANGES OPTIONS -.B dpkg\-genchanges -does not take any non-option arguments. -.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). -.TP -.B \-q -Usually -.B dpkg\-genchanges -will produce informative messages on standard error, for example about -how many of the package's source files are being uploaded. -.B \-q -suppresses these messages. -.SH dpkg\-BUILDPACKAGE OPTIONS -.B dpkg\-buildpackage -does not take any non-option arguments. -.TP -.BI \-k key-id -Specify a key-ID to use when signing packages. -.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. -.\" what happens, if it contains spaces? (hs) -.I gain-root-command -might typically be -.BR fakeroot ", " sudo ", " super " or " really . -.B su -is not suitable, since it requires a -.B \-c -option to run a command and even then it can only invoke the user's -shell with -.B \-c -instead of passing arguments individually to the command to be run. -.TP -.BI \-p sign-command -When -.B dpkg\-buildpackage -needs to execute GPG or PGP to sign a source control -.RB ( .dsc ) -file or a -.B .changes -file it will run -.I sign-command -(searching the -.B PATH -if necessary) instead of -.BR pgp . -.I sign-command -will get all the arguments that -.B pgp -would have gotten. If -.I sign-command -takes its arguments in GPG rather than PGP style, you should give -the -.B \-sgpg -option. -.I sign-command -should not contain spaces or any other shell metacharacters. -.TP -.B \-tc -Clean the source tree (using -.I gain-root-command -.BR "debian/rules clean" ) -after the package has been built. -.TP -.BR \-us ", " \-uc -Do not sign the source package or the .changes file, respectively. -.TP -.BI \-a architecture -Specify the Debian architecture we build for. The architecture of the -machine we build on is determined automatically, and is also the default -for the host machine. -.TP -.B \-i[] -Passed unchanged to -.BR dpkg\-source . -.TP -.B \-I -Passed unchanged to -.BR dpkg\-source . -May be repeated multiple times. -.TP -.B \-D -Check build dependencies and conflicts; abort if unsatisfied. -.TP -.B \-d -Do not check build dependencies and conflicts. -.TP -.B \-nc -Do not clean the source tree(implies \-b). -.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 names consist of alphanumerics, hyphens and colons and start -with an alphanumeric. 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 occurrence of the -string -.B ${} -(which is not a legal substitution) is replaced with a -.B $ -sign. - -Variables 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\fR. -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 source:Version -The source package version. -.TP -.B source:Upstream\-Version -The upstream source package version, including the Debian version epoch if -any. -.TP -.B binary:Version -The binary package version (which may differ from source:Version in a binNMU -for example). -.TP -.B Source\-Version -The source package version (from the changelog file). This variable is now -\fBdeprecated\fP as its meaning is different from its function, please use -the \fBsource:Version\fP or \fBbinary:Version\fP as appropriate. -.TP -.B Installed\-Size -The total size of the package's installed files. This value is copied -into the corresponding control file field; setting it will modify the -value of that field. If this variable isn't set -.B dpkg\-gencontrol -will use -.B du \-k debian/tmp -to find the default value. -.TP -.B Extra\-Size -Additional disk space used when the package is installed. If this -variable is set its value is added to that of the -.B Installed\-Size -variable (whether set explicitly or using the default value) before it -is copied into the -.B Installed\-Size -control file field. -.TP -.BI F: fieldname -The value of the output field -.IR fieldname -(which must be given in the canonical capitalisation). Setting these -variables has no effect other than on places where they are expanded -explicitly. -.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. -.TP -.BI shlibs: dependencyfield -Variable settings with names of this form are generated by -.B dpkg\-shlibdeps -- see above. -.TP -.B dpkg:Upstream\-Version -The upstream version of dpkg. -.TP -.B dpkg:Version -The full version of dpkg. -.LP -If a variable is referred to but not defined it generates a warning -and an empty value is assumed. -.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. -.TP -.B debian/shlibs.local -Package-local overriding shared library dependency information. -.TP -.B /etc/dpkg/shlibs.override -Per-system overriding shared library dependency information. -.TP -.B /etc/dpkg/shlibs.default -Per-system default shared library dependency information. +. .SH BUGS The point at which field overriding occurs compared to certain standard output field settings is rather confused. @@ -838,26 +271,16 @@ file will be passed through variable substitution twice. This should not matter, since .BR $ ", " { " and " } are not legal in package names or version numbers. - -It should be possible to specify spaces and shell metacharacters in -and initial arguments for -.IR gain-root-command " and " sign-command . +. .SH SEE ALSO .BR dpkg\-deb (1), .BR dpkg (1), -.BR dselect (1), -.BR gpg (1), -.BR pgp (1). -.SH AUTHOR -The utilities and this manpage were written by Ian Jackson. -.SH COPYRIGHT +.BR dselect (1). +. +.SH AUTHORS Copyright (C) 1995-1996 Ian Jackson .br Copyright (C) 2000 Wichert Akkerman -.br +.sp This is free software; see the GNU General Public Licence version 2 or later -for copying conditions. There is NO WARRANTY. See -.B /usr/share/doc/dpkg/copyright -and -.B /usr/share/common\-licenses/GPL -for details. +for copying conditions. There is NO WARRANTY. diff --git a/man/po/add_es/deb-shlibs.5.es.add b/man/po/add_es/deb-shlibs.5.es.add new file mode 100644 index 00000000..8bdb8f65 --- /dev/null +++ b/man/po/add_es/deb-shlibs.5.es.add @@ -0,0 +1,5 @@ +PO4A-HEADER:mode=after;position=AUTOR;beginboundary=FausseLimitePo4a +.PP +Está página fue traducida por Bruno Barrera C. +y Carlos Izquierdo y revisada por Rubén Porras +. diff --git a/man/po/add_es/deb-substvars.5.es.add b/man/po/add_es/deb-substvars.5.es.add new file mode 100644 index 00000000..8bdb8f65 --- /dev/null +++ b/man/po/add_es/deb-substvars.5.es.add @@ -0,0 +1,5 @@ +PO4A-HEADER:mode=after;position=AUTOR;beginboundary=FausseLimitePo4a +.PP +Está página fue traducida por Bruno Barrera C. +y Carlos Izquierdo y revisada por Rubén Porras +. diff --git a/man/po/add_es/dpkg-buildpackage.1.es.add b/man/po/add_es/dpkg-buildpackage.1.es.add new file mode 100644 index 00000000..8bdb8f65 --- /dev/null +++ b/man/po/add_es/dpkg-buildpackage.1.es.add @@ -0,0 +1,5 @@ +PO4A-HEADER:mode=after;position=AUTOR;beginboundary=FausseLimitePo4a +.PP +Está página fue traducida por Bruno Barrera C. +y Carlos Izquierdo y revisada por Rubén Porras +. diff --git a/man/po/add_es/dpkg-distaddfile.1.es.add b/man/po/add_es/dpkg-distaddfile.1.es.add new file mode 100644 index 00000000..8bdb8f65 --- /dev/null +++ b/man/po/add_es/dpkg-distaddfile.1.es.add @@ -0,0 +1,5 @@ +PO4A-HEADER:mode=after;position=AUTOR;beginboundary=FausseLimitePo4a +.PP +Está página fue traducida por Bruno Barrera C. +y Carlos Izquierdo y revisada por Rubén Porras +. diff --git a/man/po/add_es/dpkg-genchanges.1.es.add b/man/po/add_es/dpkg-genchanges.1.es.add new file mode 100644 index 00000000..8bdb8f65 --- /dev/null +++ b/man/po/add_es/dpkg-genchanges.1.es.add @@ -0,0 +1,5 @@ +PO4A-HEADER:mode=after;position=AUTOR;beginboundary=FausseLimitePo4a +.PP +Está página fue traducida por Bruno Barrera C. +y Carlos Izquierdo y revisada por Rubén Porras +. diff --git a/man/po/add_es/dpkg-gencontrol.1.es.add b/man/po/add_es/dpkg-gencontrol.1.es.add new file mode 100644 index 00000000..8bdb8f65 --- /dev/null +++ b/man/po/add_es/dpkg-gencontrol.1.es.add @@ -0,0 +1,5 @@ +PO4A-HEADER:mode=after;position=AUTOR;beginboundary=FausseLimitePo4a +.PP +Está página fue traducida por Bruno Barrera C. +y Carlos Izquierdo y revisada por Rubén Porras +. diff --git a/man/po/add_es/dpkg-parsechangelog.1.es.add b/man/po/add_es/dpkg-parsechangelog.1.es.add new file mode 100644 index 00000000..8bdb8f65 --- /dev/null +++ b/man/po/add_es/dpkg-parsechangelog.1.es.add @@ -0,0 +1,5 @@ +PO4A-HEADER:mode=after;position=AUTOR;beginboundary=FausseLimitePo4a +.PP +Está página fue traducida por Bruno Barrera C. +y Carlos Izquierdo y revisada por Rubén Porras +. diff --git a/man/po/add_es/dpkg-shlibdeps.1.es.add b/man/po/add_es/dpkg-shlibdeps.1.es.add new file mode 100644 index 00000000..8bdb8f65 --- /dev/null +++ b/man/po/add_es/dpkg-shlibdeps.1.es.add @@ -0,0 +1,5 @@ +PO4A-HEADER:mode=after;position=AUTOR;beginboundary=FausseLimitePo4a +.PP +Está página fue traducida por Bruno Barrera C. +y Carlos Izquierdo y revisada por Rubén Porras +. diff --git a/man/po/add_fr/deb-shlibs.5.fr.add b/man/po/add_fr/deb-shlibs.5.fr.add new file mode 100644 index 00000000..cf90ad92 --- /dev/null +++ b/man/po/add_fr/deb-shlibs.5.fr.add @@ -0,0 +1,4 @@ +PO4A-HEADER:mode=after;position=^\.TH;beginboundary=FakePo4aBoundary +.SH TRADUCTION +Philippe Batailler, 2006. +Veuillez signaler toute erreur à . diff --git a/man/po/add_fr/deb-substvars.5.fr.add b/man/po/add_fr/deb-substvars.5.fr.add new file mode 100644 index 00000000..cf90ad92 --- /dev/null +++ b/man/po/add_fr/deb-substvars.5.fr.add @@ -0,0 +1,4 @@ +PO4A-HEADER:mode=after;position=^\.TH;beginboundary=FakePo4aBoundary +.SH TRADUCTION +Philippe Batailler, 2006. +Veuillez signaler toute erreur à . diff --git a/man/po/add_fr/dpkg-buildpackage.1.fr.add b/man/po/add_fr/dpkg-buildpackage.1.fr.add new file mode 100644 index 00000000..cf90ad92 --- /dev/null +++ b/man/po/add_fr/dpkg-buildpackage.1.fr.add @@ -0,0 +1,4 @@ +PO4A-HEADER:mode=after;position=^\.TH;beginboundary=FakePo4aBoundary +.SH TRADUCTION +Philippe Batailler, 2006. +Veuillez signaler toute erreur à . diff --git a/man/po/add_fr/dpkg-distaddfile.1.fr.add b/man/po/add_fr/dpkg-distaddfile.1.fr.add new file mode 100644 index 00000000..cf90ad92 --- /dev/null +++ b/man/po/add_fr/dpkg-distaddfile.1.fr.add @@ -0,0 +1,4 @@ +PO4A-HEADER:mode=after;position=^\.TH;beginboundary=FakePo4aBoundary +.SH TRADUCTION +Philippe Batailler, 2006. +Veuillez signaler toute erreur à . diff --git a/man/po/add_fr/dpkg-genchanges.1.fr.add b/man/po/add_fr/dpkg-genchanges.1.fr.add new file mode 100644 index 00000000..cf90ad92 --- /dev/null +++ b/man/po/add_fr/dpkg-genchanges.1.fr.add @@ -0,0 +1,4 @@ +PO4A-HEADER:mode=after;position=^\.TH;beginboundary=FakePo4aBoundary +.SH TRADUCTION +Philippe Batailler, 2006. +Veuillez signaler toute erreur à . diff --git a/man/po/add_fr/dpkg-gencontrol.1.fr.add b/man/po/add_fr/dpkg-gencontrol.1.fr.add new file mode 100644 index 00000000..cf90ad92 --- /dev/null +++ b/man/po/add_fr/dpkg-gencontrol.1.fr.add @@ -0,0 +1,4 @@ +PO4A-HEADER:mode=after;position=^\.TH;beginboundary=FakePo4aBoundary +.SH TRADUCTION +Philippe Batailler, 2006. +Veuillez signaler toute erreur à . diff --git a/man/po/add_fr/dpkg-parsechangelog.1.fr.add b/man/po/add_fr/dpkg-parsechangelog.1.fr.add new file mode 100644 index 00000000..cf90ad92 --- /dev/null +++ b/man/po/add_fr/dpkg-parsechangelog.1.fr.add @@ -0,0 +1,4 @@ +PO4A-HEADER:mode=after;position=^\.TH;beginboundary=FakePo4aBoundary +.SH TRADUCTION +Philippe Batailler, 2006. +Veuillez signaler toute erreur à . diff --git a/man/po/add_fr/dpkg-shlibdeps.1.fr.add b/man/po/add_fr/dpkg-shlibdeps.1.fr.add new file mode 100644 index 00000000..cf90ad92 --- /dev/null +++ b/man/po/add_fr/dpkg-shlibdeps.1.fr.add @@ -0,0 +1,4 @@ +PO4A-HEADER:mode=after;position=^\.TH;beginboundary=FakePo4aBoundary +.SH TRADUCTION +Philippe Batailler, 2006. +Veuillez signaler toute erreur à . diff --git a/man/po/po4a.cfg b/man/po/po4a.cfg index 0e08ccda..083e83b8 100644 --- a/man/po/po4a.cfg +++ b/man/po/po4a.cfg @@ -43,6 +43,16 @@ add_$lang:$(srcdir)/po/add_$lang/deb-override.5.$lang.add +[type:man] $(srcdir)/deb-shlibs.5 \ + $lang:$lang/deb-shlibs.5 \ + add_$lang:$(srcdir)/po/add_$lang/deb-shlibs.5.$lang.add + + +[type:man] $(srcdir)/deb-substvars.5 \ + $lang:$lang/deb-substvars.5 \ + add_$lang:$(srcdir)/po/add_$lang/deb-substvars.5.$lang.add + + [type:man] $(srcdir)/dpkg.1 \ $lang:$lang/dpkg.1 \ add_$lang:$(srcdir)/po/add_$lang/dpkg.1.$lang.add @@ -58,11 +68,21 @@ add_$lang:$(srcdir)/po/add_$lang/dpkg.cfg.5.$lang.add +[type:man] $(srcdir)/dpkg-buildpackage.1 \ + $lang:$lang/dpkg-buildpackage.1 \ + add_$lang:$(srcdir)/po/add_$lang/dpkg-buildpackage.1.$lang.add + + [type:man] $(srcdir)/dpkg-checkbuilddeps.1 \ $lang:$lang/dpkg-checkbuilddeps.1 \ add_$lang:$(srcdir)/po/add_$lang/dpkg-checkbuilddeps.1.$lang.add +[type:man] $(srcdir)/dpkg-distaddfile.1 \ + $lang:$lang/dpkg-distaddfile.1 \ + add_$lang:$(srcdir)/po/add_$lang/dpkg-distaddfile.1.$lang.add + + [type:man] $(srcdir)/dpkg-deb.1 \ $lang:$lang/dpkg-deb.1 \ add_$lang:$(srcdir)/po/add_$lang/dpkg-deb.1.$lang.add @@ -73,11 +93,26 @@ add_$lang:$(srcdir)/po/add_$lang/dpkg-divert.8.$lang.add +[type:man] $(srcdir)/dpkg-genchanges.1 \ + $lang:$lang/dpkg-genchanges.1 \ + add_$lang:$(srcdir)/po/add_$lang/dpkg-genchanges.1.$lang.add + + +[type:man] $(srcdir)/dpkg-gencontrol.1 \ + $lang:$lang/dpkg-gencontrol.1 \ + add_$lang:$(srcdir)/po/add_$lang/dpkg-gencontrol.1.$lang.add + + [type:man] $(srcdir)/dpkg-name.1 \ $lang:$lang/dpkg-name.1 \ add_$lang:$(srcdir)/po/add_$lang/dpkg-name.1.$lang.add +[type:man] $(srcdir)/dpkg-parsechangelog.1 \ + $lang:$lang/dpkg-parsechangelog.1 \ + add_$lang:$(srcdir)/po/add_$lang/dpkg-parsechangelog.1.$lang.add + + [type:man] $(srcdir)/dpkg-query.1 \ $lang:$lang/dpkg-query.1 \ add_$lang:$(srcdir)/po/add_$lang/dpkg-query.1.$lang.add @@ -93,6 +128,11 @@ add_$lang:$(srcdir)/po/add_$lang/dpkg-scansources.1.$lang.add +[type:man] $(srcdir)/dpkg-shlibdeps.1 \ + $lang:$lang/dpkg-shlibdeps.1 \ + add_$lang:$(srcdir)/po/add_$lang/dpkg-shlibdeps.1.$lang.add + + [type:man] $(srcdir)/dpkg-source.1 \ $lang:$lang/dpkg-source.1 \ add_$lang:$(srcdir)/po/add_$lang/dpkg-source.1.$lang.add -- 2.39.5