mirror of
https://git.launchpad.net/ubuntu-dev-tools
synced 2025-05-28 17:21:35 +00:00
pull-pkg: update man pages to all point to single pull-pkg.1 man page
remove the pull-lp-source.1 and pull-debian-source.1 man pages, consolidating them both into a pull-pkg.1 man page. Also create symlinks for all associated scripts pointing to pull-pkg.1 man page.
This commit is contained in:
Dan Streetman
Dan Streetman
parent
e3268a62f4
commit
41a6c47ac2
1
doc/pull-debian-ddebs.1
Symbolic link
1
doc/pull-debian-ddebs.1
Symbolic link
@ -0,0 +1 @@
|
|||||||
|
pull-pkg.1
|
||||||
1
doc/pull-debian-debs.1
Symbolic link
1
doc/pull-debian-debs.1
Symbolic link
@ -0,0 +1 @@
|
|||||||
|
pull-pkg.1
|
||||||
@ -1,89 +0,0 @@
|
|||||||
.\" Copyright (C) 2010-2011, Stefano Rivera <stefanor@ubuntu.com>
|
|
||||||
.\"
|
|
||||||
.\" Permission to use, copy, modify, and/or distribute this software for any
|
|
||||||
.\" purpose with or without fee is hereby granted, provided that the above
|
|
||||||
.\" copyright notice and this permission notice appear in all copies.
|
|
||||||
.\"
|
|
||||||
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
|
|
||||||
.\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
|
|
||||||
.\" AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
|
|
||||||
.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
|
|
||||||
.\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
|
|
||||||
.\" OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
||||||
.\" PERFORMANCE OF THIS SOFTWARE.
|
|
||||||
.TH PULL\-DEBIAN\-SOURCE "1" "22 January 2011" "ubuntu\-dev\-tools"
|
|
||||||
|
|
||||||
.SH NAME
|
|
||||||
pull\-debian\-source \- download and extract a source package from Debian
|
|
||||||
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.B pull\-debian\-source \fR[\fIoptions\fR] <\fIsource package\fR>
|
|
||||||
[\fIrelease\fR|\fIversion\fR]
|
|
||||||
|
|
||||||
.SH DESCRIPTION
|
|
||||||
\fBpull\-debian\-source\fR downloads and extracts the specified
|
|
||||||
\fIversion\fR of \fIsource package\fR, or the latest version in the
|
|
||||||
specified Debian \fIrelease\fR.
|
|
||||||
.P
|
|
||||||
\fBpull\-debian\-source\fR will try the preferred mirror, default
|
|
||||||
mirror, security mirror, and fall back to \fBLaunchpad\fR or
|
|
||||||
\fBsnapshot.debian.org\fR, in search of the requested version.
|
|
||||||
|
|
||||||
.SH OPTIONS
|
|
||||||
.TP
|
|
||||||
.I source package
|
|
||||||
The source package to download from Debian.
|
|
||||||
.TP
|
|
||||||
.I release
|
|
||||||
The release to download the source package from. Defaults to
|
|
||||||
\fBunstable\fR.
|
|
||||||
.TP
|
|
||||||
.I version
|
|
||||||
The specific version of the package to download.
|
|
||||||
.TP
|
|
||||||
.BR \-d ", " \-\-download\-only
|
|
||||||
Do not extract the source package.
|
|
||||||
.TP
|
|
||||||
.B \-m \fIDEBIAN_MIRROR\fR, \fB\-\-mirror\fR=\fIDEBIAN_MIRROR\fR
|
|
||||||
Use the specified mirror.
|
|
||||||
Should be in the form \fBhttp://ftp.debian.org/debian\fR.
|
|
||||||
If the package isn't found on this mirror, \fBpull\-debian\-source\fR
|
|
||||||
will fall back to the default mirror.
|
|
||||||
.TP
|
|
||||||
.B \-s \fIDEBSEC_MIRROR\fR, \fB\-\-security\-mirror\fR=\fIDEBSEC_MIRROR\fR
|
|
||||||
Use the specified mirror.
|
|
||||||
Should be in the form \fBhttp://security.debian.org\fR.
|
|
||||||
If the package isn't found on this mirror, \fBpull\-debian\-source\fR
|
|
||||||
will fall back to the default mirror.
|
|
||||||
.TP
|
|
||||||
.B \-\-no\-conf
|
|
||||||
Do not read any configuration files, or configuration from environment
|
|
||||||
variables.
|
|
||||||
.TP
|
|
||||||
.BR \-h ", " \-\-help
|
|
||||||
Display the usage instructions and exit.
|
|
||||||
|
|
||||||
.SH ENVIRONMENT
|
|
||||||
All of the \fBCONFIGURATION VARIABLES\fR below are also supported as
|
|
||||||
environment variables.
|
|
||||||
Variables in the environment take precedence to those in configuration
|
|
||||||
files.
|
|
||||||
|
|
||||||
.SH CONFIGURATION VARIABLES
|
|
||||||
The following variables can be set in the environment or in
|
|
||||||
.BR ubuntu\-dev\-tools (5)
|
|
||||||
configuration files.
|
|
||||||
In each case, the script\-specific variable takes precedence over the
|
|
||||||
package\-wide variable.
|
|
||||||
.TP
|
|
||||||
.BR PULL_DEBIAN_SOURCE_DEBIAN_MIRROR ", " UBUNTUTOOLS_DEBIAN_MIRROR
|
|
||||||
The default value for \fB\-\-mirror\fR.
|
|
||||||
.TP
|
|
||||||
.BR PULL_DEBIAN_SOURCE_DEBSEC_MIRROR ", " UBUNTUTOOLS_DEBSEC_MIRROR
|
|
||||||
The default value for \fB\-\-security\-mirror\fR.
|
|
||||||
|
|
||||||
.SH SEE ALSO
|
|
||||||
.BR dget (1),
|
|
||||||
.BR pull\-debian\-debdiff (1),
|
|
||||||
.BR pull\-lp\-source (1),
|
|
||||||
.BR ubuntu\-dev\-tools (5)
|
|
||||||
1
doc/pull-debian-source.1
Symbolic link
1
doc/pull-debian-source.1
Symbolic link
@ -0,0 +1 @@
|
|||||||
|
pull-pkg.1
|
||||||
1
doc/pull-debian-udebs.1
Symbolic link
1
doc/pull-debian-udebs.1
Symbolic link
@ -0,0 +1 @@
|
|||||||
|
pull-pkg.1
|
||||||
1
doc/pull-lp-ddebs.1
Symbolic link
1
doc/pull-lp-ddebs.1
Symbolic link
@ -0,0 +1 @@
|
|||||||
|
pull-pkg.1
|
||||||
1
doc/pull-lp-debs.1
Symbolic link
1
doc/pull-lp-debs.1
Symbolic link
@ -0,0 +1 @@
|
|||||||
|
pull-pkg.1
|
||||||
@ -1,79 +0,0 @@
|
|||||||
.TH PULL\-LP\-SOURCE "1" "4 August 2008" "ubuntu-dev-tools"
|
|
||||||
|
|
||||||
.SH NAME
|
|
||||||
pull\-lp\-source \- download a source package from Launchpad
|
|
||||||
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.B pull\-lp\-source \fR[\fIoptions\fR]\fB \fBsource package\fR
|
|
||||||
[\fIrelease\fR|\fIversion\fR]
|
|
||||||
|
|
||||||
.SH DESCRIPTION
|
|
||||||
\fBpull\-lp\-source\fR downloads and extracts the specified
|
|
||||||
\fIversion\fR of <\fBsource package\fR> from Launchpad, or the latest
|
|
||||||
version of the specified \fIrelease\fR.
|
|
||||||
To request a version from a particular pocket say
|
|
||||||
\fIrelease\fB\-\fIpocket\fR (with a magic \fB\-release\fR for only the
|
|
||||||
release pocket).
|
|
||||||
If no \fIversion\fR or \fIrelease\fR is specified, the latest version in
|
|
||||||
the development release will be downloaded.
|
|
||||||
|
|
||||||
.SH OPTIONS
|
|
||||||
Listed below are the command line options for pull\-lp\-source:
|
|
||||||
.TP
|
|
||||||
.B source package
|
|
||||||
This is the source package that you would like to be downloaded from Launchpad.
|
|
||||||
.TP
|
|
||||||
.B version
|
|
||||||
This is the version of the source package to be downloaded.
|
|
||||||
.TP
|
|
||||||
.B release
|
|
||||||
This is the release that you would like the source package to be downloaded from.
|
|
||||||
This value defaults to the current development release.
|
|
||||||
.TP
|
|
||||||
.BR \-h ", " \-\-help
|
|
||||||
Display a help message and exit.
|
|
||||||
.TP
|
|
||||||
.BR \-d ", " \-\-download\-only
|
|
||||||
Do not extract the source package.
|
|
||||||
.TP
|
|
||||||
.B \-m \fIUBUNTU_MIRROR\fR, \fB\-\-mirror\fR=\fIUBUNTU_MIRROR\fR
|
|
||||||
Use the specified Ubuntu mirror.
|
|
||||||
Should be in the form \fBhttp://archive.ubuntu.com/ubuntu\fR.
|
|
||||||
If the package isn't found on this mirror, \fBpull\-lp\-source\fR will
|
|
||||||
fall back to Launchpad, as its name implies.
|
|
||||||
.TP
|
|
||||||
.B \-\-no\-conf
|
|
||||||
Do not read any configuration files, or configuration from environment
|
|
||||||
variables.
|
|
||||||
|
|
||||||
.SH ENVIRONMENT
|
|
||||||
All of the \fBCONFIGURATION VARIABLES\fR below are also supported as
|
|
||||||
environment variables.
|
|
||||||
Variables in the environment take precedence to those in configuration
|
|
||||||
files.
|
|
||||||
.TP
|
|
||||||
.B
|
|
||||||
DIST
|
|
||||||
Specifies the default target.
|
|
||||||
|
|
||||||
.SH CONFIGURATION VARIABLES
|
|
||||||
The following variables can be set in the environment or in
|
|
||||||
.BR ubuntu\-dev\-tools (5)
|
|
||||||
configuration files.
|
|
||||||
In each case, the script\-specific variable takes precedence over the
|
|
||||||
package\-wide variable.
|
|
||||||
.TP
|
|
||||||
.BR PULL_LP_SOURCE_UBUNTU_MIRROR ", " UBUNTUTOOLS_UBUNTU_MIRROR
|
|
||||||
The default value for \fB\-\-mirror\fR.
|
|
||||||
|
|
||||||
.SH SEE ALSO
|
|
||||||
.BR dget (1),
|
|
||||||
.BR pull\-debian\-source (1),
|
|
||||||
.BR pull\-debian\-debdiff (1),
|
|
||||||
.BR ubuntu\-dev\-tools (5)
|
|
||||||
|
|
||||||
.SH AUTHOR
|
|
||||||
.PP
|
|
||||||
\fBpull\-lp\-source\fR and this manual page were written by Iain Lane
|
|
||||||
<iain@orangesquash.org.uk>.
|
|
||||||
Both are released under the GNU General Public License, version 3 or later.
|
|
||||||
1
doc/pull-lp-source.1
Symbolic link
1
doc/pull-lp-source.1
Symbolic link
@ -0,0 +1 @@
|
|||||||
|
pull-pkg.1
|
||||||
1
doc/pull-lp-udebs.1
Symbolic link
1
doc/pull-lp-udebs.1
Symbolic link
@ -0,0 +1 @@
|
|||||||
|
pull-pkg.1
|
||||||
134
doc/pull-pkg.1
Normal file
134
doc/pull-pkg.1
Normal file
@ -0,0 +1,134 @@
|
|||||||
|
.TH PULL\-PKG "1" "28 August 2017" "ubuntu-dev-tools"
|
||||||
|
|
||||||
|
.SH NAME
|
||||||
|
pull\-pkg \- download a package for Debian, Ubuntu, or UCA
|
||||||
|
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.B pull\-pkg \fR[\fIoptions\fR]\fR <\fIpackage name\fR>
|
||||||
|
[\fIrelease\fR|\fIversion\fR]
|
||||||
|
|
||||||
|
.SH DESCRIPTION
|
||||||
|
\fBpull\-pkg\fR downloads the specified \fIversion\fR of
|
||||||
|
<\fIpackage name\fR>, or the latest version from the
|
||||||
|
specified \fIrelease\fR. To request a version from
|
||||||
|
a particular pocket say \fIrelease\fB\-\fIpocket\fR (with a magic
|
||||||
|
\fB\-release\fR for only the release pocket).
|
||||||
|
If no \fIversion\fR or \fIrelease\fR is specified, the latest version in
|
||||||
|
the development release will be downloaded.
|
||||||
|
|
||||||
|
There are convenience scripts that set pull type and distribution
|
||||||
|
appropriately: these are
|
||||||
|
\fBpull\-lp\-source\fR, \fBpull\-lp\-debs\fR, \fBpull\-lp\-ddebs\fR,
|
||||||
|
and \fBpull\-lp\-udebs\fR, which all pull Ubuntu packages;
|
||||||
|
\fBpull\-debian\-source\fR, \fBpull\-debian\-debs\fR, \fBpull\-debian\-ddebs\fR,
|
||||||
|
and \fBpull\-debian\-udebs\fR, which all pull Debian packages;
|
||||||
|
and \fBpull\-uca\-source\fR, \fBpull\-uca\-debs\fR, \fBpull\-uca\-ddebs\fR,
|
||||||
|
and \fBpull\-uca\-udebs\fR, which all pull Ubuntu Cloud Archive packages.
|
||||||
|
Each script pulls the file type in its name, i.e.
|
||||||
|
\fIsource\fR, \fIdebs\fR, \fIddebs\fR, or \fIudebs\fR.
|
||||||
|
|
||||||
|
.SH OPTIONS
|
||||||
|
Listed below are the command line options for pull\-pkg:
|
||||||
|
.TP
|
||||||
|
.I package name
|
||||||
|
This is name of the package to downloaded.
|
||||||
|
You can use either the source package name, or binary package name.
|
||||||
|
.TP
|
||||||
|
.I version
|
||||||
|
This is the version of the package to downloaded.
|
||||||
|
.TP
|
||||||
|
.I release
|
||||||
|
This is the release to downloaded from.
|
||||||
|
For debian, you can use either the release name like \fBjessie\fR
|
||||||
|
or \fBsid\fR, or you can use the special release names \fBunstable\fR,
|
||||||
|
\fBstable\fR, or \fBtesting\fR.
|
||||||
|
For ubuntu, you can use either the release name like \fBxenial\fR
|
||||||
|
or the release-pocket like \fBxenial-proposed\fR.
|
||||||
|
For ubuntu cloud archive (uca) you can use either the uca release
|
||||||
|
name like \fBmitaka\fR or the ubuntu and uca release names like
|
||||||
|
\fBtrusty-mitaka\fR.
|
||||||
|
Defaults to the current development release.
|
||||||
|
.TP
|
||||||
|
.BR \-h ", " \-\-help
|
||||||
|
Display a help message and exit.
|
||||||
|
.TP
|
||||||
|
.BR \-v ", " \-\-verbose
|
||||||
|
Be verbose about what is being done.
|
||||||
|
.TP
|
||||||
|
.BR \-d ", " \-\-download\-only
|
||||||
|
Do not extract the source package (applies only to source packages).
|
||||||
|
.TP
|
||||||
|
.B \-m \fIMIRROR\fR, \fB\-\-mirror\fR=\fIMIRROR\fR
|
||||||
|
Use the specified mirror server.
|
||||||
|
Should be in the form \fBhttp://archive.ubuntu.com/ubuntu\fR or
|
||||||
|
\fBhttp://deb.debian.org/debian\fR. If not specified or if the
|
||||||
|
package is not found on the specified mirror, this will fall
|
||||||
|
back to the default mirror(s) and/or mirror(s) from environment
|
||||||
|
variables, and then will fall back to Launchpad or Debian Snapshot.
|
||||||
|
This can be specified multiple times to try multiple mirrors.
|
||||||
|
.TP
|
||||||
|
.B \-\-no\-conf
|
||||||
|
Do not use mirrors from the default configuration, or from
|
||||||
|
any environment variables.
|
||||||
|
.TP
|
||||||
|
.B \-a \fIARCH\fR, \fB\-\-arch\fR=\fIARCH\fR
|
||||||
|
Get binary packages from the \fIARCH\fR architecture.
|
||||||
|
Defaults to the local architecture, if it can be deteected.
|
||||||
|
.TP
|
||||||
|
.B \-p \fIPULL\fR, \fB\-\-pull\fR=\fIPULL\fR
|
||||||
|
What to pull: \fBsource\fR, \fBdebs\fR, \fBddebs\fR, \fBudebs\fR,
|
||||||
|
or \fBlist\fR. The \fBlist\fR action only lists all a package's
|
||||||
|
source and binary files, but does not actually download any.
|
||||||
|
Defaults to \fBsource\fR.
|
||||||
|
.TP
|
||||||
|
.B \-D \fIDISTRO\fR, \fB\-\-distro\fR=\fIDISTRO\fR
|
||||||
|
Pull from: \fBdebian\fR, \fBuca\fR, or \fBubuntu\fR.
|
||||||
|
\fBlp\fR can be used instead of \fBubuntu\fR.
|
||||||
|
Any string containing \fBcloud\fR can be used instead of \fBuca\fR.
|
||||||
|
Deafults to \fBubuntu\fR.
|
||||||
|
|
||||||
|
.SH ENVIRONMENT
|
||||||
|
All of the \fBCONFIGURATION VARIABLES\fR below are also supported as
|
||||||
|
environment variables.
|
||||||
|
Variables in the environment take precedence to those in configuration
|
||||||
|
files.
|
||||||
|
|
||||||
|
.SH CONFIGURATION VARIABLES
|
||||||
|
The following variables can be set in the environment or in
|
||||||
|
.BR ubuntu\-dev\-tools (5)
|
||||||
|
configuration files.
|
||||||
|
In each case, the script\-specific variable takes precedence over the
|
||||||
|
package\-wide variable.
|
||||||
|
.TP
|
||||||
|
.BR UBUNTUTOOLS_UBUNTU_MIRROR
|
||||||
|
The default mirror.
|
||||||
|
.TP
|
||||||
|
.BR PULL_PKG_UBUNTU_MIRROR
|
||||||
|
The default mirror when using the \fBpull\-pkg\fR script.
|
||||||
|
.TP
|
||||||
|
.BR PULL_[LP|DEBIAN|UCA]_[SOURCE|DEBS|DDEBS|UDEBS]_MIRROR
|
||||||
|
The default mirror when using the associated script.
|
||||||
|
|
||||||
|
.SH SEE ALSO
|
||||||
|
.BR dget (1),
|
||||||
|
.BR pull\-lp\-source (1),
|
||||||
|
.BR pull\-lp\-debs (1),
|
||||||
|
.BR pull\-lp\-ddebs (1),
|
||||||
|
.BR pull\-lp\-udebs (1),
|
||||||
|
.BR pull\-debian\-source (1),
|
||||||
|
.BR pull\-debian\-debs (1),
|
||||||
|
.BR pull\-debian\-ddebs (1),
|
||||||
|
.BR pull\-debian\-udebs (1),
|
||||||
|
.BR pull\-uca\-source (1),
|
||||||
|
.BR pull\-uca\-debs (1),
|
||||||
|
.BR pull\-uca\-ddebs (1),
|
||||||
|
.BR pull\-uca\-udebs (1),
|
||||||
|
.BR pull\-debian\-debdiff (1),
|
||||||
|
.BR ubuntu\-dev\-tools (5)
|
||||||
|
|
||||||
|
.SH AUTHOR
|
||||||
|
.PP
|
||||||
|
\fBpull\-pkg\fR was written by Dan Streetman <dan.streetman@canonical.com>,
|
||||||
|
based on the original \fBpull\-lp\-source\fR; it and this manual page
|
||||||
|
were written by Iain Lane <iain@orangesquash.org.uk>.
|
||||||
|
All are released under the GNU General Public License, version 3 or later.
|
||||||
1
doc/pull-uca-ddebs.1
Symbolic link
1
doc/pull-uca-ddebs.1
Symbolic link
@ -0,0 +1 @@
|
|||||||
|
pull-pkg.1
|
||||||
1
doc/pull-uca-debs.1
Symbolic link
1
doc/pull-uca-debs.1
Symbolic link
@ -0,0 +1 @@
|
|||||||
|
pull-pkg.1
|
||||||
1
doc/pull-uca-source.1
Symbolic link
1
doc/pull-uca-source.1
Symbolic link
@ -0,0 +1 @@
|
|||||||
|
pull-pkg.1
|
||||||
1
doc/pull-uca-udebs.1
Symbolic link
1
doc/pull-uca-udebs.1
Symbolic link
@ -0,0 +1 @@
|
|||||||
|
pull-pkg.1
|
||||||
Loading…
x
Reference in New Issue
Block a user