add first draft of docs

Author: Massimiliano Pippi

docs/commands/arduino-cli.md

@@ -0,0 +1,42 @@
+## arduino-cli
+
+Arduino CLI.
+
+### Synopsis
+
+Arduino Command Line Interface (arduino-cli).
+
+### Examples
+
+```
+  arduino-cli <command> [flags...]
+```
+
+### Options
+
+```
+      --additional-urls strings   Additional URLs for the board manager.
+      --config-file string        The custom config file (if not specified the default will be used).
+      --format string             The output format, can be [text|json]. (default "text")
+  -h, --help                      help for arduino-cli
+      --log-file string           Path to the file where logs will be written.
+      --log-format string         The output format for the logs, can be [text|json].
+      --log-level string          Messages with this level and above will be logged. Valid levels are: Trace, Debug, Info, Warning, Error, Fatal, Panic
+  -v, --verbose                   Print the logs on the standard output.
+```
+
+### SEE ALSO
+
+* [arduino-cli board](arduino-cli_board.md)	 - Arduino board commands.
+* [arduino-cli cache](arduino-cli_cache.md)	 - Arduino cache commands.
+* [arduino-cli compile](arduino-cli_compile.md)	 - Compiles Arduino sketches.
+* [arduino-cli config](arduino-cli_config.md)	 - Arduino Configuration Commands.
+* [arduino-cli core](arduino-cli_core.md)	 - Arduino Core operations.
+* [arduino-cli daemon](arduino-cli_daemon.md)	 - Run as a daemon on port 
+* [arduino-cli debug](arduino-cli_debug.md)	 - Debug Arduino sketches.
+* [arduino-cli lib](arduino-cli_lib.md)	 - Arduino commands about libraries.
+* [arduino-cli sketch](arduino-cli_sketch.md)	 - Arduino CLI Sketch Commands.
+* [arduino-cli upload](arduino-cli_upload.md)	 - Upload Arduino sketches.
+* [arduino-cli version](arduino-cli_version.md)	 - Shows version number of arduino CLI.
+
+###### Auto generated by spf13/cobra on 4-Mar-2020

docs/commands/arduino-cli_board.md

@@ -0,0 +1,45 @@
+## arduino-cli board
+
+Arduino board commands.
+
+### Synopsis
+
+Arduino board commands.
+
+### Examples
+
+```
+  # Lists all connected boards.
+  arduino-cli board list
+
+  # Attaches a sketch to a board.
+  arduino-cli board attach serial:///dev/tty/ACM0 mySketch
+```
+
+### Options
+
+```
+  -h, --help   help for board
+```
+
+### Options inherited from parent commands
+
+```
+      --additional-urls strings   Additional URLs for the board manager.
+      --config-file string        The custom config file (if not specified the default will be used).
+      --format string             The output format, can be [text|json]. (default "text")
+      --log-file string           Path to the file where logs will be written.
+      --log-format string         The output format for the logs, can be [text|json].
+      --log-level string          Messages with this level and above will be logged. Valid levels are: Trace, Debug, Info, Warning, Error, Fatal, Panic
+  -v, --verbose                   Print the logs on the standard output.
+```
+
+### SEE ALSO
+
+* [arduino-cli](arduino-cli.md)	 - Arduino CLI.
+* [arduino-cli board attach](arduino-cli_board_attach.md)	 - Attaches a sketch to a board.
+* [arduino-cli board details](arduino-cli_board_details.md)	 - Print details about a board.
+* [arduino-cli board list](arduino-cli_board_list.md)	 - List connected boards.
+* [arduino-cli board listall](arduino-cli_board_listall.md)	 - List all known boards and their corresponding FQBN.
+
+###### Auto generated by spf13/cobra on 4-Mar-2020

docs/commands/arduino-cli_board_attach.md

@@ -0,0 +1,44 @@
+## arduino-cli board attach
+
+Attaches a sketch to a board.
+
+### Synopsis
+
+Attaches a sketch to a board.
+
+```
+arduino-cli board attach <port>|<FQBN> [sketchPath] [flags]
+```
+
+### Examples
+
+```
+  arduino-cli board attach serial:///dev/tty/ACM0
+  arduino-cli board attach serial:///dev/tty/ACM0 HelloWorld
+  arduino-cli board attach arduino:samd:mkr1000
+```
+
+### Options
+
+```
+  -h, --help             help for attach
+      --timeout string   The timeout of the search of connected devices, try to high it if your board is not found (e.g. to 10s). (default "5s")
+```
+
+### Options inherited from parent commands
+
+```
+      --additional-urls strings   Additional URLs for the board manager.
+      --config-file string        The custom config file (if not specified the default will be used).
+      --format string             The output format, can be [text|json]. (default "text")
+      --log-file string           Path to the file where logs will be written.
+      --log-format string         The output format for the logs, can be [text|json].
+      --log-level string          Messages with this level and above will be logged. Valid levels are: Trace, Debug, Info, Warning, Error, Fatal, Panic
+  -v, --verbose                   Print the logs on the standard output.
+```
+
+### SEE ALSO
+
+* [arduino-cli board](arduino-cli_board.md)	 - Arduino board commands.
+
+###### Auto generated by spf13/cobra on 4-Mar-2020

docs/commands/arduino-cli_board_details.md

@@ -0,0 +1,41 @@
+## arduino-cli board details
+
+Print details about a board.
+
+### Synopsis
+
+Show information about a board, in particular if the board has options to be specified in the FQBN.
+
+```
+arduino-cli board details <FQBN> [flags]
+```
+
+### Examples
+
+```
+  arduino-cli board details arduino:avr:nano
+```
+
+### Options
+
+```
+  -h, --help   help for details
+```
+
+### Options inherited from parent commands
+
+```
+      --additional-urls strings   Additional URLs for the board manager.
+      --config-file string        The custom config file (if not specified the default will be used).
+      --format string             The output format, can be [text|json]. (default "text")
+      --log-file string           Path to the file where logs will be written.
+      --log-format string         The output format for the logs, can be [text|json].
+      --log-level string          Messages with this level and above will be logged. Valid levels are: Trace, Debug, Info, Warning, Error, Fatal, Panic
+  -v, --verbose                   Print the logs on the standard output.
+```
+
+### SEE ALSO
+
+* [arduino-cli board](arduino-cli_board.md)	 - Arduino board commands.
+
+###### Auto generated by spf13/cobra on 4-Mar-2020

docs/commands/arduino-cli_board_list.md

@@ -0,0 +1,42 @@
+## arduino-cli board list
+
+List connected boards.
+
+### Synopsis
+
+Detects and displays a list of connected boards to the current computer.
+
+```
+arduino-cli board list [flags]
+```
+
+### Examples
+
+```
+  arduino-cli board list --timeout 10s
+```
+
+### Options
+
+```
+  -h, --help             help for list
+      --timeout string   The timeout of the search of connected devices, try to increase it if your board is not found (e.g. to 10s). (default "0s")
+```
+
+### Options inherited from parent commands
+
+```
+      --additional-urls strings   Additional URLs for the board manager.
+      --config-file string        The custom config file (if not specified the default will be used).
+      --format string             The output format, can be [text|json]. (default "text")
+      --log-file string           Path to the file where logs will be written.
+      --log-format string         The output format for the logs, can be [text|json].
+      --log-level string          Messages with this level and above will be logged. Valid levels are: Trace, Debug, Info, Warning, Error, Fatal, Panic
+  -v, --verbose                   Print the logs on the standard output.
+```
+
+### SEE ALSO
+
+* [arduino-cli board](arduino-cli_board.md)	 - Arduino board commands.
+
+###### Auto generated by spf13/cobra on 4-Mar-2020

docs/commands/arduino-cli_board_listall.md

@@ -0,0 +1,43 @@
+## arduino-cli board listall
+
+List all known boards and their corresponding FQBN.
+
+### Synopsis
+
+List all boards that have the support platform installed. You can search
+for a specific board if you specify the board name
+
+```
+arduino-cli board listall [boardname] [flags]
+```
+
+### Examples
+
+```
+  arduino-cli board listall
+  arduino-cli board listall zero
+```
+
+### Options
+
+```
+  -h, --help   help for listall
+```
+
+### Options inherited from parent commands
+
+```
+      --additional-urls strings   Additional URLs for the board manager.
+      --config-file string        The custom config file (if not specified the default will be used).
+      --format string             The output format, can be [text|json]. (default "text")
+      --log-file string           Path to the file where logs will be written.
+      --log-format string         The output format for the logs, can be [text|json].
+      --log-level string          Messages with this level and above will be logged. Valid levels are: Trace, Debug, Info, Warning, Error, Fatal, Panic
+  -v, --verbose                   Print the logs on the standard output.
+```
+
+### SEE ALSO
+
+* [arduino-cli board](arduino-cli_board.md)	 - Arduino board commands.
+
+###### Auto generated by spf13/cobra on 4-Mar-2020

docs/commands/arduino-cli_cache.md

@@ -0,0 +1,41 @@
+## arduino-cli cache
+
+Arduino cache commands.
+
+### Synopsis
+
+Arduino cache commands.
+
+### Examples
+
+```
+# Clean caches.
+ arduino-cli cache clean
+
+
+```
+
+### Options
+
+```
+  -h, --help   help for cache
+```
+
+### Options inherited from parent commands
+
+```
+      --additional-urls strings   Additional URLs for the board manager.
+      --config-file string        The custom config file (if not specified the default will be used).
+      --format string             The output format, can be [text|json]. (default "text")
+      --log-file string           Path to the file where logs will be written.
+      --log-format string         The output format for the logs, can be [text|json].
+      --log-level string          Messages with this level and above will be logged. Valid levels are: Trace, Debug, Info, Warning, Error, Fatal, Panic
+  -v, --verbose                   Print the logs on the standard output.
+```
+
+### SEE ALSO
+
+* [arduino-cli](arduino-cli.md)	 - Arduino CLI.
+* [arduino-cli cache clean](arduino-cli_cache_clean.md)	 - Clean arduino cache.
+
+###### Auto generated by spf13/cobra on 4-Mar-2020

docs/commands/arduino-cli_cache_clean.md

@@ -0,0 +1,41 @@
+## arduino-cli cache clean
+
+Clean arduino cache.
+
+### Synopsis
+
+Clean the files i.e. `~/arduino15/staging` in Linux.
+
+```
+arduino-cli cache clean [flags]
+```
+
+### Examples
+
+```
+  arduino-cli cache clean
+```
+
+### Options
+
+```
+  -h, --help   help for clean
+```
+
+### Options inherited from parent commands
+
+```
+      --additional-urls strings   Additional URLs for the board manager.
+      --config-file string        The custom config file (if not specified the default will be used).
+      --format string             The output format, can be [text|json]. (default "text")
+      --log-file string           Path to the file where logs will be written.
+      --log-format string         The output format for the logs, can be [text|json].
+      --log-level string          Messages with this level and above will be logged. Valid levels are: Trace, Debug, Info, Warning, Error, Fatal, Panic
+  -v, --verbose                   Print the logs on the standard output.
+```
+
+### SEE ALSO
+
+* [arduino-cli cache](arduino-cli_cache.md)	 - Arduino cache commands.
+
+###### Auto generated by spf13/cobra on 4-Mar-2020