Resolve #133: Disabled "prompts" automatically for *Continuous Integration* systems

docs/envvars.rst

@@ -18,6 +18,19 @@ General
 PlatformIO uses *General* environment variables for the common
 operations/commands.
 
+.. _envvar_CI:
+
+CI
+~~
+
+PlatformIO handles ``CI`` variable which is setup by
+`Continuous Integration <http://en.wikipedia.org/wiki/Continuous_integration>`_
+(Travis, Circle and etc.) systems.
+Currently, PlatformIO uses it to disable prompts.
+
+In other words, ``CI=true`` automatically setup
+:ref:`PLATFORMIO_SETTING_ENABLE_PROMPTS=false <envvar_PLATFORMIO_SETTING_ENABLE_PROMPTS>`.
+
 .. _envvar_PLATFORMIO_HOME_DIR:
 
 PLATFORMIO_HOME_DIR

docs/installation.rst

@@ -32,11 +32,12 @@ application:
 .. warning::
     If you are going to run *PlatformIO* from **subprocess**, you **MUST
     DISABLE** all prompts. It will allow you to avoid blocking.
-    There are 2 options:
+    There are a few options:
 
-    - using environment variable :ref:`PLATFORMIO_SETTING_ENABLE_PROMPTS=false <envvar_PLATFORMIO_SETTING_ENABLE_PROMPTS>`
-    - disable global setting via :ref:`platformio setting enable_prompts false <cmd_settings>`
-      command.
+    - using environment variable :ref:`PLATFORMIO_SETTING_ENABLE_PROMPTS=No <envvar_PLATFORMIO_SETTING_ENABLE_PROMPTS>`
+    - disable global setting ``enable_prompts`` via :ref:`cmd_settings` command
+    - masking under Continuous Integration system via environment variable
+      :ref:`CI=true <envvar_CI>`.
 
 Please *choose one of* the following:
 

docs/userguide/cmd_settings.rst

@@ -86,7 +86,9 @@ better.
 
 
 .. note::
-    You can override these settings using :ref:`envvars`.
+    * The ``Yes`` value is equl to: ``True``, ``Y``, ``1``.
+      The value is not case sensetive.
+    * You can override these settings using :ref:`envvars`.
 
 Examples
 ~~~~~~~~