Boards and Library manager command line interface documentation

Author: Federico Fissore

build/shared/manpage.adoc

@@ -27,6 +27,12 @@ SYNOPSIS
 
 *arduino* [*--verify*|*--upload*] [*--board* __package__:__arch__:__board__[:__parameters__]] [*--port* __portname__] [*--pref* __name__=__value__] [*-v*|*--verbose*] [__FILE.ino__]
 
+*arduino* [*--get-pref* __preference__]
+
+*arduino* [*--install-board* __package name__:__platform name__[:__version__]]
+
+*arduino* [*--install-library* __library name__[:__version__]]
+
 DESCRIPTION
 -----------
 The 'arduino' integrated development environment allows editing,
@@ -49,6 +55,25 @@ between multiple runs and only recompile the files that changed.
 Note that on MacOS X, the main executable is
 'Arduino.app/Contents/MacOS/JavaApplicationStub' instead of 'arduino'.
 
+ACTIONS
+
+*--verify*::
+	Build the sketch.
+
+*--upload*::
+	Build and upload the sketch.
+
+*--get-pref* __preference__::
+	Prints the value of the given preference to the standard output
+	stream. When the value does not exist, nothing is printed and
+	the exit status is set (see EXIT STATUS below).
+
+*--install-board* __package name__:__platform name__[:__version__]::
+	Fetches available board support (platform) list and install the specified one, along with its related tools. If __version__ is omitted, the latest is installed. If a platform with the same version is already installed, nothing is installed and program exits with exit code 1. If a platform with a different version is already installed, it's replaced.
+
+*--install-library* __library name__[:__version__]::
+	Fetches available libraries list and install the specified one. If __version__ is omitted, the latest is installed. If a library with the same version is already installed, nothing is installed and program exits with exit code 1. If a library with a different version is already installed, it's replaced.
+
 OPTIONS
 -------
 *--board* __package__:__arch__:__board__[:__parameters__]::
@@ -130,17 +155,6 @@ OPTIONS
 	*--board*, *--port*, *--pref*, *--verbose*, *--verbose-build* and
 	*--verbose-upload* may alter the current preferences.
 
-*--upload*::
-	Build and upload the sketch.
-
-*--verify*::
-	Build the sketch.
-
-*--get-pref __preference__*::
-	Prints the value of the given preference to the standard output
-	stream. When the value does not exist, nothing is printed and
-	the exit status is set (see EXIT STATUS below).
-
 PREFERENCES
 -----------
 Arduino keeps a list of preferences, as simple name and value pairs.
@@ -233,6 +247,14 @@ Change the selected board and build path and do nothing else.
 
      arduino --pref build.path=/path/to/sketch/build --board arduino:avr:uno --save-prefs
 
+Install latest SAM board support
+
+     arduino --install-board "arduino:Arduino SAM Boards (32-bits ARM Cortex-M3)"
+
+Install Bridge library version 1.0.0
+
+     arduino --install-library "Bridge:1.0.0"
+
 HISTORY
 -------
 1.5.2::
@@ -262,6 +284,9 @@ HISTORY
 1.5.8::
 	Introduced *--save-prefs*.
 
+1.6.4::
+	Introduced *--install-board* and *--install-library*.
+
 {empty}::
 	*--pref* options are now not saved to the preferences file, just
 	like *--board* and *--port*, unless *--save-prefs* is specified.