summaryrefslogtreecommitdiff
path: root/docs/source
diff options
context:
space:
mode:
authorOpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com>2020-11-13 16:46:51 +0100
committerGitHub <noreply@github.com>2020-11-13 16:46:51 +0100
commit2993e97dec9d998d2eca7c5aee918b1429596a85 (patch)
tree9bdb3b5c766d913a8d1980ad017276e1f1a51b7c /docs/source
parent6d9d9fee30b5982858d51a666f0c335ba47323a0 (diff)
parentae3816614de1c2a0c9ab9cd05afebc5b1dda6429 (diff)
downloadpodman-2993e97dec9d998d2eca7c5aee918b1429596a85.tar.gz
podman-2993e97dec9d998d2eca7c5aee918b1429596a85.tar.bz2
podman-2993e97dec9d998d2eca7c5aee918b1429596a85.zip
Merge pull request #6442 from Luap99/podman-autocomplete
Shell completion
Diffstat (limited to 'docs/source')
-rw-r--r--docs/source/markdown/podman-completion.1.md56
-rw-r--r--docs/source/markdown/podman.1.md1
2 files changed, 57 insertions, 0 deletions
diff --git a/docs/source/markdown/podman-completion.1.md b/docs/source/markdown/podman-completion.1.md
new file mode 100644
index 000000000..50b0b6145
--- /dev/null
+++ b/docs/source/markdown/podman-completion.1.md
@@ -0,0 +1,56 @@
+% podman-completion(1)
+
+## NAME
+podman\-completion - Generate shell completion scripts
+
+## SYNOPSIS
+**podman completion** [*options*] *bash*|*zsh*|*fish*
+
+## DESCRIPTION
+The completion command allows you to generate shell completion scripts. Supported shells are **bash**, **zsh** and **fish**.
+
+These script are used by the shell to provide suggestions and complete commands when you are typing the command and press [TAB].
+
+Usually these scripts are automatically installed via the package manager.
+
+## OPTIONS
+#### **--file**, **-f**
+
+Write the generated output to file.
+
+#### **--no-desc**
+
+Do not provide description in the completions.
+
+## Installation
+
+### BASH
+Make sure you have `bash-completion` installed on your system.
+
+To load the completion script into your current session run:
+`source <(podman completion bash)`
+
+To make it available in all your bash sessions run:
+`podman completion bash -f /etc/bash_completion.d/podman`
+
+
+### ZSH
+If shell completion is not already enabled in your environment you will need to enable it. You can execute the following once:
+`echo "autoload -U compinit; compinit" >> ~/.zshrc`
+
+To make it available in all your zsh sessions run:
+`podman completion zsh -f "${fpath[1]}/_podman"`
+
+Once you reload the shell the autocompletion should be working.
+
+
+### FISH
+To load the completion script into your current session run:
+`podman completion fish | source`
+
+To make it available in all your fish sessions run:
+`podman completion fish -f ~/.config/fish/completions/podman.fish`
+
+
+## SEE ALSO
+[podman(1)](podman.1.md)
diff --git a/docs/source/markdown/podman.1.md b/docs/source/markdown/podman.1.md
index 993f285ed..87867bf35 100644
--- a/docs/source/markdown/podman.1.md
+++ b/docs/source/markdown/podman.1.md
@@ -205,6 +205,7 @@ the exit codes follow the `chroot` standard, see below:
| [podman-auto-update(1)](podman-auto-update.1.md) | Auto update containers according to their auto-update policy |
| [podman-build(1)](podman-build.1.md) | Build a container image using a Containerfile. |
| [podman-commit(1)](podman-commit.1.md) | Create new image based on the changed container. |
+| [podman-completion(1)](podman-completion.1.md) | Generate shell completion scripts |
| [podman-container(1)](podman-container.1.md) | Manage containers. |
| [podman-cp(1)](podman-cp.1.md) | Copy files/folders between a container and the local filesystem. |
| [podman-create(1)](podman-create.1.md) | Create a new container. |