diff --git a/COMMANDS.md b/COMMANDS.md
index 203250d4..d1b202a8 100644
--- a/COMMANDS.md
+++ b/COMMANDS.md
@@ -268,8 +268,14 @@ version of Python, or install a package that provides binaries.
 Displays the currently active Python version, along with information on
 how it was set.
 
+Usage: pyenv version [--bare]
+
+    --bare    show just the version name. An alias to `pyenv version-name'
+
     $ pyenv version
     2.7.6 (set by /home/yyuu/.pyenv/version)
+    $ pyenv version --bare
+    2.7.6
 
 
 ## `pyenv versions`
diff --git a/libexec/pyenv-version b/libexec/pyenv-version
index 79f0275f..75e2287c 100755
--- a/libexec/pyenv-version
+++ b/libexec/pyenv-version
@@ -2,9 +2,7 @@
 # Summary: Show the current Python version(s) and its origin
 # Usage: pyenv version [--bare]
 #
-# Shows the currently selected Python version(s) and how it was
-# selected. To obtain only the version string, use `pyenv version
-# --bare` or `pyenv version-name'.
+#     --bare    show just the version name. An alias to `pyenv version-name'
 
 set -e
 [ -n "$PYENV_DEBUG" ] && set -x