svn commit: r1531388 - /cordova/site/public/docs/en/edge/guide_cli_index.md.html

[ma...@apache.org]

Author: marcelk
Date: Fri Oct 11 18:44:41 2013
New Revision: 1531388

URL: http://svn.apache.org/r1531388
Log:
CB-5064 Publish update from cordova-docs

Modified:
    cordova/site/public/docs/en/edge/guide_cli_index.md.html

Modified: cordova/site/public/docs/en/edge/guide_cli_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_cli_index.md.html?rev=1531388&r1=1531387&r2=1531388&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_cli_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_cli_index.md.html Fri Oct 11 18:44:41 2013
@@ -483,7 +483,58 @@ debug console from a release version:</p
 </code></pre>
 
 <p>You can batch-remove or add plugins by specifying more than one
-argument for each command.</p>
+argument for each command:</p>
+
+<pre class="prettyprint"><code>    $ cordova plugin add org.apache.cordova.console org.apache.cordova.device
+</code></pre>
+
+<p>When adding a plugin, there are several options for specifying where
+the plugin should be fetched from. The examples above use a well-known
+registry (registry.cordova.io), and the plugin is specified by the id:</p>
+
+<pre class="prettyprint"><code>    $ cordova plugin add org.apache.cordova.console
+</code></pre>
+
+<p>The id may also include the version number of the plugin, which can be
+specified following an <code>@</code> character. The version <code>latest</code> is an alias
+for the most recent version. For example:</p>
+
+<pre class="prettyprint"><code>    $ cordova plugin add org.apache.cordova.console@latest
+    $ cordova plugin add org.apache.cordova.console@0.2.1
+</code></pre>
+
+<p>If your plugin is not registered at registry.cordova.io, but is located in
+a git repository, you may specify a url to the git repository:</p>
+
+<pre class="prettyprint"><code>    $ cordova plugin add https://github.com/apache/cordova-plugin-console.git
+</code></pre>
+
+<p>The git example above assumes that the plugin should be fetched from the
+end of the master branch. If you want the plugin to be fetched using a git-ref
+such as a tag or branch, that can be specified by appending it after a <code>#</code>
+character.</p>
+
+<pre class="prettyprint"><code>    $ cordova plugin add https://github.com/apache/cordova-plugin-console.git#r0.2.0
+</code></pre>
+
+<p>If the plugin (and its <code>plugin.xml</code> file) is in a subdirectory of the git
+repo instead of the root directory, you can specify the subdirectory in the
+git repo by using a <code>:</code> character (note that a <code>#</code> is still needed):</p>
+
+<pre class="prettyprint"><code>    $ cordova plugin add https://github.com/someone/aplugin.git#:/my/sub/dir
+</code></pre>
+
+<p>You can also combine both the git-ref and the subdir:</p>
+
+<pre class="prettyprint"><code>    $ cordova plugin add https://github.com/someone/aplugin.git#r0.0.1:/my/sub/dir
+</code></pre>
+
+<p>You can also add a plugin from your local filesystem. 
+As the parameter to the <code>add</code> command, specify the
+local directory where the <code>plugin.xml</code> file is located:</p>
+
+<pre class="prettyprint"><code>    $ cordova plugin add ../my_plugin_dir
+</code></pre>
 
 <h2>
 <a name="The%20Command-line%20Interface_customize_each_platform">Customize Each Platform</a>