From bb6a747c028b841715d14147a87f659a8afefac4 Mon Sep 17 00:00:00 2001
From: sandipanpanda <87253083+sandipanpanda@users.noreply.github.com>
Date: Sun, 3 Oct 2021 01:40:37 +0530
Subject: [PATCH] Add documentation for shims command (#2091)

---
 COMMANDS.md | 31 +++++++++++++++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/COMMANDS.md b/COMMANDS.md
index ffa51dd2..0a55f21c 100644
--- a/COMMANDS.md
+++ b/COMMANDS.md
@@ -19,6 +19,7 @@ The most common subcommands are:
 * [`pyenv root`](#pyenv-root)
 * [`pyenv prefix`](#pyenv-prefix)
 * [`pyenv hooks`](#pyenv-hooks)
+* [`pyenv shims`](#pyenv-shims)
 
 ## `pyenv commands`
 
@@ -299,6 +300,32 @@ currently selected version.
 
 ## `pyenv hooks`
 
-    Usage: $ pyenv hooks <command>
-
 Lists installed hook scripts for a given pyenv command.
+
+    Usage: pyenv hooks <command>
+
+## `pyenv shims`
+
+List existing pyenv shims.
+
+    Usage: pyenv shims [--short]
+
+    $ pyenv shims
+    /home/user/.pyenv/shims/2to3
+    /home/user/.pyenv/shims/2to3-3.9
+    /home/user/.pyenv/shims/idle
+    /home/user/.pyenv/shims/idle3
+    /home/user/.pyenv/shims/idle3.9
+    /home/user/.pyenv/shims/pip
+    /home/user/.pyenv/shims/pip3
+    /home/user/.pyenv/shims/pip3.9
+    /home/user/.pyenv/shims/pydoc
+    /home/user/.pyenv/shims/pydoc3
+    /home/user/.pyenv/shims/pydoc3.9
+    /home/user/.pyenv/shims/python
+    /home/user/.pyenv/shims/python3
+    /home/user/.pyenv/shims/python3.9
+    /home/user/.pyenv/shims/python3.9-config
+    /home/user/.pyenv/shims/python3.9-gdb.py
+    /home/user/.pyenv/shims/python3-config
+    /home/user/.pyenv/shims/python-config