Increase clarity of command line tool

The command line option --skip-compilation can be confusing, because unit tests must be
compiled before they can run.  This adds some text to the flag such that the fact that
examples are compiled is acknowledged.

Author: ianfixes

CHANGELOG.md

@@ -7,11 +7,13 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 ### Added
+- `arduino_ci_remote.rb` CLI switch `--skip-examples-compilation`
 
 ### Changed
 - Move repository from https://github.com/ianfixes/arduino_ci to https://github.com/Arduino-CI/arduino_ci
 
 ### Deprecated
+- `arduino_ci_remote.rb` CLI switch `--skip-compilation`
 
 ### Removed
 

REFERENCE.md

@@ -19,9 +19,14 @@ When testing locally, it's often advantageous to limit the number of tests that
 This completely skips the unit testing portion of the CI script.
 
 
-### `--skip-compilation` option
+### `--skip-compilation` option (deprecated)
 
-This completely skips the compilation tests (of library examples) portion of the CI script.
+This completely skips the compilation tests (of library examples) portion of the CI script.  It does not skip the compilation of unit tests.
+
+
+### `--skip-examples-compilation` option
+
+This completely skips the compilation tests (of library examples) portion of the CI script.  It does not skip the compilation of unit tests.
 
 
 ### `--testfile-select` option
@@ -90,8 +95,8 @@ platforms:
 
 ### Control How Examples Are Compiled
 
-Put a file `.arduino-ci.yml` in each example directory where you require a different configuration than default.  
-The `compile:` section controls the platforms on which the compilation will be attempted, as well as any external libraries that must be installed and included.  
+Put a file `.arduino-ci.yml` in each example directory where you require a different configuration than default.
+The `compile:` section controls the platforms on which the compilation will be attempted, as well as any external libraries that must be installed and included.
 
 ```yaml
 compile:

exe/arduino_ci_remote.rb

@@ -29,7 +29,12 @@ def self.parse(options)
         output_options[:skip_unittests] = p
       end
 
-      opts.on("--skip-compilation", "Don't compile example sketches") do |p|
+      opts.on("--skip-compilation", "Don't compile example sketches (deprecated)") do |p|
+        puts "The option --skip-compilation has been deprecated in favor of --skip-examples-compilation"
+        output_options[:skip_compilation] = p
+      end
+
+      opts.on("--skip-examples-compilation", "Don't compile example sketches") do |p|
         output_options[:skip_compilation] = p
       end