[Python-modules-commits] r29196 - in packages/python-pip/trunk/debian (5 files)
barry at users.alioth.debian.org
barry at users.alioth.debian.org
Tue Jun 3 21:52:41 UTC 2014
Date: Tuesday, June 3, 2014 @ 21:52:40
Author: barry
Revision: 29196
* d/control:
- Update python-pip-whl dependencies
- Add python-docutils to Build-Depends
* Updates to the pip manpage.
- Rewrote using reStructuredText
- Fleshed out with more options
- Removed pip.1
Added:
packages/python-pip/trunk/debian/pip-manpage.rst
Modified:
packages/python-pip/trunk/debian/changelog
packages/python-pip/trunk/debian/control
packages/python-pip/trunk/debian/python-pip.manpages
packages/python-pip/trunk/debian/rules
Modified: packages/python-pip/trunk/debian/changelog
===================================================================
--- packages/python-pip/trunk/debian/changelog 2014-06-03 20:11:05 UTC (rev 29195)
+++ packages/python-pip/trunk/debian/changelog 2014-06-03 21:52:40 UTC (rev 29196)
@@ -2,12 +2,18 @@
* Team upload.
* New upstream release.
- * d/control: Update python-pip-whl dependencies.
+ * d/control:
+ - Update python-pip-whl dependencies
+ - Add python-docutils to Build-Depends
* d/patches/de-vendorize.patch: Refreshed.
* d/patches/use-venv-wheels.patch: Handle virtualenv created venvs.
* d/pip.dependencies: Added. (Closes: #749692)
* d/python-pip-whl.install: Updated.
* d/README.debian: Added.
+ * Updates to the pip manpage.
+ - Rewrote using reStructuredText
+ - Fleshed out with more options
+ - Removed pip.1
-- Barry Warsaw <barry at debian.org> Thu, 29 May 2014 18:48:06 -0400
Modified: packages/python-pip/trunk/debian/control
===================================================================
--- packages/python-pip/trunk/debian/control 2014-06-03 20:11:05 UTC (rev 29195)
+++ packages/python-pip/trunk/debian/control 2014-06-03 21:52:40 UTC (rev 29196)
@@ -7,6 +7,7 @@
Build-Depends: debhelper (>= 8),
dh-python,
python-all (>= 2.6),
+ python-docutils,
python-mock,
python-pytest,
python-scripttest,
Added: packages/python-pip/trunk/debian/pip-manpage.rst
===================================================================
--- packages/python-pip/trunk/debian/pip-manpage.rst (rev 0)
+++ packages/python-pip/trunk/debian/pip-manpage.rst 2014-06-03 21:52:40 UTC (rev 29196)
@@ -0,0 +1,259 @@
+=====
+ pip
+=====
+
+--------------------------------------------------
+A tool for installing and managing Python packages
+--------------------------------------------------
+
+:Author: Barry Warsaw <barry at debian.org>
+:Date: 2014-06-03
+:Version: 1.5.6
+:Manual section: 1
+
+
+SYNOPSIS
+========
+
+pip <command> [options]
+
+pip3 <command> [options]
+
+
+DESCRIPTION
+===========
+
+``pip`` is a Python package installer, recommended for installing Python
+packages which are not available in the Debian archive. It can work with
+version control repositories (currently only Git, Mercurial, and Bazaar
+repositories), logs output extensively, and prevents partial installs by
+downloading all requirements before starting installation.
+
+On Debian, ``pip`` is the command to use when installing packages for Python
+2, while ``pip3`` is the command to use when installing packages for
+Python 3.
+
+
+COMMANDS
+========
+
+The command comes before any options. The following commands are recognized:
+
+help
+ Show help for commands.
+
+install
+ Install packages.
+
+uninstall
+ Uninstall packages.
+
+freeze
+ Output installed packages in requirements format.
+
+list
+ List installed packages.
+
+show
+ Show information about installed packages.
+
+search
+ Search PyPI for packages.
+
+wheel
+ Build wheels from your requirements.
+
+
+GENERAL OPTIONS
+===============
+
+This list is by no means complete, and it only describes options available to
+all commands. Use ``pip <command> --help`` for more details on command
+specific options. A few command options are provided below.
+
+-h, --help
+ Show more detailed command help.
+
+-v, --verbose
+ Give more output. Option is additive, and can be used up to 3 times.
+
+-V, --version
+ Show version and exit.
+
+-q, --quiet
+ Give less output.
+
+--log-file <path>
+ Path to a verbose non-appending log, that only logs failures. This log is
+ active by default at `~/.pip/pip.log`.
+
+--log <path>
+ Path to a verbose appending log. This log is inactive by default.
+
+--proxy <proxy>
+ Specify a proxy in the form ``[user:passwd@]proxy.server:port``.
+
+--timeout <sec>
+ Set the socket timeout (default 15 seconds).
+
+--exists-action <action>
+ Default action when a path already exists: (s)witch, (i)gnore, (w)ipe,
+ (b)ackup.
+
+--cert <path>
+ Path to alternate CA bundle.
+
+
+INSTALL OPTIONS
+===============
+
+``pip install`` installs packages from:
+
+ * PyPI (a.k.a. The Cheeseshop) and other indexes, using requirements
+ specifiers.
+ * VCS project urls.
+ * Local project directories.
+ * Local or remote source archives
+
+-e, --editable <path/url>
+ Install a project in editable mode (i.e. setuptools "develop mode") from
+ a local project path or a VCS url.
+
+-r, --requirement <file>
+ Install from the given requirements file. This option can be used multiple
+ times.
+
+-b, --build <dir>
+ Directory to unpack packages into and build in. The default in a
+ virtualenv is "<venv path>/build". The default for global installs is
+ "<OS temp dir>/pip_build_<username>".
+
+-t, --target <dir>
+ Install packages into <dir>.
+
+-d, --download <dir>
+ Download packages into <dir> instead of installing them, regardless of
+ what's already installed.
+
+--download-cache <dir>
+ Cache downloaded packages in <dir>.
+
+--src <dir>
+ Directory to check out editable projects into. The default in a
+ virtualenv is "<venv path>/src". The default for global installs is
+ "<current dir>/src".
+
+-U, --upgrade
+ Upgrade all packages to the newest available version. This process is
+ recursive regardless of whether a dependency is already satisfied.
+
+--force-reinstall
+ When upgrading, reinstall all packages even if they are already
+ up-to-date.
+
+-I, --ignore-installed
+ Ignore the installed packages (reinstalling instead).
+
+
+--no-deps
+ Don't install package dependencies.
+
+--install-option <options>
+
+ Extra arguments to be supplied to the setup.py install command (use
+ like --install-option ="--install-scripts=/usr/local/bin"). Use
+ multiple --install-option options to pass multiple options to setup.py
+ install. If you are using an option with a directory path, be sure to use
+ absolute path.
+
+--global-option <options>
+ Extra global options to be supplied to the setup.py call before the
+ install command.
+
+--user
+ Install using the user scheme.
+
+--egg
+ Install packages as eggs, not 'flat', like pip normally does. This option
+ is not about installing *from* eggs. (WARNING: Because this option
+ overrides pip's normal install logic, requirements files may not behave as
+ expected.)
+
+--root <dir>
+ Install everything relative to this alternate root directory.
+
+--compile
+ Compile py files to pyc.
+
+--no-compile
+ Do not compile py files to pyc.
+
+--no-use-wheel
+ Do not find and prefer wheel archives when searching indexes and
+ find-links locations.
+
+--pre
+ Include pre-release and development versions. By default, pip only finds
+ stable versions.
+
+--no-clean
+ Don't clean up build directories.
+
+Package Index Options:
+
+-i, --index-url <url>
+ Base URL of Python Package Index (default https://pypi.python.org/simple/).
+
+--extra-index-url <url>
+ Extra URLs of package indexes to use in addition to --index-url.
+
+--no-index
+ Ignore package index (only looking at --find-links URLs instead).
+
+-f, --find-links <url>
+ If a url or path to an html file, then parse for links to archives. If a
+ local path or file:// url that's a directory, then look for archives in
+ the directory listing.
+
+--allow-external <package>
+ Allow the installation of externally hosted files
+
+--allow-all-external
+ Allow the installation of all externally hosted files
+
+--allow-unverified <package>
+ Allow the installation of insecure and unverifiable files
+
+--process-dependency-links
+ Enable the processing of dependency links.
+
+
+UNINSTALL OPTIONS
+=================
+
+pip is able to uninstall most installed packages. Known exceptions are:
+
+ * Pure distutils packages installed with ``python setup.py install``, which
+ leave behind no metadata to determine what files were installed.
+
+ * Script wrappers installed by ``python setup.py develop``.
+
+-r, --requirement <file>
+ Uninstall all the packages listed in the given requirements file. This
+ option can be used multiple times.
+
+-y, --yes
+ Don't ask for confirmation of uninstall deletions.
+
+
+AUTHORS
+=======
+
+This manual page was originally written by Jeff Licquia <licquia at debian.org>,
+later rewritten by Carl Chenet <chaica at debian.org>. It was rewritten again
+and the source converted to reStructuredText by Barry Warsaw
+<barry at debian.org>.
+
+Permission is granted to copy, distribute and/or modify this document under
+the terms of the GNU General Public License, version 3 or any later version
+published by the Free Software Foundation.
Modified: packages/python-pip/trunk/debian/python-pip.manpages
===================================================================
--- packages/python-pip/trunk/debian/python-pip.manpages 2014-06-03 20:11:05 UTC (rev 29195)
+++ packages/python-pip/trunk/debian/python-pip.manpages 2014-06-03 21:52:40 UTC (rev 29196)
@@ -1 +1 @@
-debian/pip.1
+debian/tmp/pip.man
Modified: packages/python-pip/trunk/debian/rules
===================================================================
--- packages/python-pip/trunk/debian/rules 2014-06-03 20:11:05 UTC (rev 29195)
+++ packages/python-pip/trunk/debian/rules 2014-06-03 21:52:40 UTC (rev 29196)
@@ -21,7 +21,6 @@
rm -f debian/python-pip/usr/bin/pip2.?
override_dh_auto_install:
- cp debian/pip.1 debian/pip3.1
dh_auto_install
mkdir -p $(CURDIR)/debian/tmp/usr/share/python-wheels
python3 setup.py bdist_wheel \
@@ -31,7 +30,11 @@
override_dh_installchangelogs:
dh_installchangelogs CHANGES.txt
+override_dh_installman:
+ rst2man pip-manpage.rst > debian/tmp/pip.man
+ rst2man pip-manpage.rst > debian/tmp/pip3.man
+ dh_installman
+
override_dh_clean:
dh_clean
- rm -f debian/pip3.1
rm -rf debian/tmp/usr/share/python-wheels
More information about the Python-modules-commits
mailing list