Notify about version field when creating library

docs/librarymanager/config.rst

@@ -196,7 +196,7 @@ dash. `Semantic Versioning <http://semver.org>`_ IS RECOMMENDED.
     field is defined.
 
     |PIOAPICR| will use the
-    `CVS <http://en.wikipedia.org/wiki/Concurrent_Versions_System>`_ revision from
+    `VCS <http://en.wikipedia.org/wiki/Concurrent_Versions_System>`_ revision from
     the latest commit as "current version". For example, ``13`` (*SVN*) or first
     10 chars of *SHA* digest ``e4564b7da4`` (*Git*). If :ref:`libjson_repository`
     ``branch`` is not specified, then default branch will be used.

docs/librarymanager/creating.rst

@@ -44,34 +44,63 @@ If a library source code is located at `GitHub <https://github.com>`_, then
 you **need to specify** only these fields in the :ref:`library_config`:
 
 * :ref:`libjson_name`
+* :ref:`libjson_version` (is not required, but highly recommended for new :ref:`librarymanager`)
 * :ref:`libjson_keywords`
 * :ref:`libjson_description`
 * :ref:`libjson_repository`
 
-|PIOAPICR| will populate the rest fields, like :ref:`libjson_version` or
+|PIOAPICR| will populate the rest fields, like :ref:`libjson_authors` with an
-:ref:`libjson_authors` with an actual information from *GitHub*.
+actual information from *GitHub*.
 
-Example:
+Example, `DallasTemperature <http://platformio.org/lib/show/54/DallasTemperature/manifest>`_:
 
 .. code-block:: javascript
 
     {
-        "name": "IRremote",
+      "name": "DallasTemperature",
-        "keywords": "infrared, ir, remote",
+      "keywords": "onewire, 1-wire, bus, sensor, temperature",
-        "description": "Send and receive infrared signals with multiple protocols",
+      "description": "Arduino Library for Dallas Temperature ICs (DS18B20, DS18S20, DS1822, DS1820)",
-        "repository":
+      "repository":
+      {
+        "type": "git",
+        "url": "https://github.com/milesburton/Arduino-Temperature-Control-Library.git"
+      },
+      "authors":
+      [
         {
-            "type": "git",
+          "name": "Miles Burton",
-            "url": "https://github.com/shirriff/Arduino-IRremote.git"
+          "email": "miles@mnetcs.com",
+          "url": "http://www.milesburton.com",
+          "maintainer": true
         },
-        "frameworks": "arduino",
+        {
-        "platforms": "atmelavr"
+          "name": "Tim Newsome",
+          "email": "nuisance@casualhacker.net"
+        },
+        {
+          "name": "Guil Barros",
+          "email": "gfbarros@bappos.com"
+        },
+        {
+          "name": "Rob Tillaart",
+          "email": "rob.tillaart@gmail.com"
+        }
+      ],
+      "dependencies":
+      {
+        "name": "OneWire",
+        "authors": "Paul Stoffregen",
+        "frameworks": "arduino"
+      },
+      "version": "3.7.7",
+      "frameworks": "arduino",
+      "platforms": "*"
     }
 
-Under CVS (SVN/GIT)
+Under VCS (SVN/GIT)
 ^^^^^^^^^^^^^^^^^^^
 
-|PIOAPICR| can operate with a library source code that is under *CVS* control.
+|PIOAPICR| can operate with a library source code that is under *VCS* control.
 The list of **required** fields in the :ref:`library_config` will look like:
 
 * :ref:`libjson_name`

docs/quickstart.rst

@@ -133,7 +133,7 @@ next structure:
   (``*.h, *.c, *.cpp, *.S, *.ino, etc.``)
 * ``lib`` directory can be used for the project specific (private) libraries.
   More details are located in ``lib/readme.txt`` file.
-* Miscellaneous files for CVS and :ref:`ci` support.
+* Miscellaneous files for VCS and :ref:`ci` support.
 
 
 .. note::

docs/userguide/cmd_init.rst

@@ -37,7 +37,7 @@ This command will create:
   (``*.h, *.c, *.cpp, *.S, *.ino, etc.``)
 * ``lib`` directory can be used for the project specific (private) libraries.
   More details are located in ``lib/readme.txt`` file.
-* Miscellaneous files for CVS and :ref:`ci` support.
+* Miscellaneous files for VCS and :ref:`ci` support.
 
 Options
 -------

platformio/exception.py

@@ -50,7 +50,7 @@ class PlatformNotInstalledYet(PlatformioException):
 
 class BoardNotDefined(PlatformioException):
 
-    MESSAGE = "You need to specify board type using `-b` or `--board` "\
+    MESSAGE = "You need to specify board ID using `-b` or `--board` "\
         "option. Supported boards list is available via "\
         " `platformio boards` command"