diff --git a/core/src/main/resources/org/elasticsearch/plugins/plugin-install.help b/core/src/main/resources/org/elasticsearch/plugins/plugin-install.help
index 7e60613b2ad..6bce1dd6f5b 100644
--- a/core/src/main/resources/org/elasticsearch/plugins/plugin-install.help
+++ b/core/src/main/resources/org/elasticsearch/plugins/plugin-install.help
@@ -8,29 +8,26 @@ SYNOPSIS
 
 DESCRIPTION
 
-    This command installs an elasticsearch plugin
+    This command installs an elasticsearch plugin. It can be used as follows:
 
-    The argument can be a <name> of one of the official plugins, or refer to a github repository
+    Officially supported or commercial plugins require just the plugin name:
 
-    The notation of just specifying a plugin name downloads an officially supported or commercial plugin
+        plugin install analysis-icu
+        plugin install shield
 
-    The notation of 'groupId/artifactId/version' refers to community plugins using maven central or sonatype
+    Plugins from GitHub require 'username/repository' or 'username/repository/version':
 
-    The notation of 'username/repository' refers to a github repository
+        plugin install lmenezes/elasticsearch-kopf
+        plugin install lmenezes/elasticsearch-kopf/1.5.7
 
-    The argument can also be a valid <url> which points to a download or file location for the plugin to be loaded from
+    Plugins from Maven Central or Sonatype require 'groupId/artifactId/version':
 
-EXAMPLES
+        plugin install org.elasticsearch/elasticsearch-mapper-attachments/2.6.0
 
-    plugin install analysis-kuromoji
+    Plugins can be installed from a custom URL or file location as follows:
 
-    plugin install shield
-
-    plugin install lmenezes/elasticsearch-kopf
-
-    plugin install http://download.elasticsearch.org/elasticsearch/elasticsearch-analysis-kuromoji/elasticsearch-analysis-kuromoji-2.7.0.zip
-
-    plugin install file:/path/to/plugin/elasticsearch-analysis-kuromoji-2.7.0.zip
+        plugin install http://some.domain.name//my-plugin-1.0.0.zip
+        plugin install file:/path/to/my-plugin-1.0.0.zip
 
 OFFICIAL PLUGINS