Merge branch 'release/v2.4.0'

Version bump to 2.4.0 (issues #271 , #334 , #335 , #336 , #339 , #340 , #343 , #345 , #346 )
Drop Click to (5.1) <6 // Issue #346
2025-12-23 07:12:31 +01:00 · 2015-12-01 17:51:04 +02:00 · 2015-12-01 17:50:35 +02:00 · 2015-12-01 17:43:16 +02:00 · 2015-12-01 17:41:10 +02:00 · 2015-12-01 16:28:47 +02:00
218 changed files with 4287 additions and 1018 deletions
--- a/.pylintrc
+++ b/.pylintrc
@@ -1,29 +1,9 @@
-[MASTER]
-
-# Specify a configuration file.
-#rcfile=
-
-# Python code to execute, usually for sys.path manipulation such as
-# pygtk.require().
-#init-hook=
-
-# Profiled execution.
-profile=no
-
-# Add files or directories to the blacklist. They should be base names, not
-# paths.
-ignore=CVS
-
-# Pickle collected data for later comparisons.
-persistent=yes
-
-# List of plugins (as comma separated values of python modules names) to load,
-# usually to register additional checkers.
-load-plugins=
-
-
 [MESSAGES CONTROL]

+# Only show warnings with the listed confidence levels. Leave empty to show
+# all. Valid levels: HIGH, INFERENCE, INFERENCE_FAILURE, UNDEFINED
+confidence=
+
 # Enable the message, report, category or checker with the given id(s). You can
 # either give multiple identifier separated by comma (,) or put this option
 # multiple time. See also the "--disable" option for examples.
@@ -38,244 +18,6 @@ load-plugins=
 # --enable=similarities". If you want to run only the classes checker, but have
 # no Warning level messages displayed, use"--disable=all --enable=classes
 # --disable=W"
-disable=C0103,C0111,E0611,F0401,I0011,R0801,R0903,R0922
+# disable=import-star-module-level,old-octal-literal,oct-method,print-statement,unpacking-in-except,parameter-unpacking,backtick,old-raise-syntax,old-ne-operator,long-suffix,dict-view-method,dict-iter-method,metaclass-assignment,next-method-called,raising-string,indexing-exception,raw_input-builtin,long-builtin,file-builtin,execfile-builtin,coerce-builtin,cmp-builtin,buffer-builtin,basestring-builtin,apply-builtin,filter-builtin-not-iterating,using-cmp-argument,useless-suppression,range-builtin-not-iterating,suppressed-message,no-absolute-import,old-division,cmp-method,reload-builtin,zip-builtin-not-iterating,intern-builtin,unichr-builtin,reduce-builtin,standarderror-builtin,unicode-builtin,xrange-builtin,coerce-method,delslice-method,getslice-method,setslice-method,input-builtin,round-builtin,hex-method,nonzero-method,map-builtin-not-iterating

-
-[REPORTS]
-
-# Set the output format. Available formats are text, parseable, colorized, msvs
-# (visual studio) and html. You can also give a reporter class, eg
-# mypackage.mymodule.MyReporterClass.
-output-format=text
-
-# Put messages in a separate file for each module / package specified on the
-# command line instead of printing them on stdout. Reports (if any) will be
-# written in a file name "pylint_global.[txt|html]".
-files-output=no
-
-# Tells whether to display a full report or only the messages
-reports=yes
-
-# Python expression which should return a note less than 10 (10 is the highest
-# note). You have access to the variables errors warning, statement which
-# respectively contain the number of errors / warnings messages and the total
-# number of statements analyzed. This is used by the global evaluation report
-# (RP0004).
-evaluation=10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10)
-
-# Add a comment according to your evaluation note. This is used by the global
-# evaluation report (RP0004).
-comment=no
-
-# Template used to display messages. This is a python new-style format string
-# used to format the message information. See doc for all details
-#msg-template=
-msg-template={path}:{line}: [{msg_id}({symbol}), {obj}] {msg}
-
-
-[BASIC]
-
-# Required attributes for module, separated by a comma
-required-attributes=
-
-# List of builtins function names that should not be used, separated by a comma
-bad-functions=map,filter,apply,input
-
-# Regular expression which should only match correct module names
-module-rgx=(([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$
-
-# Regular expression which should only match correct module level names
-const-rgx=(([A-Z_][A-Z0-9_]*)|(__.*__))$
-
-# Regular expression which should only match correct class names
-class-rgx=[A-Z_][a-zA-Z0-9]+$
-
-# Regular expression which should only match correct function names
-function-rgx=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression which should only match correct method names
-method-rgx=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression which should only match correct instance attribute names
-attr-rgx=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression which should only match correct argument names
-argument-rgx=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression which should only match correct variable names
-variable-rgx=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression which should only match correct attribute names in class
-# bodies
-class-attribute-rgx=([A-Za-z_][A-Za-z0-9_]{2,30}|(__.*__))$
-
-# Regular expression which should only match correct list comprehension /
-# generator expression variable names
-inlinevar-rgx=[A-Za-z_][A-Za-z0-9_]*$
-
-# Good variable names which should always be accepted, separated by a comma
-good-names=i,j,k,ex,Run,_
-
-# Bad variable names which should always be refused, separated by a comma
-bad-names=foo,bar,baz,toto,tutu,tata
-
-# Regular expression which should only match function or class names that do
-# not require a docstring.
-no-docstring-rgx=__.*__
-
-# Minimum line length for functions/classes that require docstrings, shorter
-# ones are exempt.
-docstring-min-length=-1
-
-
-[FORMAT]
-
-# Maximum number of characters on a single line.
-max-line-length=80
-
-# Regexp for a line that is allowed to be longer than the limit.
-ignore-long-lines=^\s*(# )?<?https?://\S+>?$
-
-# Allow the body of an if to be on the same line as the test if there is no
-# else.
-single-line-if-stmt=no
-
-# List of optional constructs for which whitespace checking is disabled
-no-space-check=trailing-comma,dict-separator
-
-# Maximum number of lines in a module
-max-module-lines=1000
-
-# String used as indentation unit. This is usually " " (4 spaces) or "\t" (1
-# tab).
-indent-string='    '
-
-
-[MISCELLANEOUS]
-
-# List of note tags to take in consideration, separated by a comma.
-notes=FIXME,XXX,TODO
-
-
-[SIMILARITIES]
-
-# Minimum lines number of a similarity.
-min-similarity-lines=4
-
-# Ignore comments when computing similarities.
-ignore-comments=yes
-
-# Ignore docstrings when computing similarities.
-ignore-docstrings=yes
-
-# Ignore imports when computing similarities.
-ignore-imports=no
-
-
-[TYPECHECK]
-
-# Tells whether missing members accessed in mixin class should be ignored. A
-# mixin class is detected if its name ends with "mixin" (case insensitive).
-ignore-mixin-members=yes
-
-# List of classes names for which member attributes should not be checked
-# (useful for classes with attributes dynamically set).
-ignored-classes=SQLObject
-
-# When zope mode is activated, add a predefined set of Zope acquired attributes
-# to generated-members.
-zope=no
-
-# List of members which are set dynamically and missed by pylint inference
-# system, and so shouldn't trigger E0201 when accessed. Python regular
-# expressions are accepted.
-generated-members=REQUEST,acl_users,aq_parent
-
-
-[VARIABLES]
-
-# Tells whether we should check for unused import in __init__ files.
-init-import=no
-
-# A regular expression matching the beginning of the name of dummy variables
-# (i.e. not used).
-dummy-variables-rgx=_$|dummy
-
-# List of additional names supposed to be defined in builtins. Remember that
-# you should avoid to define new builtins when possible.
-additional-builtins=
-
-
-[CLASSES]
-
-# List of interface methods to ignore, separated by a comma. This is used for
-# instance to not check methods defines in Zope's Interface base class.
-ignore-iface-methods=isImplementedBy,deferred,extends,names,namesAndDescriptions,queryDescriptionFor,getBases,getDescriptionFor,getDoc,getName,getTaggedValue,getTaggedValueTags,isEqualOrExtendedBy,setTaggedValue,isImplementedByInstancesOf,adaptWith,is_implemented_by
-
-# List of method names used to declare (i.e. assign) instance attributes.
-defining-attr-methods=__init__,__new__,setUp
-
-# List of valid names for the first argument in a class method.
-valid-classmethod-first-arg=cls
-
-# List of valid names for the first argument in a metaclass class method.
-valid-metaclass-classmethod-first-arg=mcs
-
-
-[DESIGN]
-
-# Maximum number of arguments for function / method
-max-args=5
-
-# Argument names that match this expression will be ignored. Default to name
-# with leading underscore
-ignored-argument-names=_.*
-
-# Maximum number of locals for function / method body
-max-locals=15
-
-# Maximum number of return / yield for function / method body
-max-returns=6
-
-# Maximum number of branch for function / method body
-max-branches=12
-
-# Maximum number of statements in function / method body
-max-statements=50
-
-# Maximum number of parents for a class (see R0901).
-max-parents=7
-
-# Maximum number of attributes for a class (see R0902).
-max-attributes=7
-
-# Minimum number of public methods for a class (see R0903).
-min-public-methods=2
-
-# Maximum number of public methods for a class (see R0904).
-max-public-methods=20
-
-
-[IMPORTS]
-
-# Deprecated modules which should not be used, separated by a comma
-deprecated-modules=regsub,TERMIOS,Bastion,rexec
-
-# Create a graph of every (i.e. internal and external) dependencies in the
-# given file (report RP0402 must not be disabled)
-import-graph=
-
-# Create a graph of external dependencies in the given file (report RP0402 must
-# not be disabled)
-ext-import-graph=
-
-# Create a graph of internal dependencies in the given file (report RP0402 must
-# not be disabled)
-int-import-graph=
-
-
-[EXCEPTIONS]
-
-# Exceptions that will emit a warning when being caught. Defaults to
-# "Exception"
-overgeneral-exceptions=Exception
+disable=locally-disabled,missing-docstring,invalid-name,too-few-public-methods,redefined-variable-type,import-error,similarities,unsupported-membership-test,unsubscriptable-object,ungrouped-imports
--- a/HISTORY.rst
+++ b/HISTORY.rst
@@ -4,6 +4,74 @@ Release History
 PlatformIO 2.0
 --------------

+2.4.0 (2015-12-01)
+~~~~~~~~~~~~~~~~~~
+
+* Added support for the new boards: Atmel ATSAMR21-XPRO, Atmel SAML21-XPRO-B,
+  Atmel SAMD21-XPRO, ST 32F469IDISCOVERY, ST 32L476GDISCOVERY, ST Nucleo F031K6,
+  ST Nucleo F042K6, ST Nucleo F303K8 and ST Nucleo L476RG
+* Updated Arduino core for Espressif platform to 2.0.0
+  (`issue #345 <https://github.com/platformio/platformio/issues/345>`_)
+* Added to FAQ explanation of `Can not compile a library that compiles without issue
+  with Arduino IDE <http://docs.platformio.org/en/latest/faq.html#building>`_
+  (`issue #331 <https://github.com/platformio/platformio/issues/331>`_)
+* Fixed ESP-12E flash size
+  (`pull #333 <https://github.com/platformio/platformio/pull/333>`_)
+* Fixed configuration for LowPowerLab MoteinoMEGA board
+  (`issue #335 <https://github.com/platformio/platformio/issues/335>`_)
+* Fixed "LockFailed: failed to create appstate.json.lock" error for Windows
+* Fixed relative include path for preprocessor using ``build_flags``
+  (`issue #271 <https://github.com/platformio/platformio/issues/271>`_)
+
+2.3.5 (2015-11-18)
+~~~~~~~~~~~~~~~~~~
+
+* Added support of `libOpenCM3 <http://docs.platformio.org/en/latest/frameworks/libopencm3.html>`_
+  framework for Nucleo F103RB board
+  (`issue #309 <https://github.com/platformio/platformio/issues/309>`_)
+* Added support for Espressif ESP8266 ESP-12E board (NodeMCU)
+  (`issue #310 <https://github.com/platformio/platformio/issues/310>`_)
+* Added support for pySerial 3.0
+  (`issue #307 <https://github.com/platformio/platformio/issues/307>`_)
+* Updated Arduino AVR/SAM frameworks to 1.6.6
+  (`issue #321 <https://github.com/platformio/platformio/issues/321>`_)
+* Upload firmware using external programmer via `platformio run --target program <http://docs.platformio.org/en/latest/userguide/cmd_run.html#cmdoption-platformio-run-t>`__
+  target
+  (`issue #311 <https://github.com/platformio/platformio/issues/311>`_)
+* Fixed handling of upload port when ``board`` option is not specified in
+  `platformio.ini <http://docs.platformio.org/en/latest/projectconf.html>`__
+  (`issue #313 <https://github.com/platformio/platformio/issues/313>`_)
+* Fixed firmware uploading for `nordicrf51 <http://docs.platformio.org/en/latest/platforms/nordicnrf51.html>`__
+  development platform
+  (`issue #316 <https://github.com/platformio/platformio/issues/316>`_)
+* Fixed installation on Mac OS X El Capitan
+  (`issue #312 <https://github.com/platformio/platformio/issues/312>`_)
+* Fixed project generator for CLion IDE under Windows OS with invalid path to
+  executable
+  (`issue #326 <https://github.com/platformio/platformio/issues/326>`_)
+* Fixed empty list with serial ports on Mac OS X
+  (`isge #294 <https://github.com/platformio/platformio/issues/294>`_)
+* Fixed compilation error ``TWI_Disable not declared`` for Arduino Due board
+  (`issue #329 <https://github.com/platformio/platformio/issues/329>`_)
+
+2.3.4 (2015-10-13)
+~~~~~~~~~~~~~~~~~~
+
+* Full support of `CLion IDE <http://docs.platformio.org/en/latest/ide/clion.html>`_
+  including code auto-completion
+  (`issue #132 <https://github.com/platformio/platformio/issues/132>`_)
+* PlatformIO `command completion in Terminal <http://docs.platformio.org/en/latest/faq.html#command-completion-in-terminal>`_ for ``bash`` and ``zsh``
+* Added support for ubIQio Ardhat board
+  (`pull #302 <https://github.com/platformio/platformio/pull/302>`_)
+* Install SCons automatically and avoid ``error: option --single-version-externally-managed not recognized``
+  (`issue #279 <https://github.com/platformio/platformio/issues/279>`_)
+* Use Teensy CLI Loader for upload of .hex files on Mac OS X
+  (`issue #306 <https://github.com/platformio/platformio/issues/306>`_)
+* Fixed missing `framework-mbed <http://docs.platformio.org/en/latest/frameworks/mbed.html>`_
+  package for `teensy <http://docs.platformio.org/en/latest/platforms/teensy.html>`_
+  platform
+  (`issue #305 <https://github.com/platformio/platformio/issues/305>`_)
+
 2.3.3 (2015-10-02)
 ~~~~~~~~~~~~~~~~~~

--- a/187
+++ b/187
@@ -1,21 +1,174 @@
-The MIT License (MIT)
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/

-Copyright (c) 2014-2015 Ivan Kravets
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+1. Definitions.

-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.

-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the
+direction or management of such entity, whether by contract or
+otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation
+source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form, including but
+not limited to compiled object code, generated documentation,
+and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or
+Object form, made available under the License, as indicated by a
+copyright notice that is included in or attached to the work
+(an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object
+form, that is based on (or derived from) the Work and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship. For the purposes
+of this License, Derivative Works shall not include works that remain
+separable from, or merely link (or bind by name) to the interfaces of,
+the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including
+the original version of the Work and any modifications or additions
+to that Work or Derivative Works thereof, that is intentionally
+submitted to Licensor for inclusion in the Work by the copyright owner
+or by an individual or Legal Entity authorized to submit on behalf of
+the copyright owner. For the purposes of this definition, "submitted"
+means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems,
+and issue tracking systems that are managed by, or on behalf of, the
+Licensor for the purpose of discussing and improving the Work, but
+excluding communication that is conspicuously marked or otherwise
+designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor and
+subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the
+Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except as stated in this section) patent license to make, have made,
+use, offer to sell, sell, import, and otherwise transfer the Work,
+where such license applies only to those patent claims licensable
+by such Contributor that are necessarily infringed by their
+Contribution(s) alone or by combination of their Contribution(s)
+with the Work to which such Contribution(s) was submitted. If You
+institute patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Work
+or a Contribution incorporated within the Work constitutes direct
+or contributory patent infringement, then any patent licenses
+granted to You under this License for that Work shall terminate
+as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+Work or Derivative Works thereof in any medium, with or without
+modifications, and in Source or Object form, provided that You
+meet the following conditions:
+
+(a) You must give any other recipients of the Work or
+  Derivative Works a copy of this License; and
+
+(b) You must cause any modified files to carry prominent notices
+  stating that You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works
+  that You distribute, all copyright, patent, trademark, and
+  attribution notices from the Source form of the Work,
+  excluding those notices that do not pertain to any part of
+  the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its
+  distribution, then any Derivative Works that You distribute must
+  include a readable copy of the attribution notices contained
+  within such NOTICE file, excluding those notices that do not
+  pertain to any part of the Derivative Works, in at least one
+  of the following places: within a NOTICE text file distributed
+  as part of the Derivative Works; within the Source form or
+  documentation, if provided along with the Derivative Works; or,
+  within a display generated by the Derivative Works, if and
+  wherever such third-party notices normally appear. The contents
+  of the NOTICE file are for informational purposes only and
+  do not modify the License. You may add Your own attribution
+  notices within Derivative Works that You distribute, alongside
+  or as an addendum to the NOTICE text from the Work, provided
+  that such additional attribution notices cannot be construed
+  as modifying the License.
+
+You may add Your own copyright statement to Your modifications and
+may provide additional or different license terms and conditions
+for use, reproduction, or distribution of Your modifications, or
+for any such Derivative Works as a whole, provided Your use,
+reproduction, and distribution of the Work otherwise complies with
+the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+any Contribution intentionally submitted for inclusion in the Work
+by You to the Licensor shall be under the terms and conditions of
+this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify
+the terms of any separate license agreement you may have executed
+with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+names, trademarks, service marks, or product names of the Licensor,
+except as required for reasonable and customary use in describing the
+origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+agreed to in writing, Licensor provides the Work (and each
+Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any
+risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+whether in tort (including negligence), contract, or otherwise,
+unless required by applicable law (such as deliberate and grossly
+negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special,
+incidental, or consequential damages of any character arising as a
+result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all
+other commercial damages or losses), even if such Contributor
+has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+the Work or Derivative Works thereof, You may choose to offer,
+and charge a fee for, acceptance of support, warranty, indemnity,
+or other liability obligations and/or rights consistent with this
+License. However, in accepting such obligations, You may act only
+on Your own behalf and on Your sole responsibility, not on behalf
+of any other Contributor, and only if You agree to indemnify,
+defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason
+of your accepting any such warranty or additional liability.
--- a/README.rst
+++ b/README.rst
@@ -31,19 +31,31 @@ PlatformIO

 `Home & Demo <http://platformio.org>`_ |
 `Project Examples <https://github.com/platformio/platformio/tree/develop/examples>`_ |
-`Code <https://github.com/platformio/platformio>`_ |
-`Documentation <http://docs.platformio.org>`_ ||
+`Source Code <https://github.com/platformio>`_ |
+`Documentation <http://docs.platformio.org>`_ |
 `Blog <http://www.ikravets.com/category/computer-life/platformio>`_ |
-`Reddit <http://www.reddit.com/r/platformio/>`_ |
+`Twitter <https://twitter.com/PlatformIO_Org>`_ |
+`Hackaday <https://hackaday.io/project/7980-platformio>`_ |
 `Facebook <https://www.facebook.com/platformio>`_ |
-`Twitter <https://twitter.com/PlatformIO_Org>`_
+`Reddit <http://www.reddit.com/r/platformio/>`_

 .. image:: https://raw.githubusercontent.com/platformio/platformio/develop/docs/_static/platformio-logo.png
    :target: http://platformio.org

-`PlatformIO <http://platformio.org>`_ is a cross-platform code builder
-and the missing library manager (Ready for embedded development, IDE and
-Continuous integration, Arduino and MBED compatible).
+`PlatformIO <http://platformio.org>`_ is an open source ecosystem for IoT
+development. Cross-platform code builder and library manager. Continuous and
+IDE integration. Arduino and MBED compatible. Ready for Cloud compiling.
+
+* **Development Platforms** - Embedded and Desktop development platforms with
+  pre-built toolchains, debuggers, uploaders and frameworks which work under
+  popular host OS: Mac, Windows, Linux (+ARM)
+* **Embedded Boards** - Rapid Embedded Programming, IDE and Continuous
+  Integration in a few steps with PlatformIO thanks to built-in project
+  generator for the most popular embedded boards and IDE
+* **Library Manager** - Hundreds Popular Libraries are organized into single
+  Web 2.0 platform: list by categories, keywords, authors, compatible
+  platforms and frameworks; learn via examples; be up-to-date with the latest
+  version

 *Atmel AVR & SAM, Espressif, Freescale Kinetis, Nordic nRF51, NXP LPC,
 Silicon Labs EFM32, ST STM32, TI MSP430 & Tiva, Teensy, Arduino, mbed,
@@ -65,15 +77,10 @@ libOpenCM3, etc.*
 * `FAQ <http://docs.platformio.org/en/latest/faq.html>`_
 * `Release History <http://docs.platformio.org/en/latest/history.html>`_

-You have **no need** to install any *IDE* or compile any tool chains. *PlatformIO*
-has pre-built different development platforms and pre-configured settings for
-the most popular embedded boards. For further details, please
-refer to `What is PlatformIO? <http://docs.platformio.org/en/latest/faq.html#what-is-platformio>`_
-
 Use whenever. *Run everywhere.*
 -------------------------------
 *PlatformIO* is written in pure *Python* and **doesn't depend** on any
-additional libraries/tools from an operation system. It allows you to use
+additional libraries/tools from an operating system. It allows you to use
 *PlatformIO* beginning from *PC (Mac, Linux, Win)* and ending with credit-card
 sized computers (`Raspberry Pi <http://www.raspberrypi.org>`_,
 `BeagleBone <http://beagleboard.org>`_,
@@ -87,7 +94,7 @@ settings for most popular `Embedded Boards <http://platformio.org/#!/boards>`_.
 * Colourful `command-line output <https://raw.githubusercontent.com/platformio/platformio/develop/examples/platformio-examples.png>`_
 * `IDE Integration <http://docs.platformio.org/en/latest/ide.html>`_ with
  *Arduino, Eclipse, Energia, Qt Creator, Sublime Text, Vim, Visual Studio*
-* `Continuous Integration <http://docs.platformio.org/en/latest/ci/index.html>`_
+* Cloud compiling and `Continuous Integration <http://docs.platformio.org/en/latest/ci/index.html>`_
  with *AppVeyor, Circle CI, Drone, Shippable, Travis CI*
 * Built-in `Serial Port Monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_ and configurable
  `build -flags/-options <http://docs.platformio.org/en/latest/projectconf.html#build-flags>`_
@@ -133,8 +140,8 @@ cross-platform substitute for the classic *Make* utility.

 Single source code. *Multiple platforms.*
 -----------------------------------------
-*PlatformIO* allows developer to compile the same code with different
-development platforms using the *Only One Command*
+*PlatformIO* allows the developer to compile the same code with different
+development platforms using only *One Command*
 `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`_.
 This happens due to
 `Project Configuration File (platformio.ini) <http://docs.platformio.org/en/latest/projectconf.html>`_
@@ -165,10 +172,12 @@ Frameworks:
 * `SPL <http://platformio.org/#!/frameworks/spl>`_
 * `mbed <http://platformio.org/#!/frameworks/mbed>`_

+For further details, please refer to `What is PlatformIO? <http://docs.platformio.org/en/latest/faq.html#what-is-platformio>`_

 Licence
 -------

-Copyright (C) 2014-2015 Ivan Kravets
+Copyright 2014-2015 Ivan Kravets <me@ikravets.com>

-Licenced under the MIT Licence.
+The PlatformIO is licensed under the permissive Apache 2.0 licence,
+so you can use it in both commercial and personal projects with confidence.
--- a/circle.yml
+++ b/circle.yml
@@ -1,15 +1,11 @@
 machine:
    python:
        version: 2.7
-    environment:
-        TOX_ENV: docs
-        TOX_ENV: lint
-        TOX_ENV: py26
-        TOX_ENV: py27

 checkout:
    post:
        - git submodule update --init
+        - pip install -U pip setuptools virtualenv

 dependencies:
    pre:
@@ -17,4 +13,4 @@ dependencies:

 test:
    override:
-        - tox -e $TOX_ENV
+        - tox -e py27
--- a/docs/_static/extra.css
+++ b/docs/_static/extra.css
@@ -0,0 +1,254 @@
+/**
+ * Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+header,
+nav {
+  display: block;
+}
+
+#pionav {
+  display: none;
+}
+
+.container {
+  padding-right: 15px;
+  padding-left: 15px;
+  margin-right: auto;
+  margin-left: auto;
+}
+@media (min-width: 768px) {
+  #pionav {
+    display: block !important;
+  }
+  body {
+    padding-top: 50px;
+  }
+  .wy-nav-side {
+    top: 50px;
+  }
+  .container {
+    width: 750px;
+  }
+}
+@media (min-width: 992px) {
+  .container {
+    width: 970px;
+  }
+}
+@media (min-width: 1200px) {
+  .container {
+    width: 1170px;
+  }
+}
+.container-fluid {
+  padding-right: 15px;
+  padding-left: 15px;
+  margin-right: auto;
+  margin-left: auto;
+}
+
+.container:before,
+.container:after,
+.container-fluid:before,
+.container-fluid:after,
+.nav:before,
+.nav:after,
+.navbar:before,
+.navbar:after,
+.navbar-header:before,
+.navbar-header:after {
+  display: table;
+  content: " ";
+}
+.container:after,
+.container-fluid:after,
+.nav:after,
+.navbar:after,
+.navbar-header:after {
+  clear: both;
+}
+
+.nav {
+  padding-left: 0;
+  margin-bottom: 0;
+  list-style: none;
+}
+.nav > li {
+  position: relative;
+  display: block;
+}
+.nav > li > a {
+  position: relative;
+  display: block;
+  padding: 10px 15px;
+}
+.nav > li > a:hover,
+.nav > li > a:focus {
+  text-decoration: none;
+  background-color: #eee;
+}
+.nav > li > a > img {
+  max-width: none;
+}
+
+.navbar {
+  position: relative;
+  min-height: 50px;
+  margin-bottom: 20px;
+  border: 1px solid transparent;
+}
+@media (min-width: 768px) {
+  .navbar {
+    border-radius: 4px;
+  }
+}
+@media (min-width: 768px) {
+  .navbar-header {
+    float: left;
+  }
+}
+
+@media (min-width: 768px) {
+  .navbar-fixed-top {
+    padding-right: 0;
+    padding-left: 0;
+  }
+}
+.navbar-fixed-top {
+  max-height: 340px;
+}
+.container > .navbar-header,
+.container-fluid > .navbar-header {
+  margin-right: -15px;
+  margin-left: -15px;
+}
+@media (min-width: 768px) {
+  .container > .navbar-header,
+  .container-fluid > .navbar-header {
+    margin-right: 0;
+    margin-left: 0;
+  }
+}
+
+.navbar-fixed-top {
+  position: fixed;
+  right: 0;
+  left: 0;
+  z-index: 1030;
+}
+@media (min-width: 768px) {
+  .navbar-fixed-top {
+    border-radius: 0;
+  }
+}
+.navbar-fixed-top {
+  top: 0;
+  border-width: 0 0 1px;
+}
+.navbar-fixed-bottom {
+  bottom: 0;
+  margin-bottom: 0;
+  border-width: 1px 0 0;
+}
+.navbar-brand {
+  float: left;
+  height: 50px;
+  padding: 15px 15px;
+  font-size: 18px;
+  line-height: 20px;
+}
+.navbar-brand:hover,
+.navbar-brand:focus {
+  text-decoration: none;
+}
+.navbar-brand > img {
+  display: block;
+}
+@media (min-width: 768px) {
+  .navbar > .container .navbar-brand,
+  .navbar > .container-fluid .navbar-brand {
+    margin-left: -15px;
+  }
+}
+
+.navbar-nav {
+  margin: 7.5px -15px;
+}
+.navbar-nav > li > a {
+  padding-top: 10px;
+  padding-bottom: 10px;
+  line-height: 20px;
+}
+@media (min-width: 768px) {
+  .navbar-nav {
+    float: left;
+    margin: 0;
+  }
+  .navbar-nav > li {
+    float: left;
+  }
+  .navbar-nav > li > a {
+    padding-top: 15px;
+    padding-bottom: 15px;
+  }
+}
+
+@media (min-width: 768px) {
+  .navbar-left {
+    float: left !important;
+  }
+  .navbar-right {
+    float: right !important;
+    margin-right: -15px;
+  }
+  .navbar-right ~ .navbar-right {
+    margin-right: 0;
+  }
+}
+
+.navbar-inverse {
+  background-color: #222;
+  border-color: #080808;
+}
+.navbar-inverse .navbar-brand {
+  color: #9d9d9d;
+}
+.navbar-inverse .navbar-brand:hover,
+.navbar-inverse .navbar-brand:focus {
+  color: #fff;
+  background-color: transparent;
+}
+.navbar-inverse .navbar-text {
+  color: #9d9d9d;
+}
+.navbar-inverse .navbar-nav > li > a {
+  color: #9d9d9d;
+}
+.navbar-inverse .navbar-nav > li > a:hover,
+.navbar-inverse .navbar-nav > li > a:focus {
+  color: #fff;
+  background-color: transparent;
+}
+.navbar-inverse .navbar-nav > .active > a,
+.navbar-inverse .navbar-nav > .active > a:hover,
+.navbar-inverse .navbar-nav > .active > a:focus {
+  color: #fff;
+  background-color: #080808;
+}
+
+.navbar-header .navbar-brand {
+  color: #e0e0e0;
+}
--- a/docs/_static/favicon.ico
+++ b/docs/_static/favicon.ico
--- a/docs/_static/platformio-logo.png
+++ b/docs/_static/platformio-logo.png
--- a/docs/_templates/footer.html
+++ b/docs/_templates/footer.html
@@ -0,0 +1,31 @@
+{% extends "!footer.html" %}
+
+{% block extrafooter %}
+<link rel="stylesheet" href="{{ pathto('_static/extra.css', 1) }}" type="text/css" />
+<header id="pionav" class="navbar navbar-inverse navbar-fixed-top">
+  <div class="container container-fluid">
+    <div class="navbar-header">
+      <a class="navbar-brand" href="http://platformio.org/"></i> PlatformIO</a>
+    </div>
+
+    <nav role="navigation">
+      <div>
+        <ul class="nav navbar-nav">
+          <li><a href="http://platformio.org/#!/get-started"><i class="fa fa-rocket fa-lg"></i> Get Started</a></li>
+          <li><a href="http://platformio.org/#!/platforms"><i class="fa fa-laptop fa-lg"></i> Platforms</a></li>
+          <li><a href="http://platformio.org/#!/frameworks"><i class="fa fa-cogs fa-lg"></i> Frameworks</a></li>
+          <li><a href="http://platformio.org/#!/boards"><i class="fa fa-gamepad fa-lg"></i> Boards</a></li>
+          <li ><a href="http://platformio.org/#!/lib"><i class="fa fa-code fa-lg"></i> Libraries</a></li>
+        </ul>
+
+        <ul class="nav navbar-nav navbar-right">
+          <li><a href="http://platformio.org/#!/who-uses"><i class="fa fa-heart-o fa-lg"></i> Who uses</a></li>
+          <li class="active"><a href="http://docs.platformio.org/"><i class="fa fa-book fa-lg"></i> Docs</a></li>
+        </ul>
+      </div>
+
+    </nav>
+  </div>
+</header>
+{{ super() }}
+{% endblock %}
--- a/docs/articles.rst
+++ b/docs/articles.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _articles:

 Articles about us
@@ -12,13 +23,22 @@ Here are recent articles about PlatformIO:
 2015
 ^^^^

+* Nov 29, 2015 - **Keith Hughes** - `Using PlatformIO for Embedded Projects <http://smartspacestuff.blogspot.com/2015/11/using-platformio-for-embedded-projects.html>`_
+* Nov 22, 2015 - **Michał Seroczyński** - `Using PlatformIO to get started with Arduino in CLion IDE <http://www.ches.pl/using-platformio-get-started-arduino-clion-ide/>`_
+* Nov 09, 2015 - **ÁLvaro García Gómez** - `Programar con Arduino "The good way" (Programming with Arduino "The good way", Spanish) <http://congdegnu.es/2015/11/09/programar-con-arduino-the-good-way/>`_
+* Nov 06, 2015 - **nocd5** - `PlatformIOでmbedをオフラインビルドしSTM32 Nucleoボードでmrubyを使う (Use mruby in the offline build for STM32 Nucleo board with mbed and PlatformIO, Japanese) <http://qiita.com/nocd5/items/d5fda776240f7e7c17eb>`_
+* Oct 18, 2015 - **Nico Coetzee** - `First Arduino I2C Experience with PlatformIO <https://electronicventurer.wordpress.com/2015/10/18/first-arduino-i2c-experience/>`_
+* Oct 01, 2015 - **Mistan** - `Compile and Upload Arduino Sketch with PlatformIO for Raspberry Pi Running Arch Linux <http://tech.memoryimprintstudio.com/code-building-for-arduino-with-platformio-for-raspberry-pi-with-arch-linux/>`_
 * Sep 01, 2015 - **Thomas P. Weldon, Ph.D.** - `Improvised MBED FRDM-K64F Eclipse/PlatformIO Setup and Software Installation <http://thomasweldon.com/tpw/courses/embeddsp/p00pcFrdmK64_eclipsePlatformioSetup.html>`_
+* Aug 08, 2015 - **Josh Glendenning** - `Armstrap Eagle and PlatformIO <http://isobit.io/2015/08/08/armstrap.html>`_
 * Aug 01, 2015 - **Russell Davis** - `PlatformIO on the Raspberry Pi <http://www.russelldavis.org/2015/08/01/platformio-on-the-raspberry-pi/>`_
-* Jul 25, 2015 - **DinoTools** - `Erste Schritte mit PlatformIO (German) <https://www.dinotools.de/2015/07/25/erste-schritte-mit-platformio/>`_
+* Jul 25, 2015 - **DinoTools** - `Erste Schritte mit PlatformIO (Getting Started with PlatformIO, German) <https://www.dinotools.de/2015/07/25/erste-schritte-mit-platformio/>`_
 * Jul 20, 2015 - **Eli Fatsi** - `Arduino Development in Atom Editor <http://viget.com/extend/arduino-development-in-atom-editor>`_
-* Jul 14, 2015 - **ElbinarIO** - `Programar para Arduino y otros microcontroladores desde la linea de comandos (Spanish) <http://elbinario.net/2015/07/14/programar-para-arduino-y-otros-microcontroladores-desde-la-linea-de-comandos/>`_
+* Jul 14, 2015 - **ElbinarIO** - `Programar para Arduino y otros microcontroladores desde la linea de comandos (Program Arguino and other microcontrollers from the command line, Spanish) <http://elbinario.net/2015/07/14/programar-para-arduino-y-otros-microcontroladores-desde-la-linea-de-comandos/>`_
 * Jul 11, 2015 - **TrojanC** - `Learning Arduino GitHub Repository <http://www.trojanc.co.za/2015/07/11/learning-arduino-github-repository/>`_
-* Jun 02, 2015 - **Alejandro Guirao Rodriguez** - `Discovering PlatformIO: The RaspberryPi / Arduino combo kit is a winner option when prototyping an IoT-style project <http://lekum.org/posts/discovering-platformio.html>`_
+* Jul 07, 2015 - **Sho Hashimoto** - `PlatformIOでArduino開発する(Arduino development in PlatformIO, Japanese) <http://shokai.org/blog/archives/10250>`_
+* Jun 02, 2015 - **Alejandro Guirao Rodríguez** - `Discovering PlatformIO: The RaspberryPi / Arduino combo kit is a winner option when prototyping an IoT-style project <http://lekum.org/posts/discovering-platformio/index.html>`_
+* May 17, 2015 - **S.S** - `コマンドラインでArduino開発 : vim + platformio (Arduino development at the command line: VIM + PlatformIO, Japanese) <http://qiita.com/caad1229/items/7b5fb47f034ae6e0baf2>`_
 * May 11, 2015 - **IT Hare** - `From Web Developer to Embedded One: Interview with Ivan Kravets, The Guy Behind PlatformIO. Part II <http://ithare.com/from-web-developer-to-embedded-one-interview-with-ivan-kravets-the-guy-behind-platformio-part-ii/>`_
 * May 4, 2015 - **IT Hare** - `From Web Developer to Embedded One: Interview with Ivan Kravets, The Guy Behind PlatformIO. Part I <http://ithare.com/from-web-development-to-embedded-one-interview-with-ivan-kravets-the-guy-behind-platformio-part-i/>`_
 * April 17, 2015 - **Michael Ball** - `PlatformIO - A Cross-Platform Code Builder and Missing Library Manager <http://arduino-pi.blogspot.com.es/2015/04/platformio-cross-platform-code-builder.html>`_
--- a/docs/ci/appveyor.rst
+++ b/docs/ci/appveyor.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ci_appveyor:

 AppVeyor
@@ -22,6 +33,8 @@ containing the build results (showing success or failure), or by posting a
 message on an IRC channel. It can be configured to build project on a range of
 different :ref:`platforms`.

+.. contents::
+
 Integration
 -----------

--- a/docs/ci/circleci.rst
+++ b/docs/ci/circleci.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ci_circleci:

 Circle CI
@@ -21,52 +32,174 @@ containing the build results (showing success or failure), or by posting a
 message on an IRC channel. It can be configured to build project on a range of
 different :ref:`platforms`.

+.. contents::
+
 Integration
 -----------

-Put ``circle.yml`` to the root directory of the GitHub repository.
+Please make sure to read Circle CI `Getting Started <https://circleci.com/docs/getting-started>`_
+guide first.
+
+.. code-block:: yaml
+
+    dependencies:
+        pre:
+            # Install the latest stable PlatformIO
+            - sudo pip install -U platformio
+
+    test:
+        override:
+            - platformio ci path/to/test/file.c --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+            - platformio ci examples/file.ino --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+            - platformio ci path/to/test/directory --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+
+
+For more details as for PlatformIO build process please look into :ref:`cmd_ci`.
+
+Project as a library
+~~~~~~~~~~~~~~~~~~~~
+
+When project is written as a library (where own examples or testing code use
+it), please use ``--lib="."`` option for :ref:`cmd_ci` command
+
+.. code-block:: yaml
+
+    script:
+        - platformio ci --lib="." --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+
+Library dependecies
+~~~~~~~~~~~~~~~~~~~
+
+There 2 options to test source code with dependent libraries:
+
+Install dependent library using :ref:`librarymanager`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code-block:: yaml
+
+    dependencies:
+        pre:
+            # Install the latest stable PlatformIO
+            - sudo pip install -U platformio
+
+            # OneWire Library with ID=1 http://platformio.org/#!/lib/show/1/OneWire
+            - platformio lib install 1
+
+    test:
+        override:
+            - platformio ci path/to/test/file.c --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+
+Manually download dependent library and include in build process via ``--lib`` option
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code-block:: yaml
+
+    dependencies:
+        pre:
+            # Install the latest stable PlatformIO
+            - sudo pip install -U platformio
+
+            # download library to the temporary directory
+            - wget https://github.com/PaulStoffregen/OneWire/archive/master.zip -O /tmp/onewire_source.zip
+            - unzip /tmp/onewire_source.zip -d /tmp/
+
+    test:
+        override:
+            - platformio ci path/to/test/file.c --lib="/tmp/OneWire-master" --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+
+Custom Build Flags
+~~~~~~~~~~~~~~~~~~
+
+PlatformIO allows to specify own build flags using :envvar:`PLATFORMIO_BUILD_FLAGS` environment

 .. code-block:: yaml

    machine:
        environment:
-            PLATFORMIO_CI_SRC: path/to/source/file.c
-            PLATFORMIO_CI_SRC: path/to/source/file.ino
-            PLATFORMIO_CI_SRC: path/to/source/directory
+            PLATFORMIO_BUILD_FLAGS: -D SPECIFIC_MACROS -I/extra/inc

-    dependencies:
-        pre:
-            - sudo apt-get install python2.7-dev
-            - sudo python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
+
+For the more details, please follow to
+:ref:`available build flags/options <projectconf_build_flags>`.
+
+
+Advanced configuration
+~~~~~~~~~~~~~~~~~~~~~~
+
+PlatformIO allows to configure multiple build environments for the single
+source code using :ref:`projectconf`.
+
+Instead of ``--board`` option, please use :option:`platformio ci --project-conf`
+
+.. code-block:: yaml

    test:
        override:
-            - platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
-
-
-For more details as for PlatformIO build process please look into :ref:`cmd_ci`
-command.
+            - platformio ci path/to/test/file.c --project-conf=/path/to/platoformio.ini

 Examples
 --------

-1. Integration for `USB_Host_Shield_2.0 <https://github.com/felis/USB_Host_Shield_2.0>`_
-   project. The ``circle.yml`` configuration file:
+1. Custom build flags

 .. code-block:: yaml

-    machine:
-        environment:
-            PLATFORMIO_CI_SRC: examples/Bluetooth/PS3SPP/PS3SPP.ino
-            PLATFORMIO_CI_SRC: examples/pl2303/pl2303_gps/pl2303_gps.ino
-
    dependencies:
+        cache_directories:
+            - "~/.platformio"
+
        pre:
-            - sudo apt-get install python2.7-dev
-            - sudo python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
-            - wget https://github.com/xxxajk/spi4teensy3/archive/master.zip -O /tmp/spi4teensy3.zip
-            - unzip /tmp/spi4teensy3.zip -d /tmp
+            - sudo pip install -U platformio
+
+            # pre-install PlatformIO development platforms, they will be cached
+            - platformio platforms install atmelavr atmelsam teensy
+
+            #
+            # Libraries from PlatformIO Library Registry:
+            #
+            # http://platformio.org/#!/lib/show/416/TinyGPS
+            # http://platformio.org/#!/lib/show/417/SPI4Teensy3
+            - platformio lib install 416 417

    test:
        override:
-            - platformio ci --lib="." --lib="/tmp/spi4teensy3-master" --board=uno --board=teensy31 --board=due
+            - platformio ci examples/acm/acm_terminal --board=uno --board=teensy31 --board=due --lib="."
+            - platformio ci examples/adk/adk_barcode --board=uno --board=teensy31 --board=due --lib="."
+            - platformio ci examples/adk/ArduinoBlinkLED --board=uno --board=teensy31 --board=due --lib="."
+            - platformio ci examples/adk/demokit_20 --board=uno --board=teensy31 --board=due --lib="."
+            # ...
+            - platformio ci examples/Xbox/XBOXUSB --board=uno --board=teensy31 --board=due --lib="."
+
+* Configuration file: https://github.com/ivankravets/USB_Host_Shield_2.0/blob/master/circle.yml
+* Build History: https://circleci.com/gh/ivankravets/USB_Host_Shield_2.0/tree/master
+
+2. Dependency on external libraries
+
+.. code-block:: yaml
+
+    dependencies:
+        pre:
+            # Install the latest stable PlatformIO
+            - sudo pip install -U platformio
+
+            # download dependent libraries
+            - wget https://github.com/jcw/jeelib/archive/master.zip -O /tmp/jeelib.zip
+            - unzip /tmp/jeelib.zip -d /tmp
+
+            - wget https://github.com/Rodot/Gamebuino/archive/master.zip  -O /tmp/gamebuino.zip
+            - unzip /tmp/gamebuino.zip -d /tmp
+
+    test:
+        override:
+            -  platformio ci examples/backSoon/backSoon.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
+            -  platformio ci examples/etherNode/etherNode.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
+            -  platformio ci examples/getDHCPandDNS/getDHCPandDNS.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
+            -  platformio ci examples/getStaticIP/getStaticIP.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
+            # ...
+            -  platformio ci examples/twitter/twitter.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
+            -  platformio ci examples/udpClientSendOnly/udpClientSendOnly.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
+            -  platformio ci examples/udpListener/udpListener.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
+            -  platformio ci examples/webClient/webClient.ino --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
+
+* Configuration file: hhttps://github.com/ivankravets/ethercard/blob/master/circle.yaml
+* Build History: https://circleci.com/gh/ivankravets/ethercard/tree/master
--- a/docs/ci/drone.rst
+++ b/docs/ci/drone.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ci_drone:

 Drone
@@ -20,6 +31,8 @@ the way it has been configured to do so — for example, by sending an email
 containing the build results (showing success or failure). It can be
 configured to build project on a range of different :ref:`platforms`.

+.. contents::
+
 Integration
 -----------

--- a/docs/ci/index.rst
+++ b/docs/ci/index.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ci:

 Continuous Integration
--- a/docs/ci/shippable.rst
+++ b/docs/ci/shippable.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ci_shippable:

 Shippable
@@ -24,6 +35,8 @@ containing the build results (showing success or failure), or by posting a
 message on an IRC channel. It can be configured to build project on a range of
 different :ref:`platforms`.

+.. contents::
+
 Integration
 -----------

--- a/docs/ci/travis.rst
+++ b/docs/ci/travis.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ci_travis:

 Travis CI
@@ -21,10 +32,17 @@ containing the build results (showing success or failure), or by posting a
 message on an IRC channel. It can be configured to build project on a range of
 different :ref:`platforms`.

+.. contents::
+
 Integration
 -----------

-Please put ``.travis.yml`` to the root directory of the GitHub repository.
+Please make sure to read Travis CI `Getting Started <http://docs.travis-ci.com/user/getting-started/>`_
+and `general build configuration <http://docs.travis-ci.com/user/customizing-the-build/>`_
+guides first.
+
+PlatformIO is written in Python and is recommended to be run within
+`Travis CI Python isolated environment <http://docs.travis-ci.com/user/languages/python/#Travis-CI-Uses-Isolated-virtualenvs>`_:

 .. code-block:: yaml

@@ -32,28 +50,111 @@ Please put ``.travis.yml`` to the root directory of the GitHub repository.
    python:
        - "2.7"

+    # Cache PlatformIO packages using Travis CI container-based infrastructure
+    sudo: false
+    cache:
+        directories:
+            - "~/.platformio"
+
    env:
-        - PLATFORMIO_CI_SRC=path/to/source/file.c
-        - PLATFORMIO_CI_SRC=path/to/source/file.ino
-        - PLATFORMIO_CI_SRC=path/to/source/directory
+        - PLATFORMIO_CI_SRC=path/to/test/file.c
+        - PLATFORMIO_CI_SRC=examples/file.ino
+        - PLATFORMIO_CI_SRC=path/to/test/directory

    install:
-        - python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
+        - pip install -U platformio

    script:
        - platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N

+Then perform steps 1, 2 and 4 from http://docs.travis-ci.com/user/getting-started/

-Then see step 1, 2, and step 4 here: http://docs.travis-ci.com/user/getting-started/
+For more details as for PlatformIO build process please look into :ref:`cmd_ci`.

-For more details as for PlatformIO build process please look into :ref:`cmd_ci`
-command.
+Project as a library
+~~~~~~~~~~~~~~~~~~~~
+
+When project is written as a library (where own examples or testing code use
+it), please use ``--lib="."`` option for :ref:`cmd_ci` command
+
+.. code-block:: yaml
+
+    script:
+        - platformio ci --lib="." --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+
+Library dependecies
+~~~~~~~~~~~~~~~~~~~
+
+There 2 options to test source code with dependent libraries:
+
+Install dependent library using :ref:`librarymanager`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code-block:: yaml
+
+    install:
+        - pip install -U platformio
+
+        #
+        # Libraries from PlatformIO Library Registry:
+        #
+        # http://platformio.org/#!/lib/show/1/OneWire
+        platformio lib install 1
+
+Manually download dependent library and include in build process via ``--lib`` option
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code-block:: yaml
+
+    install:
+        - pip install -U platformio
+
+        # download library to the temporary directory
+        wget https://github.com/PaulStoffregen/OneWire/archive/master.zip -O /tmp/onewire_source.zip
+        unzip /tmp/onewire_source.zip -d /tmp/
+
+    script:
+        - platformio ci --lib="/tmp/OneWire-master" --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
+
+Custom Build Flags
+~~~~~~~~~~~~~~~~~~
+
+PlatformIO allows to specify own build flags using :envvar:`PLATFORMIO_BUILD_FLAGS` environment
+
+.. code-block:: yaml
+
+    env:
+        - PLATFORMIO_CI_SRC=path/to/test/file.c PLATFORMIO_BUILD_FLAGS="-D SPECIFIC_MACROS_PER_TEST_ENV -I/extra/inc"
+        - PLATFORMIO_CI_SRC=examples/file.ino
+        - PLATFORMIO_CI_SRC=path/to/test/directory
+
+    install:
+        - pip install -U platformio
+
+        export PLATFORMIO_BUILD_FLAGS=-D GLOBAL_MACROS_FOR_ALL_TEST_ENV
+
+
+For the more details, please follow to
+:ref:`available build flags/options <projectconf_build_flags>`.
+
+
+Advanced configuration
+~~~~~~~~~~~~~~~~~~~~~~
+
+PlatformIO allows to configure multiple build environments for the single
+source code using :ref:`projectconf`.
+
+Instead of ``--board`` option, please use :option:`platformio ci --project-conf`
+
+.. code-block:: yaml
+
+    script:
+        - platformio ci --project-conf=/path/to/platoformio.ini

 Examples
 --------

-1. Integration for `USB_Host_Shield_2.0 <https://github.com/felis/USB_Host_Shield_2.0>`_
-   project. The ``.travis.yml`` configuration file:
+1. Custom build flags

 .. code-block:: yaml

@@ -61,6 +162,12 @@ Examples
    python:
        - "2.7"

+    # Cache PlatformIO packages using Travis CI container-based infrastructure
+    sudo: false
+    cache:
+        directories:
+            - "~/.platformio"
+
    env:
        - PLATFORMIO_CI_SRC=examples/acm/acm_terminal
        - PLATFORMIO_CI_SRC=examples/Bluetooth/WiiIRCamera PLATFORMIO_BUILD_FLAGS="-DWIICAMERA"
@@ -69,9 +176,11 @@ Examples
        # - ...

    install:
-        - python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
+        - pip install -U platformio

-        # Libraries from PlatformIO Library Registry
+        #
+        # Libraries from PlatformIO Library Registry:
+        #
        # http://platformio.org/#!/lib/show/416/TinyGPS
        # http://platformio.org/#!/lib/show/417/SPI4Teensy3
        - platformio lib install 416 417
@@ -81,3 +190,74 @@ Examples

 * Configuration file: https://github.com/felis/USB_Host_Shield_2.0/blob/master/.travis.yml
 * Build History: https://travis-ci.org/felis/USB_Host_Shield_2.0
+
+2. Dependency on external libraries
+
+.. code-block:: yaml
+
+    language: python
+    python:
+        - "2.7"
+
+    # Cache PlatformIO packages using Travis CI container-based infrastructure
+    sudo: false
+    cache:
+        directories:
+            - "~/.platformio"
+
+    env:
+        - PLATFORMIO_CI_SRC=examples/backSoon/backSoon.ino
+        - PLATFORMIO_CI_SRC=examples/etherNode/etherNode.ino
+        # -
+
+    install:
+        - pip install -U platformio
+
+        - wget https://github.com/jcw/jeelib/archive/master.zip -O /tmp/jeelib.zip
+        - unzip /tmp/jeelib.zip -d /tmp
+
+        - wget https://github.com/Rodot/Gamebuino/archive/master.zip  -O /tmp/gamebuino.zip
+        - unzip /tmp/gamebuino.zip -d /tmp
+
+    script:
+        - platformio ci --lib="." --lib="/tmp/jeelib-master" --lib="/tmp/Gamebuino-master/libraries/tinyFAT" --board=uno --board=megaatmega2560
+
+* Configuration file: https://github.com/jcw/ethercard/blob/master/.travis.yml
+* Build History: https://travis-ci.org/jcw/ethercard
+
+3. Dynamic testing of the boards
+
+.. code-block:: yaml
+
+    language: python
+    python:
+        - "2.7"
+
+    # Cache PlatformIO packages using Travis CI container-based infrastructure
+    sudo: false
+    cache:
+        directories:
+            - "~/.platformio"
+
+    env:
+        - PLATFORMIO_CI_SRC=examples/TimeArduinoDue PLATFORMIO_CI_BOARDS_ARGS="--board=due"
+        - PLATFORMIO_CI_SRC=examples/TimeGPS
+        - PLATFORMIO_CI_SRC=examples/TimeNTP
+        - PLATFORMIO_CI_SRC=examples/TimeTeensy3 PLATFORMIO_CI_BOARDS_ARGS="--board=teensy31"
+        # - ...
+
+    install:
+        - pip install -U platformio
+        - rm -rf ./linux
+
+        #
+        # Libraries from PlatformIO Library Registry:
+        #
+        # http://platformio.org/#!/lib/show/416/TinyGPS
+        - platformio lib install 416 421 422
+
+    script:
+        - if [[ $PLATFORMIO_CI_BOARDS_ARGS ]]; then bash -c 'platformio ci --lib="." $PLATFORMIO_CI_BOARDS_ARGS'; else bash -c 'platformio ci --lib="." --board=uno --board=teensy20pp'; fi
+
+* Configuration file: https://github.com/ivankravets/Time/blob/master/.travis.yml
+* Build History: https://travis-ci.org/ivankravets/Time
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -119,12 +119,12 @@ html_theme = 'default'

 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-#html_logo = None
+#html_logo = '_static/platformio-logo.png'

 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
 # pixels large.
-#html_favicon = None
+html_favicon = '_static/favicon.ico'

 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
@@ -184,22 +184,22 @@ htmlhelp_basename = 'PlatformIOdoc'
 # -- Options for LaTeX output ---------------------------------------------

 latex_elements = {
-# The paper size ('letterpaper' or 'a4paper').
-#'papersize': 'letterpaper',
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',

-# The font size ('10pt', '11pt' or '12pt').
-#'pointsize': '10pt',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',

-# Additional stuff for the LaTeX preamble.
-#'preamble': '',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
 }

 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
-  ('index', 'PlatformIO.tex', u'PlatformIO Documentation',
-   u'Ivan Kravets', 'manual'),
+    ('index', 'PlatformIO.tex', u'PlatformIO Documentation',
+     u'Ivan Kravets', 'manual'),
 ]

 # The name of an image file (relative to this directory) to place at the top of
@@ -242,9 +242,9 @@ man_pages = [
 # (source start file, target name, title, author,
 #  dir menu entry, description, category)
 texinfo_documents = [
-  ('index', 'PlatformIO', u'PlatformIO Documentation',
-   u'Ivan Kravets', 'PlatformIO', 'One line description of project.',
-   'Miscellaneous'),
+    ('index', 'PlatformIO', u'PlatformIO Documentation',
+     u'Ivan Kravets', 'PlatformIO', 'One line description of project.',
+     'Miscellaneous'),
 ]

 # Documents to append as an appendix to all manuals.
--- a/docs/demo.rst
+++ b/docs/demo.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _demo:

 Demo
--- a/docs/envvars.rst
+++ b/docs/envvars.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _envvars:

 Environment variables
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _faq:

 Frequently Asked Questions
@@ -13,8 +24,8 @@ General
 What is PlatformIO?
 ~~~~~~~~~~~~~~~~~~~

-`PlatformIO <http://platformio.org>`_ is a cross-platform code builder
-and the missing library manager.
+`PlatformIO <http://platformio.org>`_ is an open source ecosystem for IoT
+development.

 PlatformIO is independent from the platform, in which it is running. In fact,
 the only requirement is Python, which exists pretty much everywhere. What this
@@ -24,13 +35,14 @@ between team members, regardless of operating system they prefer to work with.
 Beyond that, PlatformIO can be run not only on commonly used desktops/laptops
 but also on the servers without X Window System. While PlatformIO itself is a
 console application, it can be used in combination with one's favorite
-:ref:`ide` or text editor such as :ref:`ide_arduino`, :ref:`ide_eclipse`,
-:ref:`ide_visualstudio`, :ref:`ide_vim`,  :ref:`ide_sublimetext`, etc.
+:ref:`ide` or text editor such as :ref:`ide_arduino`, :ref:`ide_atom`,
+:ref:`ide_clion`, :ref:`ide_eclipse`, :ref:`ide_qtcreator`,
+:ref:`ide_sublimetext`, :ref:`ide_vim`, :ref:`ide_visualstudio`, etc.

 Alright, so PlatformIO can run on different operating systems. But more
 importantly, from development perspective at least, is a list of supported
-boards and MCUs. To keep things short: PlatformIO supports over 100
-:ref:`Embedded Boards <platforms>` and all major
+boards and MCUs. To keep things short: PlatformIO supports over 150+
+`Embedded Boards <http://platformio.org/#!/boards>`_ and all major
 :ref:`Development Platforms <platforms>`.

 PlatformIO allows users to:
@@ -55,6 +67,34 @@ the project developed using PlatformIO is as follows:
 * Users develop code and PlatformIO makes sure that it is compiled, prepared
  and uploaded to all the boards of interest.

+Command completion in Terminal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Bash completion
+'''''''''''''''
+
+Bash completion support will complete subcommands and parameters. To enable
+Bash completion for `platformio` subcommands you need to put into your `.bashrc`:
+
+.. code-block:: bash
+
+    eval "$(_PLATFORMIO_COMPLETE=source platformio)"
+
+ZSH completion
+''''''''''''''
+
+To enable ``zsh`` completion please run these commands:
+
+.. code-block:: bash
+
+    autoload bashcompinit && bashcompinit
+    eval "$(_PLATFORMIO_COMPLETE=source platformio)"
+
+.. note::
+
+    For permanent command completion you need to place commands above to
+    ``~/.bashrc`` or ``~/.zshrc`` file.
+
 .. _faq_troubleshooting:

 Troubleshooting
@@ -63,8 +103,8 @@ Troubleshooting
 Installation
 ~~~~~~~~~~~~

-PlatformIO and ``scons`` aren't installed properly
-''''''''''''''''''''''''''''''''''''''''''''''''''
+PlatformIO and SCons aren't installed properly
+''''''''''''''''''''''''''''''''''''''''''''''

 Try these solutions:

@@ -75,6 +115,9 @@ Try these solutions:
    [sudo] pip uninstall scons
    [sudo] pip install scons

+    # or if you have "error: option --single-version-externally-managed not recognized"
+    [sudo] pip install --egg scons
+
 2. Install PlatformIO using :ref:`installation_installer_script`.

 .. _faq_troubleshooting_sconssingverextmanaged:
@@ -89,25 +132,15 @@ Answered in `issue #279 <https://github.com/platformio/platformio/issues/279>`_.

 Answered in `issue #295 <https://github.com/platformio/platformio/issues/295#issuecomment-143772005>`_.

-.. _faq_troubleshooting_pioblocksprompt:
+Windows AttributeError: 'module' object has no attribute 'packages'
+'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''

-PlatformIO blocks command execution using user prompt
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If you are going to run *PlatformIO* from **subprocess**, you **MUST
-DISABLE** all prompts. It will allow you to avoid blocking.
-There are a few options:
-
- using :option:`platformio --force` option before each command
- using environment variable :envvar:`PLATFORMIO_SETTING_ENABLE_PROMPTS=No <PLATFORMIO_SETTING_ENABLE_PROMPTS>`
- disable global setting ``enable_prompts`` via :ref:`cmd_settings` command
- masking under Continuous Integration system via environment variable
-  :envvar:`CI=true <CI>`.
+Answered in `issue #252 <https://github.com/platformio/platformio/issues/252#issuecomment-127072039>`_.

 .. _faq_troubleshooting_pionotfoundinpath:

 Program ``platformio`` not found in PATH
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+''''''''''''''''''''''''''''''''''''''''

 Where is ``platformio`` binary installed? Run this command in Terminal

@@ -130,18 +163,12 @@ programs to the ``bin`` directory which is included in ``$PATH``. For example,
 see `issue #272 <https://github.com/platformio/platformio/issues/272#issuecomment-133626112>`_.

 Windows UnicodeDecodeError: 'ascii' codec can't decode byte
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''

 Answered in `issue #143 <https://github.com/platformio/platformio/issues/143#issuecomment-88060906>`_.

-Serial does not work with panStampAVR board
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Answered in `issue #144 <https://github.com/platformio/platformio/issues/144#issuecomment-87388038>`_.
-
-
-PlatformIO: command not found || An error ``pkg_resources.DistributionNotFound``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+PlatformIO: command not found || An error "pkg_resources.DistributionNotFound"
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''

 Please upgrade *SetupTools* package:

@@ -154,18 +181,45 @@ Please upgrade *SetupTools* package:
    [sudo] pip uninstall platformio
    [sudo] pip install platformio

-Windows AttributeError: 'module' object has no attribute 'packages'
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Miscellaneous
+~~~~~~~~~~~~~

-Answered in `issue #252 <https://github.com/platformio/platformio/issues/252#issuecomment-127072039>`_.
+.. _faq_troubleshooting_pioblocksprompt:
+
+PlatformIO blocks command execution using user prompt
+'''''''''''''''''''''''''''''''''''''''''''''''''''''
+
+If you are going to run *PlatformIO* from **subprocess**, you **MUST
+DISABLE** all prompts. It will allow you to avoid blocking.
+There are a few options:
+
+- using :option:`platformio --force` option before each command
+- using environment variable :envvar:`PLATFORMIO_SETTING_ENABLE_PROMPTS=No <PLATFORMIO_SETTING_ENABLE_PROMPTS>`
+- disable global setting ``enable_prompts`` via :ref:`cmd_settings` command
+- masking under Continuous Integration system via environment variable
+  :envvar:`CI=true <CI>`.
+
+Serial does not work with panStampAVR board
+'''''''''''''''''''''''''''''''''''''''''''
+
+Answered in `issue #144 <https://github.com/platformio/platformio/issues/144#issuecomment-87388038>`_.
+
+Building
+~~~~~~~~
+
+Can not compile a library that compiles without issue with Arduino IDE
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+
+* `#298: Unable to use Souliss library <https://github.com/platformio/platformio/issues/298>`_
+* `#331: Unable to use MySensors library <https://github.com/platformio/platformio/issues/331>`_

 ARM toolchain: cc1plus: error while loading shared libraries
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''

 See related answers for
 `error while loading shared libraries <https://github.com/platformio/platformio/issues?utf8=✓&q=error+while+loading+shared+libraries>`_.

 Archlinux: libncurses.so.5: cannot open shared object file
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''

 Answered in `issue #291 <https://github.com/platformio/platformio/issues/291>`_.
--- a/docs/frameworks/arduino.rst
+++ b/docs/frameworks/arduino.rst
@@ -474,7 +474,14 @@ Espressif
      - RAM

    * - ``esp01``
-      - `Espressif ESP8266 board <https://nurdspace.nl/ESP8266>`_
+      - `Espressif ESP8266 ESP-01 board <https://nurdspace.nl/ESP8266>`_
+      - ESP8266
+      - 40 MHz
+      - 512 Kb
+      - 32 Kb
+
+    * - ``esp12e``
+      - `Espressif ESP8266 ESP-12E board (NodeMCU) <https://nurdspace.nl/ESP8266>`_
      - ESP8266
      - 80 MHz
      - 512 Kb
@@ -976,3 +983,23 @@ Wicked Device
      - 16 MHz
      - 128 Kb
      - 16 Kb
+
+ubIQio
+~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``ardhat``
+      - `ubIQio Ardhat <http://ardhat.com>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
--- a/docs/frameworks/index.rst
+++ b/docs/frameworks/index.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _frameworks:

 Frameworks
--- a/docs/frameworks/libopencm3.rst
+++ b/docs/frameworks/libopencm3.rst
@@ -64,6 +64,13 @@ ST
      - 128 Kb
      - 16 Kb

+    * - ``nucleo_f103rb``
+      - `ST Nucleo F103RB <https://developer.mbed.org/platforms/ST-Nucleo-F103RB/>`_
+      - STM32F103RBT6
+      - 72 MHz
+      - 128 Kb
+      - 20 Kb
+
 TI
 ~~

--- a/docs/frameworks/mbed.rst
+++ b/docs/frameworks/mbed.rst
@@ -31,6 +31,9 @@ Platforms
    * - :ref:`platform_ststm32`
      - The STM32 family of 32-bit Flash MCUs based on the ARM Cortex-M processor is designed to offer new degrees of freedom to MCU users. It offers a 32-bit product range that combines very high performance, real-time capabilities, digital signal processing, and low-power, low-voltage operation, while maintaining full integration and ease of development.

+    * - :ref:`platform_teensy`
+      - Teensy is a complete USB-based microcontroller development system, in a very small footprint, capable of implementing many types of projects. All programming is done via the USB port. No special programmer is needed, only a standard "Mini-B" USB cable and a PC or Macintosh with a USB port.
+
 Boards
 ------

--- a/docs/history.rst
+++ b/docs/history.rst
@@ -1 +1,12 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. include:: ../HISTORY.rst
--- a/docs/ide.rst
+++ b/docs/ide.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ide:

 IDE Integration
--- a/docs/ide/arduino.rst
+++ b/docs/ide/arduino.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ide_arduino:

 Arduino
--- a/docs/ide/atom.rst
+++ b/docs/ide/atom.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ide_atom:

 Atom
--- a/docs/ide/clion.rst
+++ b/docs/ide/clion.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ide_clion:

 CLion
@@ -47,11 +58,19 @@ There are 3 predefined targets for building:
 * ``PLATFORMIO_CLEAN`` - clean compiled objects and etc.

 .. warning::
-    CLion is still in the development stage, so some of the features (like,
-    auto-complete) probably will not work with PlatformIO. See
-    `CLion issue #CPP-3977 <https://youtrack.jetbrains.com/issue/CPP-3977>`_.
+    PlatformIO generates empty project by default and **code auto-completion
+    will not work!** To enable auto-completion please choose one of:

-    Active discussion located in
+    * Add source files ``*.c, *.cpp, etc`` to ``src`` directory and re-initialize
+      project with command above
+    * Manually correct ``add_executable`` command in ``CMakeLists.txt`` file
+      (will be created in project directory after initialization).
+
+    ``*.ino`` file isn't acceptable for ``add_executable`` command. You should
+    convert it manually to ``*.cpp``. See `project example <https://github.com/platformio/platformio/tree/develop/examples/ide/clion>`_.
+
+    More info `CLion issue #CPP-3977 <https://youtrack.jetbrains.com/issue/CPP-3977>`_.
+    Active discussion is located in
    `PlatformIO issue #132 <https://github.com/platformio/platformio/issues/132>`_.

 Screenshot
--- a/docs/ide/eclipse.rst
+++ b/docs/ide/eclipse.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ide_eclipse:

 Eclipse
--- a/docs/ide/energia.rst
+++ b/docs/ide/energia.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ide_energia:

 Energia
--- a/docs/ide/qtcreator.rst
+++ b/docs/ide/qtcreator.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ide_qtcreator:

 Qt Creator
--- a/docs/ide/sublimetext.rst
+++ b/docs/ide/sublimetext.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ide_sublimetext:

 Sublime Text
--- a/docs/ide/vim.rst
+++ b/docs/ide/vim.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ide_vim:

 VIM
@@ -45,6 +56,10 @@ Now, in VIM ``cd /path/to/this/project`` and press ``Ctrl+B`` or ``Cmd+B``
 (Mac). *PlatformIO* should compile your source code from the ``src`` directory,
 make firmware and upload it.

+.. note::
+    If hotkey doesn't work for you, try to add this line
+    ``nnoremap <C-b> :make<CR>`` to ``~/.vimrc``
+
 Screenshot
 ----------

--- a/docs/ide/visualstudio.rst
+++ b/docs/ide/visualstudio.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _ide_visualstudio:

 Visual Studio
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,15 +1,34 @@
-PlatformIO is a cross-platform code builder and the missing library manager
-===========================================================================
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.

-**Ready for embedded development, IDE and Continuous integration, Arduino and
-MBED compatible**
+PlatformIO is an open source ecosystem for IoT development
+==========================================================
+
+**Cross-platform code builder and library manager. Continuous and IDE
+integration. Arduino and MBED compatible. Ready for Cloud compiling.**
+
+* **Development Platforms** - Embedded and Desktop development platforms with
+  pre-built toolchains, debuggers, uploaders and frameworks which work under
+  popular host OS: Mac, Windows, Linux (+ARM)
+* **Embedded Boards** - Rapid Embedded Programming, IDE and Continuous
+  Integration in a few steps with PlatformIO thanks to built-in project
+  generator for the most popular embedded boards and IDE
+* **Library Manager** - Hundreds Popular Libraries are organized into single
+  Web 2.0 platform: list by categories, keywords, authors, compatible
+  platforms and frameworks; learn via examples; be up-to-date with the latest
+  version

 *Atmel AVR & SAM, Espressif, Freescale Kinetis, Nordic nRF51, NXP LPC,
 Silicon Labs EFM32, ST STM32, TI MSP430 & Tiva, Teensy, Arduino, mbed,
-libOpenCM3, etc.*
-
-.. image:: _static/platformio-logo.png
-    :target: http://platformio.org
+libOpenCM3, etc.**

 * `Website <http://platformio.org>`_
 * `Web 2.0 Library Search <http://platformio.org/#!/lib>`_ |
@@ -18,14 +37,10 @@ libOpenCM3, etc.*
 * `Source Code <https://github.com/platformio/platformio>`_ |
  `Issues <https://github.com/platformio/platformio/issues>`_
 * `Blog <http://www.ikravets.com/category/computer-life/platformio>`_ |
-  `Reddit <http://www.reddit.com/r/platformio/>`_ |
+  `Twitter <https://twitter.com/PlatformIO_Org>`_ |
+  `Hackaday <https://hackaday.io/project/7980-platformio>`_ |
  `Facebook <https://www.facebook.com/platformio>`_ |
-  `Twitter <https://twitter.com/PlatformIO_Org>`_
-
-You have **no need** to install any *IDE* or compile any tool chains. *PlatformIO*
-has pre-built different development platforms and pre-configured settings for
-the most popular embedded boards. For further details, please
-refer to :ref:`faq_what_is_platformio`
+  `Reddit <http://www.reddit.com/r/platformio/>`_

 Embedded Development. *Easier Than Ever.*
 -----------------------------------------
@@ -33,7 +48,7 @@ Embedded Development. *Easier Than Ever.*
 * Colourful command-line output
 * :ref:`IDE Integration <ide>` with *Arduino, Eclipse, Energia, Qt Creator,
  Sublime Text, Vim, Visual Studio*
-* :ref:`ci` with *AppVeyor, Circle CI, Drone, Shippable, Travis CI*
+* Cloud compiling and  :ref:`ci` with *AppVeyor, Circle CI, Drone, Shippable, Travis CI*
 * Built-in :ref:`Serial Port Monitor <cmd_serialports_monitor>` and
  configurable build :ref:`-flags/-options <projectconf_build_flags>`
 * Pre-built tool chains, :ref:`frameworks` for the
@@ -56,6 +71,7 @@ The Missing Library Manager. *It's here!*
 * Automatic library updating
 * It runs on Windows, Mac OS X, and Linux (+ARM).

+For further details, please refer to :ref:`faq_what_is_platformio`

 Contents
 --------
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _installation:

 Installation
@@ -27,7 +38,7 @@ application (Terminal):
 * Mac OS X / Linux – *Terminal* application
 * Windows – ``cmd.exe`` application.

-Installation options
+Installation Methods
 --------------------

 .. warning::
@@ -36,12 +47,12 @@ Installation options
    **DON'T FORGET** to select ``Add python.exe to Path`` feature on the
    "Customize" stage.

-Please *choose one of* the following installation options:
+Please *choose ONE of* the following methods:

-Python Package Manager
-~~~~~~~~~~~~~~~~~~~~~~
+a) Python Package Manager
+~~~~~~~~~~~~~~~~~~~~~~~~~

-The latest stable version of PlatformIO may be done via
+The latest stable version of PlatformIO may be installed/upgraded via
 `pip <https://pip.pypa.io>`_ as follows:

 .. code-block:: bash
@@ -52,9 +63,6 @@ The latest stable version of PlatformIO may be done via
    # install/upgrade the latest version of PlatformIO
    pip install -U platformio

-.. warning::
-    Known Issue: :ref:`faq_troubleshooting_sconssingverextmanaged`
-
 Note that you may run into permissions issues running these commands. You have
 a few options here:

@@ -66,8 +74,8 @@ a few options here:

 .. _installation_installer_script:

-Installer Script
-~~~~~~~~~~~~~~~~
+b) Installer Script
+~~~~~~~~~~~~~~~~~~~

 Super-Quick (Mac / Linux)
 '''''''''''''''''''''''''
@@ -106,8 +114,8 @@ On *Windows OS* it may look like:
    # run it
    C:\Python27\python.exe get-platformio.py

-Full Guide
-~~~~~~~~~~
+c) Full Guide
+~~~~~~~~~~~~~

 1. Check a ``python`` version (only 2.6-2.7 is supported):

@@ -136,8 +144,8 @@ For upgrading ``platformio`` to the latest version:

    pip install -U platformio

-Development Version
-~~~~~~~~~~~~~~~~~~~
+d) Development Version
+~~~~~~~~~~~~~~~~~~~~~~

 Install the latest PlatformIO from the ``develop`` branch:

--- a/docs/librarymanager/config.rst
+++ b/docs/librarymanager/config.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. |PIOAPICR| replace:: *PlatformIO Library Registry Crawler*
 .. _library_config:

--- a/docs/librarymanager/creating.rst
+++ b/docs/librarymanager/creating.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _library_creating:
 .. |PIOAPICR| replace:: *PlatformIO Library Registry Crawler*

--- a/docs/librarymanager/index.rst
+++ b/docs/librarymanager/index.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _librarymanager:

 Library Manager
--- a/docs/platforms/atmelavr.rst
+++ b/docs/platforms/atmelavr.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_atmelavr:

 Platform ``atmelavr``
@@ -872,3 +883,23 @@ Wicked Device
      - 16 MHz
      - 128 Kb
      - 16 Kb
+
+ubIQio
+~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``ardhat``
+      - `ubIQio Ardhat <http://ardhat.com>`_
+      - ATMEGA328P
+      - 16 MHz
+      - 32 Kb
+      - 2 Kb
--- a/docs/platforms/atmelsam.rst
+++ b/docs/platforms/atmelsam.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_atmelsam:

 Platform ``atmelsam``
--- a/docs/platforms/creating_board.rst
+++ b/docs/platforms/creating_board.rst
@@ -1,7 +1,18 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _board_creating:

-Creating Board
-==============
+Custom Board
+============

 *PlatformIO* has pre-built settings for the most popular embedded boards. This
 list is available:
--- a/docs/platforms/creating_platform.rst
+++ b/docs/platforms/creating_platform.rst
@@ -1,7 +1,18 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_creating:

-Creating Platform
-=================
+Custom Platform
+===============

 *PlatformIO* was developed like a tool which would build the same source code
 for the different development platforms via single command :ref:`cmd_run`
--- a/docs/platforms/espressif.rst
+++ b/docs/platforms/espressif.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_espressif:

 Platform ``espressif``
@@ -75,7 +86,14 @@ Espressif
      - RAM

    * - ``esp01``
-      - `Espressif ESP8266 board <https://nurdspace.nl/ESP8266>`_
+      - `Espressif ESP8266 ESP-01 board <https://nurdspace.nl/ESP8266>`_
+      - ESP8266
+      - 40 MHz
+      - 512 Kb
+      - 32 Kb
+
+    * - ``esp12e``
+      - `Espressif ESP8266 ESP-12E board (NodeMCU) <https://nurdspace.nl/ESP8266>`_
      - ESP8266
      - 80 MHz
      - 512 Kb
--- a/docs/platforms/freescalekinetis.rst
+++ b/docs/platforms/freescalekinetis.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_freescalekinetis:

 Platform ``freescalekinetis``
--- a/docs/platforms/index.rst
+++ b/docs/platforms/index.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platforms:

 Platforms & Embedded Boards
@@ -41,8 +52,8 @@ Desktop
    linux_x86_64
    windows_x86

-Own Platform/Board
------------------
+Custom Platform & Board
+-----------------------

 .. toctree::
    :maxdepth: 2
--- a/docs/platforms/linux_arm.rst
+++ b/docs/platforms/linux_arm.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_linux_arm:

 Platform ``linux_arm``
--- a/docs/platforms/linux_i686.rst
+++ b/docs/platforms/linux_i686.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_linux_i686:

 Platform ``linux_i686``
--- a/docs/platforms/linux_x86_64.rst
+++ b/docs/platforms/linux_x86_64.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_linux_x86_64:

 Platform ``linux_x86_64``
--- a/docs/platforms/native.rst
+++ b/docs/platforms/native.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_native:

 Platform ``native``
--- a/docs/platforms/nordicnrf51.rst
+++ b/docs/platforms/nordicnrf51.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_nordicnrf51:

 Platform ``nordicnrf51``
--- a/docs/platforms/nxplpc.rst
+++ b/docs/platforms/nxplpc.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_nxplpc:

 Platform ``nxplpc``
--- a/docs/platforms/siliconlabsefm32.rst
+++ b/docs/platforms/siliconlabsefm32.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_siliconlabsefm32:

 Platform ``siliconlabsefm32``
--- a/docs/platforms/ststm32.rst
+++ b/docs/platforms/ststm32.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_ststm32:

 Platform ``ststm32``
--- a/docs/platforms/teensy.rst
+++ b/docs/platforms/teensy.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_teensy:

 Platform ``teensy``
@@ -17,21 +28,24 @@ Packages
    * - Name
      - Contents

+    * - ``framework-arduinoteensy``
+      - `Arduino Wiring-based Framework <http://arduino.cc/en/Reference/HomePage>`_
+
+    * - ``tool-teensy``
+      - `Teensy Loader <https://www.pjrc.com/teensy/loader.html>`_
+
+    * - ``toolchain-gccarmnoneeabi``
+      - `gcc-arm-embedded <https://launchpad.net/gcc-arm-embedded>`_, `GDB <http://www.gnu.org/software/gdb/>`_
+
+    * - ``framework-mbed``
+      - `mbed Framework <http://mbed.org>`_
+
    * - ``toolchain-atmelavr``
      - `avr-gcc <https://gcc.gnu.org/wiki/avr-gcc>`_, `GDB <http://www.gnu.org/software/gdb/>`_, `AVaRICE <http://avarice.sourceforge.net/>`_, `SimulAVR <http://www.nongnu.org/simulavr/>`_

    * - ``ldscripts``
      - `Linker Scripts <https://sourceware.org/binutils/docs/ld/Scripts.html>`_

-    * - ``framework-arduinoteensy``
-      - `Arduino Wiring-based Framework <http://arduino.cc/en/Reference/HomePage>`_
-
-    * - ``toolchain-gccarmnoneeabi``
-      - `gcc-arm-embedded <https://launchpad.net/gcc-arm-embedded>`_, `GDB <http://www.gnu.org/software/gdb/>`_
-
-    * - ``tool-teensy``
-      - `Teensy Loader <https://www.pjrc.com/teensy/loader.html>`_
-
 .. warning::
    **Linux Users:** Don't forget to install "udev" rules file
    `99-platformio-udev.rules <https://github.com/platformio/platformio/blob/develop/scripts/99-platformio-udev.rules>`_ (an instruction is located in the file).
@@ -52,6 +66,9 @@ Frameworks
    * - :ref:`framework_arduino`
      - Arduino Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences.

+    * - :ref:`framework_mbed`
+      - The mbed framework The mbed SDK has been designed to provide enough hardware abstraction to be intuitive and concise, yet powerful enough to build complex projects. It is built on the low-level ARM CMSIS APIs, allowing you to code down to the metal if needed. In addition to RTOS, USB and Networking libraries, a cookbook of hundreds of reusable peripheral and module libraries have been built on top of the SDK by the mbed Developer Community.
+
 Boards
 ------

--- a/docs/platforms/timsp430.rst
+++ b/docs/platforms/timsp430.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_timsp430:

 Platform ``timsp430``
--- a/docs/platforms/titiva.rst
+++ b/docs/platforms/titiva.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_titiva:

 Platform ``titiva``
--- a/docs/platforms/windows_x86.rst
+++ b/docs/platforms/windows_x86.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _platform_windows_x86:

 Platform ``windows_x86``
--- a/docs/projectconf.rst
+++ b/docs/projectconf.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _projectconf:

 Project Configuration File ``platformio.ini``
@@ -504,7 +515,9 @@ Examples
    platform = atmelavr
    framework = arduino
    board = pro8MHzatmega328
-    upload_protocol = usbasp -  B5
+    upload_protocol = usbasp -B5
+
+Then upload firmware using :option:`platformio run --target program`


 4. :ref:`platform_ststm32`: Upload firmware using GDB script ``upload.gdb``,
@@ -517,6 +530,8 @@ Examples
    board = armstrap_eagle512
    upload_protocol = gdb

+Also, take a look at this article `Armstrap Eagle and PlatformIO <http://isobit.io/2015/08/08/armstrap.html>`_.
+
 5. :ref:`platform_ststm32`: Upload firmware using ST-Link instead mbed's media
   disk

--- a/docs/quickstart.rst
+++ b/docs/quickstart.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _quickstart:

 Quickstart
@@ -28,7 +39,7 @@ Quickstart

    The next files/directories will be created in ***
    platformio.ini - Project Configuration File. |-> PLEASE EDIT ME <-|
-    src - Put your source code here
+    src - Put your source files here
    lib - Put here project specific (private) libraries
    Do you want to continue? [y/N]: y
    Project has been successfully initialized!
@@ -37,7 +48,7 @@ Quickstart
    `platformio run --target upload` or `platformio run -t upload` - upload firmware to embedded board
    `platformio run --target clean` - clean project (remove compiled files)

-Put your source code ``*.h, *.c, *.cpp or *.ino`` files to ``src`` directory.
+Put your source files ``*.h, *.c, *.cpp or *.ino`` to ``src`` directory.

 4. Process the project's environments.

--- a/docs/userguide/cmd_boards.rst
+++ b/docs/userguide/cmd_boards.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_boards:

 platformio boards
--- a/docs/userguide/cmd_ci.rst
+++ b/docs/userguide/cmd_ci.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_ci:

 platformio ci
--- a/docs/userguide/cmd_init.rst
+++ b/docs/userguide/cmd_init.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_init:

 platformio init
@@ -22,7 +33,7 @@ Initialize new PlatformIO based project.
 This command will create:

 * :ref:`projectconf`
-* ``src`` - a source directory. Put your source code here
+* ``src`` - a source directory. Put your source files here
 * ``lib`` - a directory for the project specific (private) libraries.
  PlatformIO will compile them to static libraries and link to executable file

@@ -94,7 +105,7 @@ Examples

    The next files/directories will be created in ***
    platformio.ini - Project Configuration File. |-> PLEASE EDIT ME <-|
-    src - Put your source code here
+    src - Put your source files here
    lib - Put here project specific (private) libraries
    Do you want to continue? [y/N]: y
    Project has been successfully initialized!
@@ -112,7 +123,7 @@ Examples

    The next files/directories will be created in ***
     platformio.ini - Project Configuration File. |-> PLEASE EDIT ME <-|
-    src - Put your source code here
+    src - Put your source files here
    lib - Put here project specific (private) libraries
    Do you want to continue? [y/N]: y
    Project has been successfully initialized!
@@ -136,7 +147,7 @@ Examples

    The next files/directories will be created in ***
    platformio.ini - Project Configuration File. |-> PLEASE EDIT ME <-|
-    src - Put your source code here
+    src - Put your source files here
    lib - Put here project specific (private) libraries
    Do you want to continue? [y/N]: y
    Project has been successfully initialized!
--- a/docs/userguide/cmd_run.rst
+++ b/docs/userguide/cmd_run.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_run:

 platformio run
@@ -38,8 +49,9 @@ Process specified targets.
 Pre-built targets:

 * ``clean`` delete compiled object files, libraries and firmware/program binaries
-* ``upload`` enable "auto-uploading" for embedded platforms after building
-  operation
+* ``upload`` firmware "auto-uploading" for embedded platforms
+* ``program`` firmware "auto-uploading" for embedded platforms using external
+  programmer (available only for :ref:`platform_atmelavr`)
 * ``uploadlazy`` upload existing firmware without project rebuilding
 * ``envdump`` dump current build environment
 * ``size`` print the size of the sections in a firmware/program
--- a/docs/userguide/cmd_serialports.rst
+++ b/docs/userguide/cmd_serialports.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_serialports:

 platformio serialports
@@ -140,30 +151,41 @@ Set initial ``RTS`` line state, default ``0``
 Set initial ``DTR`` line state, default ``0``

 .. option::
-    --echo
+    --encoding

-Enable local echo, default ``Off``
+Set the encoding for the serial port (e.g. ``hexlify``, ``Latin1``, ``UTF-8``),
+default ``UTF-8``.
+
+**NEW**: Available in Miniterm/PySerial 3.0

 .. option::
-    --cr
+    -f, --filter

-Do not send ``CR+LF``, send ``R`` only, default ``Off``
+Add text transformation. Available filters:
+
+* ``colorize`` Apply different colors for received and echo
+* ``debug`` Print what is sent and received
+* ``default`` Remove typical terminal control codes from input
+* ``direct`` Do-nothing: forward all data unchanged
+* ``nocontrol`` Remove all control codes, incl. CR+LF
+* ``printable`` Show decimal code for all non-ASCII characters and replace
+  most control codes
+
+**NEW**: Available in Miniterm/PySerial 3.0

 .. option::
-    --lf
+    --eol

-Do not send ``CR+LF``, send ``LF`` only, default ``Off``
+End of line mode (``CR``, ``LF`` or ``CRLF``), default ``CRLF``
+
+**NEW**: Available in Miniterm/PySerial 3.0

 .. option::
-    -d, --debug
+    --raw

-Debug received data (escape non-printable chars). ``--debug`` can be given
-multiple times:
+Do not apply any encodings/transformations

-0. just print what is received
-1. escape non-printable characters, do newlines as unusual
-2. escape non-printable characters, newlines too
-3. hex dump everything
+**NEW**: Available in Miniterm/PySerial 3.0

 .. option::
    --exit-char
@@ -182,6 +204,43 @@ default ``0x14``

 Diagnostics: suppress non-error messages, default ``Off``

+
+.. option::
+    --echo
+
+Enable local echo, default ``Off``
+
+**REMOVED**: Is not available in Miniterm/PySerial 3.0
+
+.. option::
+    --cr
+
+Do not send ``CR+LF``, send ``R`` only, default ``Off``
+
+**REMOVED**: Is not available in Miniterm/PySerial 3.0
+
+.. option::
+    --lf
+
+Do not send ``CR+LF``, send ``LF`` only, default ``Off``
+
+**REMOVED**: Is not available in Miniterm/PySerial 3.0
+
+.. option::
+    -d, --debug
+
+Debug received data (escape non-printable chars). ``--debug`` can be given
+multiple times:
+
+0. just print what is received
+1. escape non-printable characters, do newlines as unusual
+2. escape non-printable characters, newlines too
+3. hex dump everything
+
+**REMOVED**: Is not available in Miniterm/PySerial 3.0.
+See :option:`platformio serialports monitor --encoding` and
+:option:`platformio serialports monitor --filter` options.
+
 Examples
 ~~~~~~~~

@@ -201,21 +260,17 @@ Examples
      --rts [0|1]           Set initial RTS line state, default=0
      --dtr [0|1]           Set initial DTR line state, default=0
      --echo                Enable local echo, default=Off
-      --cr                  Do not send CR+LF, send CR only, default=Off
-      --lf                  Do not send CR+LF, send LF only, default=Off
-      -d, --debug           Debug received data (escape non-printable chars)
-                            --debug can be given multiple times:
-                            0: just print what is received
-                            1: escape non-printable characters, do newlines as
-                               unusual
-                            2: escape non-printable characters, newlines too
-                            3: hex dump everything
+      --encoding TEXT       Set the encoding for the serial port (e.g. hexlify,
+                            Latin1, UTF-8), default: UTF-8
+      -f, --filter TEXT     Add text transformation
+      --eol [CR|LF|CRLF]    End of line mode, default=CRLF
+      --raw                 Do not apply any encodings/transformations
      --exit-char INTEGER   ASCII code of special character that is used to exit
-                            the application, default=0x1d
+                            the application, default=29 (DEC)
      --menu-char INTEGER   ASCII code of special character that is used to
-                            control miniterm (menu), default=0x14
+                            control miniterm (menu), default=20 (DEC)
      --quiet               Diagnostics: suppress non-error messages, default=Off
-      --help                Show this message and exit.
+      -h, --help            Show this message and exit.

 2. Communicate with serial device and print help inside terminal

--- a/docs/userguide/cmd_settings.rst
+++ b/docs/userguide/cmd_settings.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_settings:

 platformio settings
--- a/docs/userguide/cmd_update.rst
+++ b/docs/userguide/cmd_update.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_update:

 platformio update
--- a/docs/userguide/cmd_upgrade.rst
+++ b/docs/userguide/cmd_upgrade.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_upgrade:

 platformio upgrade
--- a/docs/userguide/index.rst
+++ b/docs/userguide/index.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _userguide:

 User Guide
--- a/docs/userguide/lib/cmd_install.rst
+++ b/docs/userguide/lib/cmd_install.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_lib_install:

 platformio lib install
--- a/docs/userguide/lib/cmd_list.rst
+++ b/docs/userguide/lib/cmd_list.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_lib_list:

 platformio lib list
--- a/docs/userguide/lib/cmd_register.rst
+++ b/docs/userguide/lib/cmd_register.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_lib_register:

 platformio lib register
--- a/docs/userguide/lib/cmd_search.rst
+++ b/docs/userguide/lib/cmd_search.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_lib_search:

 platformio lib search
--- a/docs/userguide/lib/cmd_show.rst
+++ b/docs/userguide/lib/cmd_show.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_lib_show:

 platformio lib show
--- a/docs/userguide/lib/cmd_uninstall.rst
+++ b/docs/userguide/lib/cmd_uninstall.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_lib_uninstall:

 platformio lib uninstall
--- a/docs/userguide/lib/cmd_update.rst
+++ b/docs/userguide/lib/cmd_update.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_lib_update:

 platformio lib update
--- a/docs/userguide/lib/index.rst
+++ b/docs/userguide/lib/index.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _userguide_lib:

 Library Manager
--- a/docs/userguide/platforms/cmd_install.rst
+++ b/docs/userguide/platforms/cmd_install.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_platforms_install:

 platformio platforms install
--- a/docs/userguide/platforms/cmd_list.rst
+++ b/docs/userguide/platforms/cmd_list.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_platforms_list:

 platformio platforms list
--- a/docs/userguide/platforms/cmd_search.rst
+++ b/docs/userguide/platforms/cmd_search.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_platforms_search:

 platformio platforms search
--- a/docs/userguide/platforms/cmd_show.rst
+++ b/docs/userguide/platforms/cmd_show.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_platforms_show:

 platformio platforms show
--- a/docs/userguide/platforms/cmd_uninstall.rst
+++ b/docs/userguide/platforms/cmd_uninstall.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_platforms_uninstall:

 platformio platforms uninstall
--- a/docs/userguide/platforms/cmd_update.rst
+++ b/docs/userguide/platforms/cmd_update.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _cmd_platforms_update:

 platformio platforms update
--- a/docs/userguide/platforms/index.rst
+++ b/docs/userguide/platforms/index.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 .. _userguide_platforms:

 Platform Manager
--- a/examples/atmelavr-and-arduino/adafruit-blink/README.rst
+++ b/examples/atmelavr-and-arduino/adafruit-blink/README.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 How to build PlatformIO based project
 =====================================

--- a/examples/atmelavr-and-arduino/arduino-external-libs/README.rst
+++ b/examples/atmelavr-and-arduino/arduino-external-libs/README.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 How to build PlatformIO based project
 =====================================

--- a/examples/atmelavr-and-arduino/arduino-internal-libs/README.rst
+++ b/examples/atmelavr-and-arduino/arduino-internal-libs/README.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 How to build PlatformIO based project
 =====================================

--- a/examples/atmelavr-and-arduino/arduino-own-src_dir/README.rst
+++ b/examples/atmelavr-and-arduino/arduino-own-src_dir/README.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 How to build PlatformIO based project
 =====================================

--- a/examples/atmelavr-and-arduino/atmelavr-native-blink/README.rst
+++ b/examples/atmelavr-and-arduino/atmelavr-native-blink/README.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 How to build PlatformIO based project
 =====================================

--- a/examples/atmelavr-and-arduino/digitstump-mouse/README.rst
+++ b/examples/atmelavr-and-arduino/digitstump-mouse/README.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 How to build PlatformIO based project
 =====================================

--- a/examples/atmelavr-and-arduino/engduino-magnetometer/README.rst
+++ b/examples/atmelavr-and-arduino/engduino-magnetometer/README.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 How to build PlatformIO based project
 =====================================

--- a/examples/atmelavr-and-arduino/panstamp-blink/README.rst
+++ b/examples/atmelavr-and-arduino/panstamp-blink/README.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 How to build PlatformIO based project
 =====================================

--- a/examples/desktop/hello-world/README.rst
+++ b/examples/desktop/hello-world/README.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 How to build PlatformIO based project
 =====================================

--- a/examples/espressif/esp8266-native/README.rst
+++ b/examples/espressif/esp8266-native/README.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 How to build PlatformIO based project
 =====================================

--- a/examples/espressif/esp8266-webserver/README.rst
+++ b/examples/espressif/esp8266-webserver/README.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 How to build PlatformIO based project
 =====================================

--- a/examples/espressif/esp8266-wifiscan/README.rst
+++ b/examples/espressif/esp8266-wifiscan/README.rst
@@ -1,3 +1,14 @@
+..  Copyright 2014-2015 Ivan Kravets <me@ikravets.com>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
 How to build PlatformIO based project
 =====================================

--- a/examples/ide/clion/.idea/clion.iml
+++ b/examples/ide/clion/.idea/clion.iml
@@ -1,9 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <module type="CPP_MODULE" version="4">
  <component name="NewModuleRootManager">
-    <content url="file://$MODULE_DIR$">
-      <sourceFolder url="file://$MODULE_DIR$/CMakeLists.txt" isTestSource="false" />
-    </content>
+    <content url="file://$MODULE_DIR$" />
    <orderEntry type="inheritedJdk" />
    <orderEntry type="sourceFolder" forTests="false" />
  </component>
--- a/examples/ide/clion/.idea/workspace.xml
+++ b/examples/ide/clion/.idea/workspace.xml
@@ -2,13 +2,13 @@
 <project version="4">
  <component name="CMakeRunConfigurationManager" shouldGenerate="true" assignedExecutableTargets="true" buildAllGenerated="true">
    <generated>
-      <config projectName="PlatformIO" targetName="DEBUG" />
-      <config projectName="PlatformIO" targetName="PLATFORMIO_RUN" />
-      <config projectName="PlatformIO" targetName="PlatformIO" />
-      <config projectName="PlatformIO" targetName="PLATFORMIO_UPLOAD" />
-      <config projectName="PlatformIO" targetName="PLATFORMIO_CLEAN" />
-      <config projectName="PlatformIO" targetName="PLATFORMIO_BUILD" />
-      <config projectName="PlatformIO" targetName="PLATFORMIO" />
+      <config projectName="clion" targetName="PLATFORMIO_CLEAN" />
+      <config projectName="clion" targetName="PLATFORMIO_RUN" />
+      <config projectName="clion" targetName="PLATFORMIO" />
+      <config projectName="clion" targetName="clion" />
+      <config projectName="clion" targetName="DEBUG" />
+      <config projectName="clion" targetName="PLATFORMIO_BUILD" />
+      <config projectName="clion" targetName="PLATFORMIO_UPLOAD" />
    </generated>
  </component>
  <component name="CMakeSettings" AUTO_RELOAD="true" GENERATION_PASS_SYSTEM_ENVIRONMENT="true">
@@ -33,25 +33,25 @@
  </component>
  <component name="ExecutionTargetManager" SELECTED_TARGET="default_target" />
  <component name="FavoritesManager">
-    <favorites_list name="PlatformIO" />
+    <favorites_list name="clion" />
  </component>
  <component name="FileEditorManager">
    <leaf>
      <file leaf-file-name="CMakeLists.txt" pinned="false" current-in-tab="true">
        <entry file="file://$PROJECT_DIR$/CMakeLists.txt">
          <provider selected="true" editor-type-id="text-editor">
-            <state vertical-scroll-proportion="0.45302013">
-              <caret line="18" column="20" selection-start-line="18" selection-start-column="20" selection-end-line="18" selection-end-column="20" />
+            <state vertical-scroll-proportion="0.15758981">
+              <caret line="8" column="49" selection-start-line="8" selection-start-column="49" selection-end-line="8" selection-end-column="49" />
              <folding />
            </state>
          </provider>
        </entry>
      </file>
-      <file leaf-file-name="blink.cpp" pinned="false" current-in-tab="false">
-        <entry file="file://$PROJECT_DIR$/src/blink.cpp">
+      <file leaf-file-name="src/blink.cpp" pinned="false" current-in-tab="false">
+    <entry file="file://$PROJECT_DIR/$src/blink.cpp">
          <provider selected="true" editor-type-id="text-editor">
            <state vertical-scroll-proportion="0.0">
-              <caret line="0" column="13" selection-start-line="0" selection-start-column="13" selection-end-line="0" selection-end-column="13" />
+              <caret line="24" column="4" selection-start-line="24" selection-start-column="4" selection-end-line="24" selection-end-column="4" />
              <folding />
            </state>
          </provider>
@@ -67,8 +67,8 @@
    <order />
  </component>
  <component name="ProjectFrameBounds">
-    <option name="x" value="162" />
-    <option name="y" value="23" />
+    <option name="x" value="252" />
+    <option name="y" value="21" />
    <option name="width" value="1400" />
    <option name="height" value="1000" />
  </component>
@@ -116,13 +116,13 @@
          <PATH>
            <PATH_ELEMENT>
              <option name="myItemId" value="clion" />
-              <option name="myItemType" value="com.jetbrains.cidr.projectView.CidrFilesViewHelper$MyProjectTreeStructure$1" />
+              <option name="myItemType" value="com.jetbrains.cidr.projectView.CidrFilesViewHelper$1$1" />
            </PATH_ELEMENT>
          </PATH>
          <PATH>
            <PATH_ELEMENT>
              <option name="myItemId" value="clion" />
-              <option name="myItemType" value="com.jetbrains.cidr.projectView.CidrFilesViewHelper$MyProjectTreeStructure$1" />
+              <option name="myItemType" value="com.jetbrains.cidr.projectView.CidrFilesViewHelper$1$1" />
            </PATH_ELEMENT>
            <PATH_ELEMENT>
              <option name="myItemId" value="clion" />
@@ -132,7 +132,7 @@
          <PATH>
            <PATH_ELEMENT>
              <option name="myItemId" value="clion" />
-              <option name="myItemType" value="com.jetbrains.cidr.projectView.CidrFilesViewHelper$MyProjectTreeStructure$1" />
+              <option name="myItemType" value="com.jetbrains.cidr.projectView.CidrFilesViewHelper$1$1" />
            </PATH_ELEMENT>
            <PATH_ELEMENT>
              <option name="myItemId" value="clion" />
@@ -155,8 +155,8 @@
    <property name="restartRequiresConfirmation" value="true" />
    <property name="FullScreen" value="false" />
  </component>
-  <component name="RunManager" selected="Application.PLATFORMIO_CLEAN">
-    <configuration default="true" type="CMakeRunConfiguration" factoryName="Application" PASS_PARENT_ENVS="FALSE" PROJECT_NAME="PlatformIO" TARGET_NAME="PlatformIO" CONFIG_NAME="Debug">
+  <component name="RunManager" selected="Application.PLATFORMIO_BUILD">
+    <configuration default="true" type="CMakeRunConfiguration" factoryName="Application" PASS_PARENT_ENVS="FALSE" PROJECT_NAME="clion" TARGET_NAME="clion" CONFIG_NAME="Debug">
      <envs />
      <method />
    </configuration>
@@ -173,15 +173,15 @@
      <envs />
      <method />
    </configuration>
-    <configuration default="false" name="PLATFORMIO_BUILD" type="CMakeRunConfiguration" factoryName="Application" WORKING_DIR="" PASS_PARENT_ENVS="FALSE" PROJECT_NAME="PlatformIO" TARGET_NAME="PLATFORMIO_BUILD" CONFIG_NAME="Debug">
+    <configuration default="false" name="PLATFORMIO_BUILD" type="CMakeRunConfiguration" factoryName="Application" WORKING_DIR="" PASS_PARENT_ENVS="FALSE" PROJECT_NAME="clion" TARGET_NAME="PLATFORMIO_BUILD" CONFIG_NAME="Debug">
      <envs />
      <method />
    </configuration>
-    <configuration default="false" name="PLATFORMIO_CLEAN" type="CMakeRunConfiguration" factoryName="Application" WORKING_DIR="" PASS_PARENT_ENVS="FALSE" PROJECT_NAME="PlatformIO" TARGET_NAME="PLATFORMIO_CLEAN" CONFIG_NAME="Debug">
+    <configuration default="false" name="PLATFORMIO_CLEAN" type="CMakeRunConfiguration" factoryName="Application" WORKING_DIR="" PASS_PARENT_ENVS="FALSE" PROJECT_NAME="clion" TARGET_NAME="PLATFORMIO_CLEAN" CONFIG_NAME="Debug">
      <envs />
      <method />
    </configuration>
-    <configuration default="false" name="PLATFORMIO_UPLOAD" type="CMakeRunConfiguration" factoryName="Application" WORKING_DIR="" PASS_PARENT_ENVS="FALSE" PROJECT_NAME="PlatformIO" TARGET_NAME="PLATFORMIO_UPLOAD" CONFIG_NAME="Debug">
+    <configuration default="false" name="PLATFORMIO_UPLOAD" type="CMakeRunConfiguration" factoryName="Application" WORKING_DIR="" PASS_PARENT_ENVS="FALSE" PROJECT_NAME="clion" TARGET_NAME="PLATFORMIO_UPLOAD" CONFIG_NAME="Debug">
      <envs />
      <method />
    </configuration>
@@ -206,27 +206,27 @@
    <servers />
  </component>
  <component name="ToolWindowManager">
-    <frame x="162" y="23" width="1400" height="1000" extended-state="0" />
+    <frame x="252" y="21" width="1400" height="1000" extended-state="0" />
    <editor active="true" />
    <layout>
-      <window_info id="Messages" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="true" weight="0.32975295" sideWeight="0.53684974" order="7" side_tool="false" content_ui="tabs" />
-      <window_info id="Terminal" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.32996634" sideWeight="0.5" order="7" side_tool="false" content_ui="tabs" />
-      <window_info id="TODO" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.33" sideWeight="0.5" order="6" side_tool="false" content_ui="tabs" />
-      <window_info id="Structure" active="false" anchor="left" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.25" sideWeight="0.5" order="1" side_tool="false" content_ui="tabs" />
-      <window_info id="CMake" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.32996634" sideWeight="0.5" order="7" side_tool="false" content_ui="tabs" />
      <window_info id="Project" active="false" anchor="left" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="true" weight="0.25" sideWeight="0.5" order="0" side_tool="false" content_ui="combo" />
-      <window_info id="Debug" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.4" sideWeight="0.5" order="3" side_tool="false" content_ui="tabs" />
-      <window_info id="Run" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.32996634" sideWeight="0.5" order="2" side_tool="false" content_ui="tabs" />
-      <window_info id="Favorites" active="false" anchor="left" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.33" sideWeight="0.5" order="2" side_tool="true" content_ui="tabs" />
+      <window_info id="TODO" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.33" sideWeight="0.5" order="6" side_tool="false" content_ui="tabs" />
+      <window_info id="CMake" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.32996634" sideWeight="0.5" order="7" side_tool="false" content_ui="tabs" />
      <window_info id="Event Log" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.32996634" sideWeight="0.4631503" order="7" side_tool="true" content_ui="tabs" />
      <window_info id="Version Control" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.33" sideWeight="0.5" order="7" side_tool="false" content_ui="tabs" />
+      <window_info id="Run" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.32996634" sideWeight="0.5" order="2" side_tool="false" content_ui="tabs" />
+      <window_info id="Structure" active="false" anchor="left" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.25" sideWeight="0.5" order="1" side_tool="false" content_ui="tabs" />
+      <window_info id="Terminal" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.32996634" sideWeight="0.5" order="7" side_tool="false" content_ui="tabs" />
+      <window_info id="Favorites" active="false" anchor="left" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.33" sideWeight="0.5" order="2" side_tool="true" content_ui="tabs" />
+      <window_info id="Debug" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.4" sideWeight="0.5" order="3" side_tool="false" content_ui="tabs" />
      <window_info id="Cvs" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.25" sideWeight="0.5" order="4" side_tool="false" content_ui="tabs" />
+      <window_info id="Messages" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="true" weight="0.32996634" sideWeight="0.53684974" order="7" side_tool="false" content_ui="tabs" />
      <window_info id="Message" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.33" sideWeight="0.5" order="0" side_tool="false" content_ui="tabs" />
-      <window_info id="Ant Build" active="false" anchor="right" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.25" sideWeight="0.5" order="1" side_tool="false" content_ui="tabs" />
-      <window_info id="Find" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.33" sideWeight="0.5" order="1" side_tool="false" content_ui="tabs" />
      <window_info id="Commander" active="false" anchor="right" auto_hide="false" internal_type="SLIDING" type="SLIDING" visible="false" weight="0.4" sideWeight="0.5" order="0" side_tool="false" content_ui="tabs" />
-      <window_info id="Hierarchy" active="false" anchor="right" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.25" sideWeight="0.5" order="2" side_tool="false" content_ui="combo" />
      <window_info id="Inspection" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.4" sideWeight="0.5" order="5" side_tool="false" content_ui="tabs" />
+      <window_info id="Hierarchy" active="false" anchor="right" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.25" sideWeight="0.5" order="2" side_tool="false" content_ui="combo" />
+      <window_info id="Find" active="false" anchor="bottom" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.33" sideWeight="0.5" order="1" side_tool="false" content_ui="tabs" />
+      <window_info id="Ant Build" active="false" anchor="right" auto_hide="false" internal_type="DOCKED" type="DOCKED" visible="false" weight="0.25" sideWeight="0.5" order="1" side_tool="false" content_ui="tabs" />
    </layout>
  </component>
  <component name="Vcs.Log.UiProperties">
@@ -240,35 +240,12 @@
  <component name="VcsContentAnnotationSettings">
    <option name="myLimit" value="2678400000" />
  </component>
-  <component name="VcsManagerConfiguration">
-    <ignored-roots>
-      <path value="$PROJECT_DIR$/../../.." />
-    </ignored-roots>
-  </component>
  <component name="XDebuggerManager">
    <breakpoint-manager>
      <option name="time" value="4" />
    </breakpoint-manager>
    <watches-manager />
  </component>
-  <component name="editorHistoryManager">
-    <entry file="file://$PROJECT_DIR$/src/blink.cpp">
-      <provider selected="true" editor-type-id="text-editor">
-        <state vertical-scroll-proportion="0.0">
-          <caret line="0" column="13" selection-start-line="0" selection-start-column="13" selection-end-line="0" selection-end-column="13" />
-          <folding />
-        </state>
-      </provider>
-    </entry>
-    <entry file="file://$PROJECT_DIR$/CMakeLists.txt">
-      <provider selected="true" editor-type-id="text-editor">
-        <state vertical-scroll-proportion="0.45302013">
-          <caret line="18" column="20" selection-start-line="18" selection-start-column="20" selection-end-line="18" selection-end-column="20" />
-          <folding />
-        </state>
-      </provider>
-    </entry>
-  </component>
  <component name="masterDetails">
    <states>
      <state key="ScopeChooserConfigurable.UI">
--- a/examples/ide/clion/CMakeLists.txt
+++ b/examples/ide/clion/CMakeLists.txt
@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.2)
-project(PlatformIO)
+project(clion)

 set(PLATFORMIO_CMD platformio)

@@ -14,7 +14,7 @@ add_definitions(-DF_CPU=16000000L)
 add_definitions(-DARDUINO_ARCH_AVR)
 add_definitions(-DARDUINO_AVR_UNO)
 add_definitions(-DARDUINO=10605)
-add_definitions(-DPLATFORMIO=020300)
+add_definitions(-DPLATFORMIO=020304)
 add_definitions(-D__AVR_ATmega328P__)

 add_custom_target(
@@ -33,4 +33,6 @@ add_custom_target(
    PLATFORMIO_CLEAN ALL
    COMMAND ${PLATFORMIO_CMD} -f -c clion run --target clean
    WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
-)
+)
+
+add_executable(clion src/blink.cpp)
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Ivan Kravets	1bf73c268d	Merge branch 'release/v2.4.0'	2015-12-01 17:51:04 +02:00
Ivan Kravets	50ba235917	Version bump to 2.4.0 (issues #271 , #334 , #335 , #336 , #339 , #340 , #343 , #345 , #346 )	2015-12-01 17:50:35 +02:00
Ivan Kravets	14fc21c379	Drop Click to (5.1) <6 // Issue #346	2015-12-01 17:43:16 +02:00
Ivan Kravets	306f2f980d	Drop Click to <6	2015-12-01 17:41:10 +02:00
Ivan Kravets	a7a82b1c0a	Fix PlatformIO version	2015-12-01 16:28:47 +02:00
Valeriy Koval	d806097b60	Fix PlatformIO version.	2015-12-01 13:47:56 +02:00
Ivan Kravets	9f4b73d821	Update Arduino core for Espressif platform to 2.0.0 // Resolve #345	2015-12-01 12:04:41 +02:00
Valeriy Koval	ff5d57039e	Merge branch 'feature/issue-339-espressif-rc-framework' into develop	2015-12-01 11:51:50 +02:00
Valeriy Koval	db42863f54	Update build flags for espressif platform.	2015-12-01 11:21:23 +02:00
Ivan Kravets	946f21879c	Add new article by Keith Hughes	2015-11-30 21:46:21 +02:00
Ivan Kravets	20b214f3a4	Rephrase slogan (add library manager)	2015-11-30 18:29:30 +02:00
Ivan Kravets	8aedc50f30	Rephrase slogan	2015-11-30 18:05:32 +02:00
Ivan Kravets	cd11171e33	Lint code with the latest PyLint	2015-11-30 01:11:57 +02:00
Ivan Kravets	bcb4e1abfd	Add new article by Mistan	2015-11-29 23:23:31 +02:00
Ivan Kravets	786b977603	Print "unexpected block" for non-PlatformIO exceptions	2015-11-29 19:05:02 +02:00
Ivan Kravets	5264d85a78	Fix broken link to extra css	2015-11-29 17:56:26 +02:00
Ivan Kravets	5713a6233f	PlatformIO is an open source ecosystem for IoT development	2015-11-28 17:14:42 +02:00
Ivan Kravets	98ad4adcf3	Numerate installation methods	2015-11-27 23:56:30 +02:00
Ivan Kravets	304c023b4e	Fix unicode issue for Python 2.6	2015-11-27 23:49:49 +02:00
Ivan Kravets	7ce1dd4f5c	Fix ParseFlags for mbed	2015-11-27 21:59:08 +02:00
Ivan Kravets	332b19f35b	Update requirements.txt	2015-11-27 21:19:19 +02:00
Ivan Kravets	774ea5240e	Update click to 6.1	2015-11-27 21:16:20 +02:00
Ivan Kravets	221b7ed188	Fix relative include path for preprocessor using "build_flags" // Resolve #271	2015-11-27 21:15:09 +02:00
Ivan Kravets	304339e309	Try navbar over footer	2015-11-27 13:22:06 +02:00
Ivan Kravets	bf9c9b8985	Add navbar to doc	2015-11-27 00:37:46 +02:00
Ivan Kravets	e85bc39315	Fix inaccurate Vim instructions // Issue #340	2015-11-26 22:15:57 +02:00
Ivan Kravets	ed32e07e34	Better exceptions handling	2015-11-26 22:02:59 +02:00
Valeriy Koval	9bd1f99b69	Improve espressif platform for RC version of framework	2015-11-26 20:19:36 +02:00
Ivan Kravets	25f57cc683	Add logo to the docs	2015-11-26 14:44:44 +02:00
Ivan Kravets	fb4d605e33	Rename to Custom Board/Platform	2015-11-26 13:31:41 +02:00
Ivan Kravets	426b276b08	Rename to Custom Board/Platform	2015-11-26 13:28:48 +02:00
Ivan Kravets	a085d90af2	Fix broken link	2015-11-26 00:32:23 +02:00
Ivan Kravets	8023b85085	Improve @circleci doc	2015-11-26 00:10:36 +02:00
Ivan Kravets	f17d2d7f90	@circleci doesn't support matrix builds	2015-11-25 22:27:57 +02:00
Ivan Kravets	aef06e837a	Fix "LockFailed: failed to create appstate.json.lock" error for Windows	2015-11-25 19:54:06 +02:00
Ivan Kravets	d63f6cff08	Update FAQ & History // Resolve #331	2015-11-24 19:58:24 +02:00
Valeriy Koval	354fbf6253	Add new board with mbed framework support	2015-11-24 19:20:20 +02:00
Valeriy Koval	238ce2e858	fix moteinomega configuration // Resolve #335	2015-11-24 19:08:19 +02:00
Ivan Kravets	c8b6bd1c2c	Add new article "Using PlatformIO to get started with Arduino in CLion IDE" by @mseroczynski	2015-11-24 17:17:25 +02:00
Ivan Kravets	dd5a509a99	Fix ESP-12E flash size // Resolve #333	2015-11-24 13:14:41 +02:00
Valeriy Koval	970ddd44bf	Fix maximum_size for ESP-12E board // Resolve #333	2015-11-23 18:39:56 +02:00
Ivan Kravets	c0eded84a0	Only bug fixes in 2.3.6	2015-11-23 17:27:02 +02:00
Ivan Kravets	5a83ebe48e	Add new article by @joshglendenning about "@Armstrap Eagle and @PlatformIO"	2015-11-20 22:41:36 +02:00
Ivan Kravets	d90697d8db	Merge pull request #328 from hoosierEE/develop Slight grammar/wording tweaks	2015-11-20 00:08:05 +02:00
Ivan Kravets	159c0a93d2	Start 2.4.0	2015-11-18 20:14:16 +02:00
Ivan Kravets	a6040bb53d	Merge branch 'release/v2.3.5'	2015-11-18 20:11:40 +02:00
Ivan Kravets	7d39c886f4	Merge branch 'release/v2.3.5' into develop	2015-11-18 20:11:40 +02:00
Ivan Kravets	771a90a588	Bump to @PlatformIO 2.3.5	2015-11-18 20:11:00 +02:00
Ivan Kravets	7b1858a5ce	Fix compilation error `TWI_Disable not declared` for Arduino Due board // Issue #329	2015-11-18 20:08:27 +02:00
Ivan Kravets	c95226ec1e	Fix includes for Windows	2015-11-18 19:18:50 +02:00
Ivan Kravets	6bece3f371	Improve running @PlatformIO outside virtualenv	2015-11-18 19:12:53 +02:00
Ivan Kravets	48c3e5aa29	Remove user's data	2015-11-18 19:12:12 +02:00
Ivan Kravets	73ae2ffb9b	Add Apache License, Version 2.0 to @PlatformIO examples README	2015-11-18 17:49:21 +02:00
Ivan Kravets	34aaf7b157	Add Apache License, Version 2.0 to @PlatformIO docs	2015-11-18 17:33:46 +02:00
Ivan Kravets	904b08f497	Add Apache License, Version 2.0 to @PlatformIO source code	2015-11-18 17:16:17 +02:00
Ivan Kravets	5454c35430	Fix empty list with serial ports on Mac OS X // Resolve #294	2015-11-17 23:20:04 +02:00
Ivan Kravets	aa98d7dc5d	Skip thread exceptions for telemetry	2015-11-17 23:04:49 +02:00
hoosierEE	020c1c7975	Slight grammar/wording tweaks	2015-11-17 13:26:42 -05:00
Ivan Kravets	cf98750f4b	Fix project generator for CLion IDE under Windows OS with invalid path to executable // Resolve #326	2015-11-16 23:17:23 +02:00
Ivan Kravets	09ccae0f30	Update Arduino AVR/SAM frameworks to 1.6.6 // Resolve #321	2015-11-16 23:10:14 +02:00
Ivan Kravets	522cbacada	Add new article by @nocd5	2015-11-13 17:45:36 +02:00
Ivan Kravets	841fa02b18	Add new article by ALvaro Garcia Gomez	2015-11-12 17:38:56 +02:00
Ivan Kravets	47041272d2	Fix Circle build	2015-11-12 17:28:25 +02:00
Ivan Kravets	c7a6f4f186	Update SCons to 2.4.1	2015-11-12 17:07:17 +02:00
Ivan Kravets	2756984273	Add "open-source" to slogan	2015-11-11 14:59:47 +02:00
Ivan Kravets	91345c0bdd	Add support for pySerial 3.0 // Resolve #307	2015-11-06 19:54:15 +02:00
Ivan Kravets	1790c6bd0f	Merge branch 'feature/pyserial-3.0' into develop	2015-11-06 16:58:50 +02:00
Ivan Kravets	d72b899471	Fix installation on Mac OS X El Capitan // Resolve #312	2015-11-06 16:38:41 +02:00
Ivan Kravets	bf9bbabfd6	Update languages for non-english articles	2015-11-04 16:06:43 +02:00
Ivan Kravets	fff9b34ed7	Fix country name	2015-11-04 16:04:18 +02:00
Ivan Kravets	ce3a8c1f46	Update articles	2015-11-04 16:02:49 +02:00
Ivan Kravets	c420fa4bc2	Add new article "Arduino development at the command line: VIM + @PlatformIO (Japan)" by @caad1229	2015-11-04 00:10:42 +02:00
Ivan Kravets	8e5f9067af	Fix article url	2015-11-03 23:56:59 +02:00
Ivan Kravets	306b0a2f62	Fix firmware uploading for "nordicrf51" development platform // Resolve #316	2015-11-02 23:03:05 +02:00
Ivan Kravets	96f4667755	Update bottle to 0.12.9	2015-11-02 22:39:37 +02:00
Ivan Kravets	2c53bd49f2	Upload firmware using external programmer via "platformio run –target program" // Resolve #311	2015-11-02 22:36:49 +02:00
Ivan Kravets	caa0961337	Fix handling of upload port when board option is not specified in platformio.ini // Resolve #313	2015-11-02 21:41:13 +02:00
Ivan Kravets	32d3b632d2	Add support for Espressif ESP8266 ESP-12E board (NodeMCU) // Resolve #310	2015-11-02 21:18:09 +02:00
Valeriy Koval	3945edb7fe	Update default cpu frequency for NodeMCU board	2015-10-22 17:59:43 +03:00
Valeriy Koval	928feee008	Remove udev rules for ESP-12E (HL-340 dupl.)	2015-10-21 13:19:44 +03:00
Valeriy Koval	9ef4b00238	Fix udev rules for ESP-12E (NodeMCU)	2015-10-21 13:11:13 +03:00
Valeriy Koval	616a769ff5	Add Espressif ESP-12E board (NodeMCU)	2015-10-21 12:48:13 +03:00
Ivan Kravets	ef2c96ac84	Add more examples for @Travis-CI	2015-10-20 17:35:56 +01:00
Ivan Kravets	1c63da7f33	Improve Travis CI doc	2015-10-19 18:25:06 +01:00
Ivan Kravets	2e00e5f463	Add new article "First Arduino I2C Experience with PaltformIO"	2015-10-19 17:59:38 +01:00
Ivan Kravets	8360bf9d84	Up to 2.4.0.ev0	2015-10-16 15:29:28 +01:00
Ivan Kravets	1520c096a4	Add libOpenCM3 framework for nucleo_f103rb board // Resolve #309	2015-10-16 15:22:11 +01:00
Valeriy Koval	a965bfd32e	Fix boards ldscript test	2015-10-16 16:17:24 +03:00
Valeriy Koval	7741790bd8	Add libopenCM3 support for nucleo_f103rb board.	2015-10-16 14:50:28 +03:00
Ivan Kravets	f0e6f8cee2	Update requests to 2.8.1, lockfile to 0.11.0	2015-10-13 20:03:35 +01:00
Ivan Kravets	c4a4dcd419	Merge branch 'release/v2.3.4'	2015-10-13 18:40:46 +01:00
Ivan Kravets	b89a04acd8	Merge branch 'release/v2.3.4' into develop	2015-10-13 18:40:46 +01:00
Ivan Kravets	b7d2619651	Version bump to 2.3.4 (issues #132 , #279 , #290 , #302 , #305 , #306 )	2015-10-13 18:40:23 +01:00
Ivan Kravets	c07e957e28	Fix FAQ doc	2015-10-13 18:36:37 +01:00
Ivan Kravets	b183431c27	Install SCons automatically and avoid `error: option --single-version-externally-managed not recognized`	2015-10-13 18:24:40 +01:00
Ivan Kravets	177353bf7a	PlatformIO command completion in Terminal for bash and zsh // Resolve #290	2015-10-13 17:44:28 +01:00
Ivan Kravets	de2d6818c1	Full support of CLion IDE including code auto-completion // Resolve #132	2015-10-13 14:01:16 +01:00
Ivan Kravets	f758d8607a	Use teensy CLI loader for upload of .hex files on OSX // Resolve #306	2015-10-12 16:29:24 +01:00
Ivan Kravets	1164ef31ca	Fix missing of `framework-mbed` package for `teensy` platform // Resolve #305	2015-10-12 13:24:42 +01:00
Ivan Kravets	2997273654	Merge branch 'develop' of https://github.com/ivankravets/platformio into feature/pyserial-3.0	2015-10-10 14:26:21 +01:00
Ivan Kravets	20edf7de41	Add support for @ubIQio Ardhat board // Resolve #302	2015-10-10 11:35:01 +01:00
Ivan Kravets	7467c281cc	Add support for @ubIQio Ardhat board	2015-10-10 11:33:38 +01:00
Ivan Kravets	3b8d7304ff	Propose upgrading via `pip`	2015-10-09 14:12:30 +01:00
Ivan Kravets	6e274cbf20	Correct social links	2015-10-08 16:59:12 +01:00
Ivan Kravets	3a0614641b	Add links for Hackaday	2015-10-08 16:50:47 +01:00
Ivan Kravets	c395dd5ebd	Update requests to 2.8.0	2015-10-07 11:57:46 +01:00
Ivan Kravets	1c9dc2ba3d	Handle WindowsError when can't remove .pioenvs directory	2015-10-06 17:06:47 +01:00
Ivan Kravets	52b98dd159	Add "Commands completion in Terminal"	2015-10-04 15:20:49 +01:00
Ivan Kravets	1426e78793	Show valid environment names when user typed unknown values	2015-10-03 15:38:33 +01:00
Ivan Kravets	8eb2798e5c	Direct import of comports	2015-10-03 12:28:21 +01:00
Ivan Kravets	ec844961c7	Merge branch 'release/v2.3.3' into develop	2015-10-02 16:24:02 +01:00