control: tags -1 patch

Here is a manpage created with help2man and some manual editing.

I found this bug while looking for why pipx was missing in Bullseye.  Thanks for
uploading it.  (Maybe too late for Bullseye but still good for us.)

This can be applied for next upload.  No rush.

Osamu
From 05cf7527c6e94bafb4a82a0628ff133ccb74e1ec Mon Sep 17 00:00:00 2001
From: Osamu Aoki <os...@debian.org>
Date: Fri, 18 Jun 2021 14:18:22 +0900
Subject: [PATCH] Add manpage

Closes: #976146

https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=976146

Signed-off-by: Osamu Aoki <os...@debian.org>
---
 debian/manpages |  1 +
 debian/pipx.1   | 96 +++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 97 insertions(+)
 create mode 100644 debian/manpages
 create mode 100644 debian/pipx.1

diff --git a/debian/manpages b/debian/manpages
new file mode 100644
index 0000000..0a4f732
--- /dev/null
+++ b/debian/manpages
@@ -0,0 +1 @@
+debian/pipx.1
diff --git a/debian/pipx.1 b/debian/pipx.1
new file mode 100644
index 0000000..40731f6
--- /dev/null
+++ b/debian/pipx.1
@@ -0,0 +1,96 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.1.
+.TH PIPX "1" "June 2021" "pipx 0.16.3" "User Commands"
+.SH NAME
+pipx \- Install and Run Python Applications in Isolated Environments
+.SH DESCRIPTION
+usage: pipx [\-h] [\-\-version]
+.IP
+{install,inject,upgrade,upgrade\-all,uninstall,uninstall\-all,reinstall,reinstall\-all,list,run,runpip,ensurepath,completions}
+\&...
+.PP
+Install and execute apps from Python packages from PyPI (https://pypi.org/) or locally.
+.PP
+Binaries can either be installed globally into isolated Virtual Environments
+or run directly in a temporary Virtual Environment.
+.PP
+Virtual Environment location is \fI\,$HOME/.local/pipx/venvs\/\fP.
+.PP
+Symlinks to apps are placed in \fI\,$HOME/.local/bin\/\fP.
+.SS "optional environment variables:"
+.TP
+PIPX_HOME
+Overrides default pipx location. Virtual Environments
+will be installed to \fI\,$PIPX_HOME/venvs\/\fP.
+.TP
+PIPX_BIN_DIR
+Overrides location of app installations. Apps are
+symlinked or copied here.
+.TP
+USE_EMOJI
+Overrides emoji behavior. Default value varies based
+on platform.
+.TP
+PIPX_DEFAULT_PYTHON
+Overrides default python used for commands.
+.SS "optional arguments:"
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+show this help message and exit
+.TP
+\fB\-\-version\fR
+Print version and exit
+.SS "subcommands:"
+.IP
+Get help for commands with pipx COMMAND \fB\-\-help\fR
+.IP
+{install,inject,upgrade,upgrade\-all,uninstall,uninstall\-all,reinstall,reinstall\-all,list,run,runpip,ensurepath,completions}
+.TP
+install
+Install a package
+.TP
+inject
+Install packages into an existing Virtual Environment
+.TP
+upgrade
+Upgrade a package
+.TP
+upgrade\-all
+Upgrade all packages. Runs `pip install \fB\-U\fR <pkgname>`
+for each package.
+.TP
+uninstall
+Uninstall a package
+.TP
+uninstall\-all
+Uninstall all packages
+.TP
+reinstall
+Reinstall a package
+.TP
+reinstall\-all
+Reinstall all packages
+.TP
+list
+List installed packages
+.TP
+run
+Download the latest version of a package to a
+temporary virtual environment, then run an app from
+it. Also compatible with local `__pypackages__`
+directory (experimental).
+.TP
+runpip
+Run pip in an existing pipx\-managed Virtual
+Environment
+.TP
+ensurepath
+Ensure directories necessary for pipx operation are in
+your PATH environment variable.
+.TP
+completions
+Print instructions on enabling shell completions for
+pipx
+.SH "SEE ALSO"
+The full documentation for
+.B pipx
+is maintained at https://pypa.github.io/pipx/docs/
-- 
2.30.2

Reply via email to