Merge branch 'release/v2.3.3'

Version bump to 2.3.3 (issues #263 , #288 , #292 , #295 , #296 , #297 )
Skip empty serial ports // Issue #294
2015-10-02 16:24:02 +01:00 · 2015-10-02 16:23:46 +01:00 · 2015-10-02 16:20:07 +01:00 · 2015-10-02 16:14:04 +01:00 · 2015-10-02 15:34:36 +01:00 · 2015-10-02 15:22:09 +01:00
187 changed files with 4030 additions and 1372 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -3,7 +3,5 @@
 .pioenvs
 .tox
 .sconsign.dblite
-examples/ide-eclipse/.metadata
-examples/ide-eclipse/RemoteSystemsTempFiles
 docs/_build
 dist
--- a/.isort.cfg
+++ b/.isort.cfg
@@ -1,3 +1,3 @@
 [settings]
 line_length=79
-known_third_party=click,requests,serial,SCons,pytest,bottle
+known_third_party=bottle,click,lockfile,pytest,requests,serial,SCons
--- a/.travis.yml
+++ b/.travis.yml
@@ -9,7 +9,7 @@ env:
    - TOX_ENV=py27

 install:
-    - pip install tox
+    - pip install -U pip setuptools tox

 script:
    - tox -e $TOX_ENV
--- a/HISTORY.rst
+++ b/HISTORY.rst
@@ -1,8 +1,84 @@
 Release History
 ===============

+PlatformIO 2.0
+--------------
+
+2.3.3 (2015-10-02)
+~~~~~~~~~~~~~~~~~~
+
+* Added support for LightBlue Bean board
+  (`pull #292 <https://github.com/platformio/platformio/pull/292>`_)
+* Added support for ST Nucleo F446RE board
+  (`pull #293 <https://github.com/platformio/platformio/pull/293>`_)
+* Fixed broken lock file for "appstate" storage
+  (`issue #288 <https://github.com/platformio/platformio/issues/288>`_)
+* Fixed ESP8266 compile errors about RAM size when adding 1 library
+  (`issue #296 <https://github.com/platformio/platformio/issues/296>`_)
+
+2.3.2 (2015-09-10)
+~~~~~~~~~~~~~~~~~~
+
+* Allowed to use ST-Link uploader for mbed-based projects
+* Explained how to use ``lib`` directory from the PlatformIO based project in
+  ``readme.txt`` which will be automatically generated using
+  `platformio init <http://docs.platformio.org/en/latest/userguide/cmd_init.html>`__
+  command
+  (`issue #273 <https://github.com/platformio/platformio/issues/273>`_)
+* Found solution for "pip/scons error: option --single-version-externally-managed not
+  recognized" when install PlatformIO using ``pip`` package manager
+  (`issue #279 <https://github.com/platformio/platformio/issues/279>`_)
+* Fixed firmware uploading to Arduino Leonardo board using Mac OS
+  (`issue #287 <https://github.com/platformio/platformio/issues/287>`_)
+* Fixed `SConsNotInstalled` error for Linux Debian-based distributives
+
+2.3.1 (2015-09-06)
+~~~~~~~~~~~~~~~~~~
+
+* Fixed critical issue when `platformio init --ide <http://docs.platformio.org/en/latest/userguide/cmd_init.html>`__ command hangs PlatformIO
+  (`issue #283 <https://github.com/platformio/platformio/issues/283>`_)
+
+2.3.0 (2015-09-05)
+~~~~~~~~~~~~~~~~~~
+
+* Added
+  `native <http://docs.platformio.org/en/latest/platforms/native.html>`__,
+  `linux_arm <http://docs.platformio.org/en/latest/platforms/linux_arm.html>`__,
+  `linux_i686 <http://docs.platformio.org/en/latest/platforms/linux_i686.html>`__,
+  `linux_x86_64 <http://docs.platformio.org/en/latest/platforms/linux_x86_64.html>`__,
+  `windows_x86 <http://docs.platformio.org/en/latest/platforms/windows_x86.html>`__
+  development platforms
+  (`issue #263 <https://github.com/platformio/platformio/issues/263>`_)
+* Added `PlatformIO Demo <http://docs.platformio.org/en/latest/demo.html>`_
+  page to documentation
+* Simplified `installation <http://docs.platformio.org/en/latest/installation.html>`__
+  process of PlatformIO
+  (`issue #274 <https://github.com/platformio/platformio/issues/274>`_)
+* Significantly improved `Project Generator <http://docs.platformio.org/en/latest/userguide/cmd_init.html#cmdoption-platformio-init--ide>`__ which allows to integrate with `the most popular
+  IDE <http://docs.platformio.org/en/latest/ide.html>`__
+* Added short ``-h`` help option for PlatformIO and sub-commands
+* Updated `mbed <http://docs.platformio.org/en/latest/frameworks/mbed.html>`__
+  framework
+* Updated ``tool-teensy`` package for `Teensy <http://docs.platformio.org/en/latest/platforms/teensy.html>`__
+  platform
+  (`issue #268 <https://github.com/platformio/platformio/issues/268>`_)
+* Added FAQ answer when `Program "platformio" not found in PATH <http://docs.platformio.org/en/latest/faq.html#faq-troubleshooting-pionotfoundinpath>`_
+  (`issue #272 <https://github.com/platformio/platformio/issues/272>`_)
+* Generate "readme.txt" for project "lib" directory
+  (`issue #273 <https://github.com/platformio/platformio/issues/273>`_)
+* Use toolchain's includes pattern ``include*`` for Project Generator
+  (`issue #277 <https://github.com/platformio/platformio/issues/277>`_)
+* Added support for Adafruit Gemma board to
+  `atmelavr <http://docs.platformio.org/en/latest/platforms/atmelavr.html#boards>`__
+  platform
+  (`pull #256 <https://github.com/platformio/platformio/pull/256>`_)
+* Fixed includes list for Windows OS when generating project for `Eclipse IDE <http://docs.platformio.org/en/latest/ide/eclipse.html>`__
+  (`issue #270 <https://github.com/platformio/platformio/issues/270>`_)
+* Fixed ``AttributeError: 'module' object has no attribute 'packages'``
+  (`issue #252 <https://github.com/platformio/platformio/issues/252>`_)
+
 2.2.2 (2015-07-30)
------------------
+~~~~~~~~~~~~~~~~~~

 * Integration with `Atom IDE <http://docs.platformio.org/en/latest/ide/atom.html>`__
 * Support for off-line/unpublished/private libraries
@@ -18,7 +94,7 @@ Release History
  (`issue #254 <https://github.com/platformio/platformio/issues/254>`_)

 2.2.1 (2015-07-17)
------------------
+~~~~~~~~~~~~~~~~~~

 * Project generator for `CLion IDE <http://docs.platformio.org/en/latest/ide/clion.html>`__
  (`issue #132 <https://github.com/platformio/platformio/issues/132>`_)
@@ -29,7 +105,7 @@ Release History
  (`issue #248 <https://github.com/platformio/platformio/issues/248>`_)

 2.2.0 (2015-07-01)
------------------
+~~~~~~~~~~~~~~~~~~

 * Allowed to exclude/include source files from build process using
  `src_filter <http://docs.platformio.org/en/latest/projectconf.html#src-filter>`__
@@ -60,12 +136,12 @@ Release History
  (`issue #245 <https://github.com/platformio/platformio/issues/245>`_)

 2.1.2 (2015-06-21)
------------------
+~~~~~~~~~~~~~~~~~~

 * Fixed broken link to SCons installer

 2.1.1 (2015-06-09)
------------------
+~~~~~~~~~~~~~~~~~~

 * Automatically detect upload port using VID:PID board settings
  (`issue #231 <https://github.com/platformio/platformio/issues/231>`_)
@@ -74,7 +150,7 @@ Release History
  (`issue #229 <https://github.com/platformio/platformio/issues/229>`_)

 2.1.0 (2015-06-03)
------------------
+~~~~~~~~~~~~~~~~~~

 * Added Silicon Labs EFM32 `siliconlabsefm32 <http://docs.platformio.org/en/latest/platforms/siliconlabsefm32.html>`_
  development platform
@@ -93,12 +169,12 @@ Release History
  (`issue #221 <https://github.com/platformio/platformio/issues/221>`_)

 2.0.2 (2015-05-27)
------------------
+~~~~~~~~~~~~~~~~~~

 * Fixed libraries order for "Library Dependency Finder" under Linux OS

 2.0.1 (2015-05-27)
------------------
+~~~~~~~~~~~~~~~~~~

 * Handle new environment variable
  `PLATFORMIO_BUILD_FLAGS <http://docs.platformio.org/en/latest/envvars.html#platformio-build-flags>`_
@@ -119,7 +195,7 @@ Release History
  (`issue #217 <https://github.com/platformio/platformio/issues/217>`_)

 2.0.0 (2015-05-22)
------------------
+~~~~~~~~~~~~~~~~~~

 *Made in* `Paradise <https://twitter.com/ikravets/status/592356377185619969>`_

@@ -166,8 +242,11 @@ Release History
 * Fixed bug with creating copies of source files
  (`issue #177 <https://github.com/platformio/platformio/issues/177>`_)

+PlatformIO 1.0
+--------------
+
 1.5.0 (2015-05-15)
------------------
+~~~~~~~~~~~~~~~~~~

 * Added support of `Framework mbed <http://platformio.org/#!/frameworks/mbed>`_
  for Teensy 3.1
@@ -190,7 +269,7 @@ Release History
  (`issue #191 <https://github.com/platformio/platformio/issues/191>`_)

 1.4.0 (2015-04-11)
------------------
+~~~~~~~~~~~~~~~~~~

 * Added `espressif <http://docs.platformio.org/en/latest/platforms/espressif.html>`_
  development platform with ESP01 board
@@ -216,7 +295,7 @@ Release History


 1.3.0 (2015-03-27)
------------------
+~~~~~~~~~~~~~~~~~~

 * Moved PlatformIO source code and repositories from `Ivan Kravets <https://github.com/ivankravets>`_
  account to `PlatformIO Organisation <https://github.com/platformio>`_
@@ -237,7 +316,7 @@ Release History


 1.2.0 (2015-03-20)
------------------
+~~~~~~~~~~~~~~~~~~

 * Added full support of `mbed <http://docs.platformio.org/en/latest/frameworks/mbed.html>`__
  framework including libraries: *RTOS, Ethernet, DSP, FAT, USB*.
@@ -269,7 +348,7 @@ Release History
  (`issue #100 <https://github.com/platformio/platformio/issues/100>`_)

 1.1.0 (2015-03-05)
------------------
+~~~~~~~~~~~~~~~~~~

 * Implemented ``PLATFORMIO_*`` environment variables
  (`issue #102 <https://github.com/platformio/platformio/issues/102>`_)
@@ -287,7 +366,7 @@ Release History
 * Fixed uploading for *Digispark* board (`issue #106 <https://github.com/platformio/platformio/issues/106>`_)

 1.0.1 (2015-02-27)
------------------
+~~~~~~~~~~~~~~~~~~

 **PlatformIO 1.0 - recommended for production**

@@ -354,9 +433,11 @@ Release History
  error (`issue #81 <https://github.com/platformio/platformio/issues/81>`_)
 * Several bug fixes, increased stability and performance improvements

+PlatformIO 0.0
+--------------

 0.10.2 (2015-01-06)
-------------------
+~~~~~~~~~~~~~~~~~~~

 * Fixed an issue with ``--json-output``
  (`issue #42 <https://github.com/platformio/platformio/issues/42>`_)
@@ -365,7 +446,7 @@ Release History
  under Windows OS (`issue #45 <https://github.com/platformio/platformio/issues/45>`_)

 0.10.1 (2015-01-02)
-------------------
+~~~~~~~~~~~~~~~~~~~

 * Added ``--json-output`` option to
  `platformio list <http://docs.platformio.org/en/latest/userguide/cmd_list.html>`__,
@@ -377,7 +458,7 @@ Release History
  command

 0.10.0 (2015-01-01)
-------------------
+~~~~~~~~~~~~~~~~~~~

 **Happy New Year!**

@@ -400,7 +481,7 @@ Release History
 * Fixed bug with *Arduino USB* boards (`issue #40 <https://github.com/platformio/platformio/issues/40>`_)

 0.9.2 (2014-12-10)
------------------
+~~~~~~~~~~~~~~~~~~

 * Replaced "dark blue" by "cyan" colour for the texts (`issue #33 <https://github.com/platformio/platformio/issues/33>`_)
 * Added new setting `enable_prompts <http://docs.platformio.org/en/latest/userguide/cmd_settings.html>`_
@@ -409,7 +490,7 @@ Release History
 * Fixed compilation bug on *Windows* with installed *MSVC* (`issue #18 <https://github.com/platformio/platformio/issues/18>`_)

 0.9.1 (2014-12-05)
------------------
+~~~~~~~~~~~~~~~~~~

 * Ask user to install platform (when it hasn't been installed yet) within
  `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`__
@@ -418,13 +499,13 @@ Release History
 * Fixed "*OSError: [Errno 2] No such file or directory*" within
  `platformio run <http://docs.platformio.org/en/latest/userguide/cmd_run.html>`__
  command when PlatformIO isn't installed properly
-* Fixed example for `Eclipse IDE with Tiva board <https://github.com/platformio/platformio/tree/develop/examples/ide-eclipse>`_
+* Fixed example for `Eclipse IDE with Tiva board <https://github.com/platformio/platformio/tree/develop/examples/ide/eclipse>`_
  (`issue #32 <https://github.com/platformio/platformio/pull/32>`_)
-* Upgraded `Eclipse Project Examples <https://github.com/platformio/platformio/tree/develop/examples/ide-eclipse>`_
+* Upgraded `Eclipse Project Examples <https://github.com/platformio/platformio/tree/develop/examples/ide/eclipse>`_
  to latest *Luna* and *PlatformIO* releases

 0.9.0 (2014-12-01)
------------------
+~~~~~~~~~~~~~~~~~~

 * Implemented `platformio settings <http://docs.platformio.org/en/latest/userguide/cmd_settings.html>`_ command
 * Improved `platformio init <http://docs.platformio.org/en/latest/userguide/cmd_init.html>`_ command.
@@ -442,7 +523,7 @@ Release History
  (`issue #28 <https://github.com/platformio/platformio/issues/28>`_)

 0.8.0 (2014-10-19)
------------------
+~~~~~~~~~~~~~~~~~~

 * Avoided trademark issues in `library.json <http://docs.platformio.org/en/latest/librarymanager/config.html>`_
  with the new fields: `frameworks <http://docs.platformio.org/en/latest/librarymanager/config.html#frameworks>`_,
@@ -459,7 +540,7 @@ Release History
  command: ``--framework`` and ``--platform``

 0.7.1 (2014-10-06)
------------------
+~~~~~~~~~~~~~~~~~~

 * Fixed bug with order for includes in conversation from INO/PDE to CPP
 * Automatic detection of port on upload (`issue #15 <https://github.com/platformio/platformio/issues/15>`_)
@@ -467,7 +548,7 @@ Release History


 0.7.0 (2014-09-24)
------------------
+~~~~~~~~~~~~~~~~~~

 * Implemented new `[platformio] <http://docs.platformio.org/en/latest/projectconf.html#platformio>`_
  section for Configuration File with `home_dir <http://docs.platformio.org/en/latest/projectconf.html#home-dir>`_
@@ -475,14 +556,14 @@ Release History
 * Implemented *Library Manager* (`issue #6 <https://github.com/platformio/platformio/issues/6>`_)

 0.6.0 (2014-08-09)
------------------
+~~~~~~~~~~~~~~~~~~

 * Implemented `platformio serialports monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_ (`issue #10 <https://github.com/platformio/platformio/issues/10>`_)
 * Fixed an issue ``ImportError: No module named platformio.util`` (`issue #9 <https://github.com/platformio/platformio/issues/9>`_)
 * Fixed bug with auto-conversation from Arduino \*.ino to \*.cpp

 0.5.0 (2014-08-04)
------------------
+~~~~~~~~~~~~~~~~~~

 * Improved nested lookups for libraries
 * Disabled default warning flag "-Wall"
@@ -497,7 +578,7 @@ Release History
 * Fixed a bug with nested libs building

 0.4.0 (2014-07-31)
------------------
+~~~~~~~~~~~~~~~~~~

 * Implemented `platformio serialports <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html>`_ command
 * Allowed to put special build flags only for ``src`` files via
@@ -517,13 +598,13 @@ Release History


 0.3.1 (2014-06-21)
------------------
+~~~~~~~~~~~~~~~~~~

 * Fixed auto-installer for Windows OS (bug with %PATH% customisations)


 0.3.0 (2014-06-21)
------------------
+~~~~~~~~~~~~~~~~~~

 * Allowed to pass multiple "SomePlatform" to install/uninstall commands
 * Added "IDE Integration" section to README with Eclipse project examples
@@ -533,7 +614,7 @@ Release History


 0.2.0 (2014-06-15)
------------------
+~~~~~~~~~~~~~~~~~~

 * Resolved `issue #1 "Build referred libraries" <https://github.com/platformio/platformio/issues/1>`_
 * Renamed project's "libs" directory to "lib"
@@ -542,6 +623,6 @@ Release History


 0.1.0 (2014-06-13)
------------------
+~~~~~~~~~~~~~~~~~~

 * Birth! First alpha release
--- a/README.rst
+++ b/README.rst
@@ -10,29 +10,32 @@ PlatformIO
 .. image:: https://circleci.com/gh/platformio/platformio/tree/develop.svg?style=svg
    :target: https://circleci.com/gh/platformio/platformio/tree/develop
    :alt: Circle.CI Build Status
-.. image:: https://gemnasium.com/platformio/platformio.png
-    :target: https://gemnasium.com/platformio/platformio
-    :alt: Dependency Status
+.. image:: https://requires.io/github/platformio/platformio/requirements.svg?branch=develop
+    :target: https://requires.io/github/platformio/platformio/requirements/?branch=develop
+    :alt: Requirements Status
 .. image:: https://img.shields.io/pypi/v/platformio.svg
    :target: https://pypi.python.org/pypi/platformio/
    :alt: Latest Version
-.. image:: https://img.shields.io/pypi/dm/platformio.svg
-    :target: https://pypi.python.org/pypi/platformio/
-    :alt: Downloads
 .. image:: https://img.shields.io/pypi/l/platformio.svg
    :target: https://pypi.python.org/pypi/platformio/
    :alt:  License
+.. image:: https://img.shields.io/pypi/dm/platformio.svg
+    :target: https://pypi.python.org/pypi/platformio/
+    :alt: PyPi Downloads
+.. image:: https://img.shields.io/sourceforge/dm/platformio-storage.svg
+    :target: https://sourceforge.net/projects/platformio-storage/
+    :alt: Packages Downloads
 .. image:: https://badges.gitter.im/Join%20Chat.svg
   :alt: Join the chat at https://gitter.im/platformio/platformio
   :target: https://gitter.im/platformio/platformio
-.. image:: https://www.openhub.net/p/platformio/widgets/project_thin_badge.gif
-   :target: https://www.openhub.net/p/platformio

-`Website + Library Search <http://platformio.org>`_ |
-`Documentation <http://docs.platformio.org>`_ |
+`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>`_ ||
 `Blog <http://www.ikravets.com/category/computer-life/platformio>`_ |
 `Reddit <http://www.reddit.com/r/platformio/>`_ |
+`Facebook <https://www.facebook.com/platformio>`_ |
 `Twitter <https://twitter.com/PlatformIO_Org>`_

 .. image:: https://raw.githubusercontent.com/platformio/platformio/develop/docs/_static/platformio-logo.png
@@ -46,6 +49,9 @@ Continuous integration, Arduino and MBED compatible).
 Silicon Labs EFM32, ST STM32, TI MSP430 & Tiva, Teensy, Arduino, mbed,
 libOpenCM3, etc.*

+.. image:: https://raw.githubusercontent.com/platformio/platformio/develop/docs/_static/platformio-demo-wiring.gif
+    :target: http://platformio.org
+
 * `Get Started <http://platformio.org/#!/get-started>`_
 * `Web 2.0 Library Search <http://platformio.org/#!/lib>`_
 * `Development Platforms <http://platformio.org/#!/platforms>`_
--- a/appveyor.yml
+++ b/appveyor.yml
@@ -9,12 +9,18 @@ environment:
      PYTHON_HOME: "C:\\Python27-x64"
      PYTHON_VERSION: "2.7"
      PYTHON_ARCH: "64"
+      
 init:
  - "ECHO %TOXENV%"
  - ps: "ls C:\\Python*"
+  
 install:
  - "git submodule update --init --recursive"
  - "powershell scripts\\appveyor\\install.ps1"
+  
+before_test:
+  - cmd: SET PATH=%PATH%;C:\MinGW\bin  
+  
 test_script:
  - "%PYTHON_HOME%\\Scripts\\tox --version"
  - "%PYTHON_HOME%\\Scripts\\pip --version"
--- a/docs/_static/ide-platformio-clion.png
+++ b/docs/_static/ide-platformio-clion.png
--- a/docs/_static/ide-platformio-qtcreator-3.png
+++ b/docs/_static/ide-platformio-qtcreator-3.png
--- a/docs/_static/platformio-demo-lib.gif
+++ b/docs/_static/platformio-demo-lib.gif
--- a/docs/_static/platformio-demo-platforms.gif
+++ b/docs/_static/platformio-demo-platforms.gif
--- a/docs/_static/platformio-demo-wiring.gif
+++ b/docs/_static/platformio-demo-wiring.gif
--- a/docs/articles.rst
+++ b/docs/articles.rst
@@ -4,18 +4,31 @@ Articles about us
 =================

 .. note::
-	If you've written article about PlatformIO and would like it listed on
-	this page, `please edit this page <https://github.com/platformio/platformio/blob/develop/docs/articles.rst>`_.
+    If you've written article about PlatformIO and would like it listed on
+    this page, `please edit this page <https://github.com/platformio/platformio/blob/develop/docs/articles.rst>`_.

 Here are recent articles about PlatformIO:

+2015
+^^^^
+
+* 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 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 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 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>`_
 * 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>`_
 * March 23, 2015 - **Atmel** - `Cross-board and cross-vendor embedded development with PlatformIO <http://blog.atmel.com/2015/03/23/cross-board-and-cross-vendor-embedded-development-with-platformio/>`_
 * March 22, 2015 - **Mark VandeWettering** - `Discovered a new tool for embedded development: PlatformIO <http://brainwagon.org/2015/03/22/discovered-a-new-tool-for-embedded-development-platformio/>`_
-* October 7, 2014 - **Ivan Kravets** - `Integration of PlatformIO library manager to Arduino and Energia IDEs <http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides>`_
-* June 20, 2014 - **Ivan Kravets** - `Building and debugging Atmel AVR (Arduino-based) project using Eclipse IDE+PlatformIO <http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio>`_
-* June 17, 2014 - **Ivan Kravets** - `How was PlatformIO born or why I love Python World <http://www.ikravets.com/computer-life/programming/2014/06/17/how-was-platformio-born-or-why-i-love-python-world>`_
+* February 25, 2015 - **Hendrik Putzek** - `Use your favourite IDE together with Arduino <http://blog.putzek.com/2015/02/your-favourite-ide-with-arduino.html>`_
+
+2014
+^^^^
+
+* October 7, 2014 - **Ivan Kravets, Ph.D.** - `Integration of PlatformIO library manager to Arduino and Energia IDEs <http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides>`_
+* June 20, 2014 - **Ivan Kravets, Ph.D.** - `Building and debugging Atmel AVR (Arduino-based) project using Eclipse IDE+PlatformIO <http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio>`_
+* June 17, 2014 - **Ivan Kravets, Ph.D.** - `How was PlatformIO born or why I love Python World <http://www.ikravets.com/computer-life/programming/2014/06/17/how-was-platformio-born-or-why-i-love-python-world>`_
--- a/docs/ci/appveyor.rst
+++ b/docs/ci/appveyor.rst
@@ -113,17 +113,12 @@ same for the all projects, don't need to modify them):


    function InstallPip ($python_home) {
-        $pip_path = $python_home + "/Scripts/pip.exe"
        $python_path = $python_home + "/python.exe"
-        if (-not(Test-Path $pip_path)) {
-            Write-Host "Installing pip..."
-            $webclient = New-Object System.Net.WebClient
-            $webclient.DownloadFile($GET_PIP_URL, $GET_PIP_PATH)
-            Write-Host "Executing:" $python_path $GET_PIP_PATH
-            Start-Process -FilePath "$python_path" -ArgumentList "$GET_PIP_PATH" -Wait -Passthru
-        } else {
-            Write-Host "pip already installed."
-        }
+        Write-Host "Installing pip..."
+        $webclient = New-Object System.Net.WebClient
+        $webclient.DownloadFile($GET_PIP_URL, $GET_PIP_PATH)
+        Write-Host "Executing:" $python_path $GET_PIP_PATH
+        Start-Process -FilePath "$python_path" -ArgumentList "$GET_PIP_PATH" -Wait -Passthru
    }

    function InstallPackage ($python_home, $pkg) {
@@ -131,19 +126,11 @@ same for the all projects, don't need to modify them):
        & $pip_path install -U $pkg
    }

-    function InstallScons ($python_home) {
-        Write-Host "Start installing Scons"
-        $pip_path = $python_home + "/Scripts/pip.exe"
-        & $pip_path install --egg "http://dl.platformio.org/scons.zip"
-        Write-Host "Scons installed"
-    }
-
    function main () {
        InstallPython $env:PYTHON_VERSION $env:PYTHON_ARCH $env:PYTHON_HOME
        InstallPip $env:PYTHON_HOME
        InstallPackage $env:PYTHON_HOME setuptools
        InstallPackage $env:PYTHON_HOME platformio
-        InstallScons $env:PYTHON_HOME
    }

    main
--- a/docs/demo.rst
+++ b/docs/demo.rst
@@ -0,0 +1,50 @@
+.. _demo:
+
+Demo
+====
+
+.. contents::
+
+Wiring Blink
+------------
+
+.. image:: _static/platformio-demo-wiring.gif
+
+Used in demo
+~~~~~~~~~~~~
+
+1. Source code of `Wiring Blink Example <https://github.com/platformio/platformio/tree/develop/examples/wiring-blink>`_
+2. :ref:`cmd_run` command
+3. :ref:`platformio run -t upload <cmd_run>` command.
+
+Platform Manager
+----------------
+
+.. image:: _static/platformio-demo-platforms.gif
+
+Used in demo
+~~~~~~~~~~~~
+
+1. :ref:`userguide_platforms`
+2. :ref:`cmd_platforms_list` command
+3. :ref:`platformio platforms search avr <cmd_platforms_search>` command
+4. :ref:`platformio platforms show teensy <cmd_platforms_show>` command
+5. :ref:`cmd_platforms_update` command.
+
+Library Manager
+---------------
+
+.. image:: _static/platformio-demo-lib.gif
+
+Used in demo
+~~~~~~~~~~~~
+
+1. :ref:`userguide_lib`
+2. :ref:`platformio lib search 1-wire <cmd_lib_search>` command
+3. :ref:`platformio lib install 54 <cmd_lib_install>` command
+4. :ref:`platformio lib search -f mbed <cmd_lib_search>` command
+5. :ref:`platformio lib search -k rf <cmd_lib_search>` command
+6. :ref:`platformio lib search radiohead <cmd_lib_search>` command
+7. :ref:`platformio lib install 124 --version "1.40" <cmd_lib_install>` command
+8. :ref:`platformio lib show 124 <cmd_lib_show>` command
+9. :ref:`cmd_lib_update` command.
--- a/docs/envvars.rst
+++ b/docs/envvars.rst
@@ -18,10 +18,7 @@ General
 PlatformIO uses *General* environment variables for the common
 operations/commands.

-.. _envvar_CI:
-
-CI
-~~
+.. envvar:: CI

 PlatformIO handles ``CI`` variable which is setup by
 `Continuous Integration <http://en.wikipedia.org/wiki/Continuous_integration>`_
@@ -29,33 +26,21 @@ PlatformIO handles ``CI`` variable which is setup by
 Currently, PlatformIO uses it to disable prompts.

 In other words, ``CI=true`` automatically setup
-:ref:`PLATFORMIO_SETTING_ENABLE_PROMPTS=false <envvar_PLATFORMIO_SETTING_ENABLE_PROMPTS>`.
+:envvar:`PLATFORMIO_SETTING_ENABLE_PROMPTS=false <PLATFORMIO_SETTING_ENABLE_PROMPTS>`.

-.. _envvar_PLATFORMIO_HOME_DIR:
-
-PLATFORMIO_HOME_DIR
-~~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_HOME_DIR

 Allows to override :ref:`projectconf` option :ref:`projectconf_pio_home_dir`.

-.. _envvar_PLATFORMIO_LIB_DIR:
-
-PLATFORMIO_LIB_DIR
-~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_LIB_DIR

 Allows to override :ref:`projectconf` option :ref:`projectconf_pio_lib_dir`.

-.. _envvar_PLATFORMIO_SRC_DIR:
-
-PLATFORMIO_SRC_DIR
-~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_SRC_DIR

 Allows to override :ref:`projectconf` option :ref:`projectconf_pio_src_dir`.

-.. _envvar_PLATFORMIO_ENVS_DIR:
-
-PLATFORMIO_ENVS_DIR
-~~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_ENVS_DIR

 Allows to override :ref:`projectconf` option :ref:`projectconf_pio_envs_dir`.

@@ -63,74 +48,53 @@ Allows to override :ref:`projectconf` option :ref:`projectconf_pio_envs_dir`.
 Builder
 -------

-.. _envvar_PLATFORMIO_BUILD_FLAGS:
-
-PLATFORMIO_BUILD_FLAGS
-~~~~~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_BUILD_FLAGS

 Allows to set :ref:`projectconf` option :ref:`projectconf_build_flags`.

-.. _envvar_PLATFORMIO_SRC_BUILD_FLAGS:
-
-PLATFORMIO_SRC_BUILD_FLAGS
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_SRC_BUILD_FLAGS

 Allows to set :ref:`projectconf` option :ref:`projectconf_src_build_flags`.

-.. _envvar_PLATFORMIO_SRC_FILTER:
-
-PLATFORMIO_SRC_FILTER
-~~~~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_SRC_FILTER

 Allows to set :ref:`projectconf` option :ref:`projectconf_src_filter`.

-.. _envvar_PLATFORMIO_EXTRA_SCRIPT:
-
-PLATFORMIO_EXTRA_SCRIPT
-~~~~~~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_EXTRA_SCRIPT

 Allows to set :ref:`projectconf` option :ref:`projectconf_extra_script`.

+
 Settings
 --------

 Allows to override PlatformIO settings. You can manage them via
 :ref:`cmd_settings` command.

-
-PLATFORMIO_SETTING_AUTO_UPDATE_LIBRARIES
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_SETTING_AUTO_UPDATE_LIBRARIES

 Allows to override setting :ref:`setting_auto_update_libraries`.

-PLATFORMIO_SETTING_AUTO_UPDATE_PLATFORMS
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_SETTING_AUTO_UPDATE_PLATFORMS

 Allows to override setting :ref:`setting_auto_update_platforms`.

-PLATFORMIO_SETTING_CHECK_LIBRARIES_INTERVAL
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_SETTING_CHECK_LIBRARIES_INTERVAL

 Allows to override setting :ref:`setting_check_libraries_interval`.

-PLATFORMIO_SETTING_CHECK_PLATFORMIO_INTERVAL
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_SETTING_CHECK_PLATFORMIO_INTERVAL

 Allows to override setting :ref:`setting_check_platformio_interval`.

-PLATFORMIO_SETTING_CHECK_PLATFORMS_INTERVAL
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_SETTING_CHECK_PLATFORMS_INTERVAL

 Allows to override setting :ref:`setting_check_platforms_interval`.

-.. _envvar_PLATFORMIO_SETTING_ENABLE_PROMPTS:
-
-PLATFORMIO_SETTING_ENABLE_PROMPTS
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_SETTING_ENABLE_PROMPTS

 Allows to override setting :ref:`setting_enable_prompts`.

-PLATFORMIO_SETTING_ENABLE_TELEMETRY
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. envvar:: PLATFORMIO_SETTING_ENABLE_TELEMETRY

 Allows to override setting :ref:`setting_enable_telemetry`.
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -60,6 +60,35 @@ the project developed using PlatformIO is as follows:
 Troubleshooting
 ---------------

+Installation
+~~~~~~~~~~~~
+
+PlatformIO and ``scons`` aren't installed properly
+''''''''''''''''''''''''''''''''''''''''''''''''''
+
+Try these solutions:
+
+1. Upgrade SCons via `pip <https://pip.pypa.io>`_
+
+.. code-block:: bash
+
+    [sudo] pip uninstall scons
+    [sudo] pip install scons
+
+2. Install PlatformIO using :ref:`installation_installer_script`.
+
+.. _faq_troubleshooting_sconssingverextmanaged:
+
+PIP & SCons Error: option --single-version-externally-managed not recognized
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+
+Answered in `issue #279 <https://github.com/platformio/platformio/issues/279>`_.
+
+[Errno 1] Operation not permitted
+'''''''''''''''''''''''''''''''''
+
+Answered in `issue #295 <https://github.com/platformio/platformio/issues/295#issuecomment-143772005>`_.
+
 .. _faq_troubleshooting_pioblocksprompt:

 PlatformIO blocks command execution using user prompt
@@ -70,14 +99,38 @@ 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 :ref:`PLATFORMIO_SETTING_ENABLE_PROMPTS=No <envvar_PLATFORMIO_SETTING_ENABLE_PROMPTS>`
+- 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
-  :ref:`CI=true <envvar_CI>`.
+  :envvar:`CI=true <CI>`.

+.. _faq_troubleshooting_pionotfoundinpath:

-Windows: ``UnicodeDecodeError: 'ascii' codec can't decode byte``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Program ``platformio`` not found in PATH
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Where is ``platformio`` binary installed? Run this command in Terminal
+
+.. code-block:: bash
+
+    # for Unix
+    which platformio
+    echo $PATH
+
+    # for Windows OS
+    where platformio
+    echo %PATH%
+
+For example, ``which platformio`` is equal to ``/usr/local/bin/platformio``,
+then `PATH (wiki) <https://en.wikipedia.org/wiki/PATH_(variable)>`_
+should contain ``/usr/local/bin`` directory.
+
+**Unix Users**: You can make "symlinks" from ``platformio`` and ``scons``
+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>`_.

@@ -94,15 +147,25 @@ Please upgrade *SetupTools* package:

 .. code-block:: bash

-    $ [sudo] pip uninstall setuptools
-    $ [sudo] pip install setuptools
+    [sudo] pip uninstall setuptools
+    [sudo] pip install setuptools

    # Then re-install PlatformIO
-    $ [sudo] pip uninstall platformio
-    $ [sudo] pip install platformio
+    [sudo] pip uninstall platformio
+    [sudo] pip install platformio

-ARM toolchain: ``cc1plus: error while loading shared libraries``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Windows AttributeError: 'module' object has no attribute 'packages'
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Answered in `issue #252 <https://github.com/platformio/platformio/issues/252#issuecomment-127072039>`_.
+
+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
@@ -59,6 +59,13 @@ Adafruit
      - 32 Kb
      - 2.5 Kb

+    * - ``gemma``
+      - `Adafruit Gemma <http://www.adafruit.com/products/1222>`_
+      - ATTINY85
+      - 8 MHz
+      - 8 Kb
+      - 0.5 Kb
+
    * - ``protrinket3``
      - `Adafruit Pro Trinket 3V/12MHz (USB) <http://www.adafruit.com/products/2010>`_
      - ATMEGA328P
@@ -623,6 +630,26 @@ PanStamp
      - 32 Kb
      - 4 Kb

+Punch Through
+~~~~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``lightblue-bean``
+      - `LightBlue Bean <https://punchthrough.com/bean>`_
+      - ATMEGA328P
+      - 8 MHz
+      - 32 Kb
+      - 2 Kb
+
 Quirkbot
 ~~~~~~~~

--- a/docs/frameworks/mbed.rst
+++ b/docs/frameworks/mbed.rst
@@ -469,6 +469,13 @@ ST
      - 512 Kb
      - 128 Kb

+    * - ``nucleo_f446re``
+      - `ST Nucleo F446RE <https://developer.mbed.org/platforms/ST-Nucleo-F446RE/>`_
+      - STM32F446RET6
+      - 180 MHz
+      - 512 Kb
+      - 128 Kb
+
    * - ``nucleo_l053r8``
      - `ST Nucleo L053R8 <https://developer.mbed.org/platforms/ST-Nucleo-L053R8/>`_
      - STM32L053R8T6
--- a/docs/ide/arduino.rst
+++ b/docs/ide/arduino.rst
@@ -23,7 +23,6 @@ Integration
 More detailed information is located in PlatformIO blog:
 `Integration of PlatformIO library manager to Arduino IDE <http://www.ikravets.com/computer-life/platformio/2014/10/07/integration-of-platformio-library-manager-to-arduino-and-energia-ides>`_.

-
 Screenshot
 ----------

--- a/docs/ide/clion.rst
+++ b/docs/ide/clion.rst
@@ -33,8 +33,18 @@ Since PlatformIO 2.0 you can generate CLion compatible project using

    platformio init --ide clion --board %TYPE%

-Then import this project from start menu or via ``File > Import Project>`` and
-specify root directory where is located :ref:`projectconf`.
+Then:
+
+1. Import this project via ``Menu: File > Import Project``
+   and specify root directory where is located :ref:`projectconf`
+2. Open source file from ``src`` directory (``*.c, *.cpp, *.ino, etc.``)
+3. Build project: ``Menu: Run > Build``.
+
+There are 3 predefined targets for building:
+
+* ``PLATFORMIO_BUILD`` - build project without auto-uploading
+* ``PLATFORMIO_UPLOAD`` - build and upload (if no errors)
+* ``PLATFORMIO_CLEAN`` - clean compiled objects and etc.

 .. warning::
    CLion is still in the development stage, so some of the features (like,
@@ -49,3 +59,11 @@ Screenshot

 .. image:: ../_static/ide-platformio-clion.png
    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-clion.png
+
+Examples
+--------
+
+"Blink" Project
+^^^^^^^^^^^^^^^
+
+Source code of `CLion "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/clion>`_.
--- a/docs/ide/eclipse.rst
+++ b/docs/ide/eclipse.rst
@@ -37,19 +37,31 @@ Since PlatformIO 2.0 you can generate Eclipse compatible project using

    platformio init --ide eclipse --board %TYPE%

-Then import this project via ``File > Import... > General > Existing Projects
-into Workspace > Next`` and specify root directory where is located
-:ref:`projectconf`.
+Then:
+
+1. Import this project via
+   ``Menu: File > Import... > General > Existing Projects into Workspace > Next``
+   and specify root directory where is located :ref:`projectconf`
+2. Open source file from ``src`` directory (``*.c, *.cpp, *.ino, etc.``)
+3. Build project: ``Menu: Project > Build Project``.
+

 Manual Integration
 ^^^^^^^^^^^^^^^^^^

-More detailed information is located in PlatformIO blog: `Building and debugging Atmel AVR (Arduino-based) project using Eclipse IDE+PlatformIO <http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio>`_.
-
-`More examples (TI MSP430, TI TIVA, etc.) <https://github.com/platformio/platformio/tree/develop/examples/ide-eclipse>`_
+* `Building and debugging Atmel AVR (Arduino-based) project using Eclipse IDE+PlatformIO <http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio>`_
+* `Improvised MBED FRDM-K64F Eclipse/PlatformIO Setup and Software Installation <http://thomasweldon.com/tpw/courses/embeddsp/p00pcFrdmK64_eclipsePlatformioSetup.html>`_

 Screenshot
 ----------

 .. image:: ../_static/ide-platformio-eclipse.png
    :target: http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio
+
+Examples
+--------
+
+"Blink" Project
+^^^^^^^^^^^^^^^
+
+Source code of `Eclipse "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/eclipse>`_.
--- a/docs/ide/qtcreator.rst
+++ b/docs/ide/qtcreator.rst
@@ -18,6 +18,11 @@ page for more detailed information.
 Integration
 -----------

+.. note::
+    Please verify that folder where is located ``platformio`` program is added
+    to `PATH (wiki) <https://en.wikipedia.org/wiki/PATH_(variable)>`_ environment
+    variable. See FAQ: :ref:`faq_troubleshooting_pionotfoundinpath`.
+
 Project Generator
 ^^^^^^^^^^^^^^^^^

@@ -29,10 +34,42 @@ Since PlatformIO 2.0 you can generate Qt Creator compatible project using

    platformio init --ide qtcreator --board %TYPE%

-Then import this project via ``File > New File or Project > Import Project``
-and specify root directory where is located :ref:`projectconf`.
+Then:

-After import, we need to delete default build and clean steps and configure project with PlatformIO source code builder (click on Projects label on left menu or ``Ctrl+5`` shortcut):
+1. Import project via ``File > Open File or Project`` and select
+   ``platformio.pro`` from the folder where is located :ref:`projectconf`
+2. Select default desktop kit and click on ``Configure Project`` (``Projects``
+   mode, left panel)
+3. Set ``General > Build directory`` to the project directory where
+   is located :ref:`projectconf`
+4. Remove all items from ``Build Steps``, click on
+   ``Build Steps > Add Build Step > Custom Process Step`` and set:
+
+   * **Command**: ``platformio``
+   * **Arguments**: ``-f -c qtcreator run``
+   * **Working directory**: ``%{buildDir}``
+
+5. Remove all items from ``Clean Steps``, click on
+   ``Clean Steps > Add Clean Step > Custom Process Step`` and set:
+
+   * **Command**: ``platformio``
+   * **Arguments**: ``-f -c qtcreator run --target clean``
+   * **Working directory**: ``%{buildDir}``
+
+6. Update ``PATH`` in ``Build Environment > PATH > EDIT`` with the result of
+   this command (paste in Terminal):
+
+.. code-block:: shell
+
+    # Linux, Mac
+    echo $PATH
+
+    # Windows
+    echo %PATH%
+
+7. Switch to ``Edit`` mode (left panel) and open source file from ``src``
+   directory (``*.c, *.cpp, *.ino, etc.``)
+8. Build project: ``Menu: Build > Build All``.

 .. image:: ../_static/ide-platformio-qtcreator-3.png
    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-3.png
@@ -129,12 +166,21 @@ Edit the content to match the code described below.
    framework = arduino
    board = uno

-
 Conclusion
----------
+~~~~~~~~~~

-Taking everything into account, we can build project with shortcut ``Ctrl+Shift+B`` or using ``Menu: Build > Build All``:
+Taking everything into account, we can build project with shortcut ``Ctrl+Shift+B`` or using ``Menu: Build > Build All``.
+
+Screenshot
+----------

 .. image:: ../_static/ide-platformio-qtcreator-7.png
    :target: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-7.png

+Examples
+--------
+
+"Blink" Project
+^^^^^^^^^^^^^^^
+
+Source code of `Qt Creator "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/qtcreator>`_.
--- a/docs/ide/sublimetext.rst
+++ b/docs/ide/sublimetext.rst
@@ -29,12 +29,23 @@ Since PlatformIO 2.0 you can generate Sublime Text compatible project using

    platformio init --ide sublimetext --board %TYPE%

-Then import this project via ``Project > Open Project...`` and specify root
-directory where is located :ref:`projectconf`.
+Then:
+
+1. Import project via ``Menu: Project > Open Project...`` and select
+   ``platformio.sublime-project`` from the folder where is located :ref:`projectconf`
+2. Select PlatformIO as build system: ``Menu: Tools > Build System > PlatformIO``
+3. Open source file from ``src`` directory (``*.c, *.cpp, *.ino, etc.``)
+4. Build project: ``Menu: Tools > Build``.
+

 Manual Integration
 ^^^^^^^^^^^^^^^^^^

+.. note::
+    Please verify that folder where is located ``platformio`` program is added
+    to `PATH (wiki) <https://en.wikipedia.org/wiki/PATH_(variable)>`_ environment
+    variable. See FAQ: :ref:`faq_troubleshooting_pionotfoundinpath`.
+
 Initial configuration
 ~~~~~~~~~~~~~~~~~~~~~

@@ -45,17 +56,17 @@ described below:
 .. code-block:: bash

    {
-        "cmd": ["platformio", "--force", "run"],
+        "cmd": ["platformio", "-f", "-c", "sublimetext", "run"],
        "working_dir": "${project_path:${folder}}",
        "variants":
        [
            {
                "name": "Clean",
-                "cmd": ["platformio", "--force", "run", "--target", "clean"]
+                "cmd": ["platformio", "-f", "-c", "sublimetext", "run", "--target", "clean"]
            },
            {
                "name": "Upload",
-                "cmd": ["platformio", "--force", "run", "--target", "upload"]
+                "cmd": ["platformio", "-f", "-c", "sublimetext", "run", "--target", "upload"]
            }
        ]
    }
@@ -139,8 +150,19 @@ Copy the source code which is described below to it.
    board = uno

 Conclusion
----------
+~~~~~~~~~~

 Taking everything into account, we can open project directory in Sublime Text using ``Menu: File > Open Folder`` and build it with shortcut ``Ctrl+B`` (Windows/Linux) or ``Cmd+B`` (Mac), clean project with shortcut ``F11`` and upload firmware to target with shortcut ``F12``.

+Screenshot
+----------
+
 .. image:: ../_static/ide-sublime-text-platformio-newproject-5.png
+
+Examples
+--------
+
+"Blink" Project
+^^^^^^^^^^^^^^^
+
+Source code of `Sublime Text "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/sublimetext>`_.
--- a/docs/ide/vim.rst
+++ b/docs/ide/vim.rst
@@ -15,6 +15,11 @@ This software can be used with:
 Integration
 -----------

+.. note::
+    Please verify that folder where is located ``platformio`` program is added
+    to `PATH (wiki) <https://en.wikipedia.org/wiki/PATH_(variable)>`_ environment
+    variable. See FAQ: :ref:`faq_troubleshooting_pionotfoundinpath`.
+
 Recommended bundles:

 * Syntax highlight - `Arduino-syntax-file <https://github.com/vim-scripts/Arduino-syntax-file>`_
@@ -30,10 +35,10 @@ Put to the project directory ``Makefile`` wrapper with contents:
    #PATH := /usr/local/bin:$(PATH)

    all:
-        platformio --force run --target upload
+        platformio -f -c vim run --target upload

    clean:
-        platformio --force run --target clean
+        platformio -f -c vim run --target clean


 Now, in VIM ``cd /path/to/this/project`` and press ``Ctrl+B`` or ``Cmd+B``
--- a/docs/ide/visualstudio.rst
+++ b/docs/ide/visualstudio.rst
@@ -18,6 +18,11 @@ page for more detailed information.
 Integration
 -----------

+.. note::
+    Please verify that folder where is located ``platformio`` program is added
+    to `PATH (wiki) <https://en.wikipedia.org/wiki/PATH_(variable)>`_ environment
+    variable. See FAQ: :ref:`faq_troubleshooting_pionotfoundinpath`.
+
 Project Generator
 ^^^^^^^^^^^^^^^^^

@@ -29,8 +34,12 @@ Since PlatformIO 2.0 you can generate Visual Studio compatible project using

    platformio init --ide visualstudio --board %TYPE%

-Then import this project via ``File->Open->Project/Solution`` and specify root
-directory where is located :ref:`projectconf`.
+Then:
+
+1. Import this project via ``Menu: File > Open > Project/Solution``
+   and specify root directory where is located :ref:`projectconf`
+2. Open source file from ``src`` directory (``*.c, *.cpp, *.ino, etc.``)
+3. Build project: ``Menu: Build > Build Solution``.

 Manual Integration
 ^^^^^^^^^^^^^^^^^^
@@ -118,9 +127,20 @@ Copy the source code which is described below to it.


 Conclusion
----------
+~~~~~~~~~~

-Taking everything into account, we can build project with shortcut ``Ctrl+Shift+B`` or using ``Menu: Build > Build Solution``:
+Taking everything into account, we can build project with shortcut ``Ctrl+Shift+B`` or using ``Menu: Build > Build Solution``.
+
+Screenshot
+----------

 .. image:: ../_static/ide-vs-platformio-newproject-8.png
    :target: http://docs.platformio.org/en/latest/_static/ide-vs-platformio-newproject-8.png
+
+Examples
+--------
+
+"Blink" Project
+^^^^^^^^^^^^^^^
+
+Source code of `Visual Studio "Blink" Project <https://github.com/platformio/platformio/tree/develop/examples/ide/visualstudio>`_.
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -19,6 +19,7 @@ libOpenCM3, etc.*
  `Issues <https://github.com/platformio/platformio/issues>`_
 * `Blog <http://www.ikravets.com/category/computer-life/platformio>`_ |
  `Reddit <http://www.reddit.com/r/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*
@@ -60,18 +61,40 @@ Contents
 --------

 .. toctree::
+    :caption: Getting Started
    :maxdepth: 2

-    quickstart
+    demo
    installation
+    quickstart
+    userguide/index
+
+.. toctree::
+    :caption: Configuration
+    :maxdepth: 2
+
    projectconf
    envvars
+
+.. toctree::
+    :caption: Instruments
+    :maxdepth: 2
+
    Platforms & Boards <platforms/index>
    frameworks/index
+
+.. toctree::
+    :caption: Integration
+    :maxdepth: 2
+
    librarymanager/index
-    userguide/index
    ci/index
    ide
+
+.. toctree::
+    :caption: Miscellaneous
+    :maxdepth: 2
+
    articles
    FAQ <faq>
    history
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -18,57 +18,74 @@ System requirements
    * Mac OS X
    * Linux, +ARM
    * Windows
-* `Python 2.6 or Python 2.7 <https://www.python.org/downloads/>`_
+* Python 2.6.x or Python 2.7.x(recommended)

 All commands below should be executed in
 `Command-line <http://en.wikipedia.org/wiki/Command-line_interface>`_
-application:
+application (Terminal):

-* *Mac OS X / Linux* this is *Terminal* application.
-* *Windows* this is
-  `Command Prompt <http://en.wikipedia.org/wiki/Command_Prompt>`_ (``cmd.exe``)
-  application.
+* Mac OS X / Linux – *Terminal* application
+* Windows – ``cmd.exe`` application.

-.. warning::
-    If you are going to run *PlatformIO* from **subprocess**, you
-    :ref:`MUST DISABLE <faq_troubleshooting_pioblocksprompt>` all prompts.
-    It will allow you to avoid blocking.
-
-.. note::
-    **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).
-
-    **Windows Users:** Please check that you have correctly installed USB driver
-    from board manufacturer
-
-Troubleshooting
---------------
-
-For further details, frequently questions, please refer to :ref:`faq`.
-
-Installation Methods
+Installation options
 --------------------

-Please *choose one of* the following installation methods:
+.. warning::
+    **Windows OS**: Please `Download the latest Python 2.7.x
+    <https://www.python.org/downloads/>`_ and install it.
+    **DON'T FORGET** to select ``Add python.exe to Path`` feature on the
+    "Customize" stage.

-Super-Quick (Mac / Linux)
-~~~~~~~~~~~~~~~~~~~~~~~~~
+Please *choose one of* the following installation options:

-To install or upgrade *PlatformIO* paste that at a *Terminal* prompt
-(**you MIGHT need** to run ``sudo`` first, just for installation):
+Python Package Manager
+~~~~~~~~~~~~~~~~~~~~~~
+
+The latest stable version of PlatformIO may be done via
+`pip <https://pip.pypa.io>`_ as follows:

 .. code-block:: bash

-    [sudo] python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
+    # update dependent packages to the latest versions
+    pip install -U pip setuptools
+
+    # 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:
+
+* Run with ``sudo`` to install PlatformIO and dependencies globally
+* Specify the `pip install --user <https://pip.pypa.io/en/stable/user_guide.html#user-installs>`_
+  option to install local to your user
+* Run the command in a `virtualenv <https://virtualenv.pypa.io>`_ local to a
+  specific project working set.
+
+.. _installation_installer_script:
+
+Installer Script
+~~~~~~~~~~~~~~~~
+
+Super-Quick (Mac / Linux)
+'''''''''''''''''''''''''
+
+To install or upgrade *PlatformIO* paste that at a *Terminal* prompt
+(**MAY require** administrator access ``sudo``):
+
+.. code-block:: bash
+
+    python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"


-Installer Script (Mac / Linux / Windows)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Local Download (Mac / Linux / Windows)
+''''''''''''''''''''''''''''''''''''''

-To install or upgrade *PlatformIO*, download
+To install or upgrade *PlatformIO*, download (save as...)
 `get-platformio.py <https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py>`_
-script. Then run the following (**you MIGHT need** to run ``sudo`` first,
-just for installation):
+script. Then run the following (**MAY require** administrator access ``sudo``):

 .. code-block:: bash

@@ -96,53 +113,57 @@ Full Guide

 .. code-block:: bash

-    $ python --version
+    python --version

-*Windows OS* Users only:
+*Windows Users* only:

    * `Download Python 2.7 <https://www.python.org/downloads/>`_ and install it.
-    * Add to PATH system variable ``;C:\Python27;C:\Python27\Scripts;`` and
-       reopen *Command Prompt* (``cmd.exe``) application. Please read this
-       article `How to set the path and environment variables in Windows
-       <http://www.computerhope.com/issues/ch000549.htm>`_.
+    * Add to PATH system variable ``;C:\Python27;C:\Python27\Scripts;`` and reopen *Command Prompt* (``cmd.exe``) application. Please read this article `How to set the path and environment variables in Windows <http://www.computerhope.com/issues/ch000549.htm>`_.

-
-2. Check a ``pip`` tool for installing and managing *Python* packages:
+2. Install a ``platformio`` and related packages:

 .. code-block:: bash

-    $ pip search platformio
-
-You should see short information about ``platformio`` package.
+    pip install -U pip setuptools
+    pip install -U platformio

 If your computer does not recognize ``pip`` command, try to install it first
 using `these instructions <https://pip.pypa.io/en/latest/installing.html>`_.

-3. Install a ``platformio`` and related packages:
+For upgrading ``platformio`` to the latest version:

 .. code-block:: bash

-    $ pip install platformio && pip install --egg scons
-
-For upgrading the ``platformio`` to new version please use this command:
-
-.. code-block:: bash
-
-    $ pip install -U platformio
-
+    pip install -U platformio

 Development Version
 ~~~~~~~~~~~~~~~~~~~

-.. warning::
-    We don't recommend to use ``develop`` version in production.
-
 Install the latest PlatformIO from the ``develop`` branch:

 .. code-block:: bash

-    $ pip install https://github.com/platformio/platformio/archive/develop.zip
+    pip install -U pip setuptools
+    pip install -U https://github.com/platformio/platformio/archive/develop.zip

 If you want to be up-to-date with the latest ``develop`` version of PlatformIO,
 then you need to re-install PlatformIO each time if you see the new commits in
 `PlatformIO GitHub repository (branch: develop) <https://github.com/platformio/platformio/commits/develop>`_.
+
+Troubleshooting
+---------------
+
+.. warning::
+    If you are going to run *PlatformIO* from **subprocess**, you
+    :ref:`MUST DISABLE <faq_troubleshooting_pioblocksprompt>` all prompts.
+    It will allow you to avoid blocking.
+
+.. note::
+    **Linux OS**: 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).
+
+    **Windows OS**: Please check that you have correctly installed USB driver
+    from board manufacturer
+
+For further details, frequently questions, known issues, please
+refer to :ref:`faq`.
--- a/docs/platforms/atmelavr.rst
+++ b/docs/platforms/atmelavr.rst
@@ -78,6 +78,13 @@ Adafruit
      - 32 Kb
      - 2.5 Kb

+    * - ``gemma``
+      - `Adafruit Gemma <http://www.adafruit.com/products/1222>`_
+      - ATTINY85
+      - 8 MHz
+      - 8 Kb
+      - 0.5 Kb
+
    * - ``protrinket3``
      - `Adafruit Pro Trinket 3V/12MHz (USB) <http://www.adafruit.com/products/2010>`_
      - ATMEGA328P
@@ -594,6 +601,26 @@ PanStamp
      - 32 Kb
      - 2 Kb

+Punch Through
+~~~~~~~~~~~~~
+
+.. list-table::
+    :header-rows:  1
+
+    * - Type ``board``
+      - Name
+      - Microcontroller
+      - Frequency
+      - Flash
+      - RAM
+
+    * - ``lightblue-bean``
+      - `LightBlue Bean <https://punchthrough.com/bean>`_
+      - ATMEGA328P
+      - 8 MHz
+      - 32 Kb
+      - 2 Kb
+
 Quirkbot
 ~~~~~~~~

--- a/docs/platforms/creating_platform.rst
+++ b/docs/platforms/creating_platform.rst
@@ -108,9 +108,21 @@ Packages
    * - ``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/>`_

+    * - ``toolchain-gccarmlinuxgnueabi``
+      - `GCC for Linux ARM GNU EABI <https://gcc.gnu.org>`_, `GDB <http://www.gnu.org/software/gdb/>`_
+
    * - ``toolchain-gccarmnoneeabi``
      - `gcc-arm-embedded <https://launchpad.net/gcc-arm-embedded>`_, `GDB <http://www.gnu.org/software/gdb/>`_

+    * - ``toolchain-gcclinux32``
+      - `GCC for Linux i686 <https://gcc.gnu.org>`_
+
+    * - ``toolchain-gcclinux64``
+      - `GCC for Linux x86_64 <https://gcc.gnu.org>`_
+
+    * - ``toolchain-gccmingw32``
+      - `MinGW <http://www.mingw.org>`_
+
    * - ``toolchain-timsp430``
      - `msp-gcc <http://sourceforge.net/projects/mspgcc/>`_, `GDB <http://www.gnu.org/software/gdb/>`_

@@ -200,7 +212,7 @@ Build Script

 Platform's build script is based on a next-generation build tool named
 `SCons <http://www.scons.org>`_. PlatformIO has own built-in firmware builder
-``env.BuildFirmware`` with the nested libraries search. Please look into a
+``env.BuildProgram`` with the nested libraries search. Please look into a
 base template of ``test-builder.py``.

 .. code-block:: python
@@ -260,7 +272,7 @@ base template of ``test-builder.py``.
    #
    # Target: Build executable and linkable firmware
    #
-    target_elf = env.BuildFirmware()
+    target_elf = env.BuildProgram()

    #
    # Target: Build the .bin file
@@ -383,7 +395,7 @@ and copy there two files:
    # Target: Build executable and linkable firmware
    #

-    target_elf = env.BuildFirmware()
+    target_elf = env.BuildProgram()

    #
    # Target: Build the .bin file
--- a/docs/platforms/index.rst
+++ b/docs/platforms/index.rst
@@ -11,6 +11,9 @@ Also it has pre-configured settings for most popular **Embedded Platform
 Boards**. You have no need to specify in :ref:`projectconf` type or frequency of
 MCU, upload protocol or etc. Please use ``board`` option.

+Embedded
+--------
+
 .. toctree::
    :maxdepth: 2

@@ -25,5 +28,24 @@ MCU, upload protocol or etc. Please use ``board`` option.
    teensy
    timsp430
    titiva
+
+Desktop
+-------
+
+.. toctree::
+    :maxdepth: 2
+
+    native
+    linux_arm
+    linux_i686
+    linux_x86_64
+    windows_x86
+
+Own Platform/Board
+------------------
+
+.. toctree::
+    :maxdepth: 2
+
    creating_platform
    creating_board
--- a/docs/platforms/linux_arm.rst
+++ b/docs/platforms/linux_arm.rst
@@ -0,0 +1,21 @@
+.. _platform_linux_arm:
+
+Platform ``linux_arm``
+======================
+Linux ARM is a Unix-like and mostly POSIX-compliant computer operating system (OS) assembled under the model of free and open-source software development and distribution. Using host OS (Mac OS X, Linux ARM) you can build native application for Linux ARM platform.
+
+For more detailed information please visit `vendor site <http://platformio.org/#!/platforms/linux_arm>`_.
+
+.. contents::
+
+Packages
+--------
+
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Contents
+
+    * - ``toolchain-gccarmlinuxgnueabi``
+      - `GCC for Linux ARM GNU EABI <https://gcc.gnu.org>`_, `GDB <http://www.gnu.org/software/gdb/>`_
--- a/docs/platforms/linux_i686.rst
+++ b/docs/platforms/linux_i686.rst
@@ -0,0 +1,21 @@
+.. _platform_linux_i686:
+
+Platform ``linux_i686``
+=======================
+Linux i686 (32-bit) is a Unix-like and mostly POSIX-compliant computer operating system (OS) assembled under the model of free and open-source software development and distribution. Using host OS (Mac OS X or Linux 32-bit) you can build native application for Linux i686 platform.
+
+For more detailed information please visit `vendor site <http://platformio.org/#!/platforms/linux_i686>`_.
+
+.. contents::
+
+Packages
+--------
+
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Contents
+
+    * - ``toolchain-gcclinux32``
+      - `GCC for Linux i686 <https://gcc.gnu.org>`_
--- a/docs/platforms/linux_x86_64.rst
+++ b/docs/platforms/linux_x86_64.rst
@@ -0,0 +1,21 @@
+.. _platform_linux_x86_64:
+
+Platform ``linux_x86_64``
+=========================
+Linux x86_64 (64-bit) is a Unix-like and mostly POSIX-compliant computer operating system (OS) assembled under the model of free and open-source software development and distribution. Using host OS (Mac OS X or Linux 64-bit) you can build native application for Linux x86_64 platform.
+
+For more detailed information please visit `vendor site <http://platformio.org/#!/platforms/linux_i686>`_.
+
+.. contents::
+
+Packages
+--------
+
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Contents
+
+    * - ``toolchain-gcclinux64``
+      - `GCC for Linux x86_64 <https://gcc.gnu.org>`_
--- a/docs/platforms/native.rst
+++ b/docs/platforms/native.rst
@@ -0,0 +1,9 @@
+.. _platform_native:
+
+Platform ``native``
+===================
+Native development platform is intended to be used for desktop OS. This platform uses built-in tool chains (preferable based on GCC), frameworks, libs from particular OS where it will be run.
+
+For more detailed information please visit `vendor site <http://platformio.org/#!/platforms/native>`_.
+
+.. contents::
--- a/docs/platforms/ststm32.rst
+++ b/docs/platforms/ststm32.rst
@@ -256,6 +256,13 @@ ST
      - 512 Kb
      - 128 Kb

+    * - ``nucleo_f446re``
+      - `ST Nucleo F446RE <https://developer.mbed.org/platforms/ST-Nucleo-F446RE/>`_
+      - STM32F446RET6
+      - 180 MHz
+      - 512 Kb
+      - 128 Kb
+
    * - ``nucleo_l053r8``
      - `ST Nucleo L053R8 <https://developer.mbed.org/platforms/ST-Nucleo-L053R8/>`_
      - STM32L053R8T6
--- a/docs/platforms/windows_x86.rst
+++ b/docs/platforms/windows_x86.rst
@@ -0,0 +1,21 @@
+.. _platform_windows_x86:
+
+Platform ``windows_x86``
+========================
+Windows x86 (32-bit) is a metafamily of graphical operating systems developed and marketed by Microsoft. Using host OS (Windows, Linux 32/64 or Mac OS X) you can build native application for Windows x86 platform.
+
+For more detailed information please visit `vendor site <http://platformio.org/#!/platforms/windows_x86>`_.
+
+.. contents::
+
+Packages
+--------
+
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Contents
+
+    * - ``toolchain-gccmingw32``
+      - `MinGW <http://www.mingw.org>`_
--- a/docs/projectconf.rst
+++ b/docs/projectconf.rst
@@ -42,7 +42,7 @@ A default value is User's home directory:
 * Windows ``%HOMEPATH%\.platformio``

 This option can be overridden by global environment variable
-:ref:`envvar_PLATFORMIO_HOME_DIR`.
+:envvar:`PLATFORMIO_HOME_DIR`.

 .. _projectconf_pio_lib_dir:

@@ -55,7 +55,7 @@ This directory is used to store external libraries downloaded by
 A default value is ``%home_dir%/lib``.

 This option can be overridden by global environment variable
-:ref:`envvar_PLATFORMIO_LIB_DIR`.
+:envvar:`PLATFORMIO_LIB_DIR`.

 .. note::
    You can put here your own/private libraries. The source code of each
@@ -73,7 +73,7 @@ command.
 A default value is ``%project_dir%/src``.

 This option can be overridden by global environment variable
-:ref:`envvar_PLATFORMIO_SRC_DIR`.
+:envvar:`PLATFORMIO_SRC_DIR`.

 .. note::
    This option is useful for people who migrate from Arduino/Energia IDEs where
@@ -97,7 +97,7 @@ next build operation.
 A default value is ``%project_dir%/.pioenvs``.

 This option can be overridden by global environment variable
-:ref:`envvar_PLATFORMIO_ENVS_DIR`.
+:envvar:`PLATFORMIO_ENVS_DIR`.

 .. note::
    If you have any problems with building your Project environmets which
@@ -267,7 +267,7 @@ processes:
        ``-l``.

 This option can be set by global environment variable
-:ref:`envvar_PLATFORMIO_BUILD_FLAGS`.
+:envvar:`PLATFORMIO_BUILD_FLAGS`.

 Example:

@@ -309,7 +309,7 @@ but will be applied only for the project source code from
 :ref:`projectconf_pio_src_dir` directory.

 This option can be set by global environment variable
-:ref:`envvar_PLATFORMIO_SRC_BUILD_FLAGS`.
+:envvar:`PLATFORMIO_SRC_BUILD_FLAGS`.

 .. _projectconf_src_filter:

@@ -331,7 +331,7 @@ By default, ``src_filter`` is predefined to
 exclude ``.git`` and ``svn`` repository folders and exclude ``examples`` folder.

 This option can be set by global environment variable
-:ref:`envvar_PLATFORMIO_SRC_FILTER`.
+:envvar:`PLATFORMIO_SRC_FILTER`.

 ``lib_install``
 ^^^^^^^^^^^^^^^
@@ -404,7 +404,7 @@ section of
 `SCons documentation <http://www.scons.org/doc/production/HTML/scons-user.html#chap-environments>`_.

 This option can be set by global environment variable
-:ref:`envvar_PLATFORMIO_EXTRA_SCRIPT`.
+:envvar:`PLATFORMIO_EXTRA_SCRIPT`.

 Example, specify own upload command for :ref:`platform_atmelavr`:

@@ -435,14 +435,8 @@ See built-in examples of `PlatformIO build scripts <https://github.com/platformi
 ^^^^^^^^^^^

 A list with targets which will be processed by :ref:`cmd_run` command by
-default. You can enter more then one target separated with "space".
-
-Pre-built targets:
-
-* ``clean`` delete compiled object files, libraries and firmware binaries
-* ``upload`` enable "auto-uploading" for embedded platforms after building
-  operation
-* ``envdump`` dump current build environment
+default. You can enter more then one target separated with "space". Which
+targets are supported is described in :option:`platformio run --target`.

 **Tip!** You can use these targets like an option to
 :option:`platformio run --target` command. For example:
@@ -481,39 +475,7 @@ Examples
    targets = upload


-2. :ref:`platform_atmelavr`: Microduino Core (ATmega168P, 3.3V) board with
-   auto pre-configured ``board_*`` and ``upload_*`` options (use only
-   ``board`` option) and Arduino Wiring-based Framework
-
-.. code-block:: ini
-
-    [env:atmelavr_microduino_core_board]
-    platform = atmelavr
-    framework = arduino
-    board = 168pa8m
-
-    # enable auto-uploading
-    targets = upload
-
-
-3. :ref:`platform_atmelavr`: Raspduino board with
-   auto pre-configured ``board_*`` and ``upload_*`` options (use only
-   ``board`` option) and Arduino Wiring-based Framework
-
-.. code-block:: ini
-
-    [env:atmelavr_raspduino_board]
-    platform = atmelavr
-    framework = arduino
-    board = raspduino
-
-    upload_port = /dev/ttyS0
-
-    # enable auto-uploading
-    targets = upload
-
-
-4. :ref:`platform_atmelavr`: Embedded board that is based on ATmega168 MCU with
+2. :ref:`platform_atmelavr`: Embedded board that is based on ATmega168 MCU with
   "arduino" bootloader

 .. code-block:: ini
@@ -533,7 +495,7 @@ Examples
    targets = upload


-5. Upload firmware via USB programmer (USBasp) to :ref:`platform_atmelavr`
+3. Upload firmware via USB programmer (USBasp) to :ref:`platform_atmelavr`
   microcontrollers

 .. code-block:: ini
@@ -542,44 +504,25 @@ Examples
    platform = atmelavr
    framework = arduino
    board = pro8MHzatmega328
-    upload_protocol = usbasp -B5
+    upload_protocol = usbasp -  B5


-6. :ref:`platform_timsp430`: TI MSP430G2553 LaunchPad with auto pre-configured
-   ``board_*`` and ``upload_*`` options (use only ``board`` option) and Energia
-   Wiring-based Framework
+4. :ref:`platform_ststm32`: Upload firmware using GDB script ``upload.gdb``,
+   `issue #175 <https://github.com/platformio/platformio/issues/175>`_

 .. code-block:: ini

-    [env:timsp430_g2553_launchpad]
-    platform = timsp430
-    framework = energia
-    board = lpmsp430g2553
+    [env:st_via_gdb]
+    platform = ststm32
+    board = armstrap_eagle512
+    upload_protocol = gdb

-
-7. :ref:`platform_timsp430`: Embedded board that is based on MSP430G2553 MCU
+5. :ref:`platform_ststm32`: Upload firmware using ST-Link instead mbed's media
+   disk

 .. code-block:: ini

-    [env:timsp430_g2553_board]
-    platform = timsp430
-    board_mcu = msp430g2553
-    board_f_cpu = 16000000L
-
-    upload_protocol = rf2500
-
-    # enable auto-uploading
-    targets = upload
-
-
-8. :ref:`platform_titiva`: TI Tiva C ARM Series TM4C123G LaunchPad with auto
-   pre-configured ``board_*`` and ``upload_*`` options (use only ``board``
-   option) and Energia Wiring-based Framework
-
-.. code-block:: ini
-
-    [env:titiva_tm4c1230c3pm_launchpad]
-    platform = titiva
-    framework = energia
-    board = lptm4c1230c3pm
-
+    [env:stlink_for_mbed]
+    platform = ststm32
+    board = disco_f100rb
+    upload_protocol = stlink
--- a/docs/quickstart.rst
+++ b/docs/quickstart.rst
@@ -29,7 +29,7 @@ Quickstart
    The next files/directories will be created in ***
    platformio.ini - Project Configuration File. |-> PLEASE EDIT ME <-|
    src - Put your source code here
-    lib - Put here project specific or 3-rd party libraries
+    lib - Put here project specific (private) libraries
    Do you want to continue? [y/N]: y
    Project has been successfully initialized!
    Useful commands:
--- a/docs/userguide/cmd_init.rst
+++ b/docs/userguide/cmd_init.rst
@@ -23,8 +23,12 @@ This command will create:

 * :ref:`projectconf`
 * ``src`` - a source directory. Put your source code here
-* ``lib`` - a directory for the project specific libraries. PlatformIO will
-  compile them to static libraries and link to executable file
+* ``lib`` - a directory for the project specific (private) libraries.
+  PlatformIO will compile them to static libraries and link to executable file
+
+.. note::
+    The source code of each library should be placed in separate directory.
+    For example, ``lib/private_lib/[here are source files]``.

 Options
 -------
@@ -70,11 +74,11 @@ allows you to disable firmware auto-uploading by default.
    --env-prefix

 An environment prefix which will be used with pair in board type.
-
 For example, the default environment name for ``teensy_31`` board will
 be ``[env:teensy_31]``.


+
 Examples
 --------

@@ -91,7 +95,7 @@ Examples
    The next files/directories will be created in ***
    platformio.ini - Project Configuration File. |-> PLEASE EDIT ME <-|
    src - Put your source code here
-    lib - Put here project specific or 3-rd party libraries
+    lib - Put here project specific (private) libraries
    Do you want to continue? [y/N]: y
    Project has been successfully initialized!
    Useful commands:
@@ -109,7 +113,7 @@ Examples
    The next files/directories will be created in ***
     platformio.ini - Project Configuration File. |-> PLEASE EDIT ME <-|
    src - Put your source code here
-    lib - Put here project specific or 3-rd party libraries
+    lib - Put here project specific (private) libraries
    Do you want to continue? [y/N]: y
    Project has been successfully initialized!
    Useful commands:
@@ -133,7 +137,7 @@ Examples
    The next files/directories will be created in ***
    platformio.ini - Project Configuration File. |-> PLEASE EDIT ME <-|
    src - Put your source code here
-    lib - Put here project specific or 3-rd party libraries
+    lib - Put here project specific (private) libraries
    Do you want to continue? [y/N]: y
    Project has been successfully initialized!
    Useful commands:
--- a/docs/userguide/cmd_run.rst
+++ b/docs/userguide/cmd_run.rst
@@ -33,7 +33,16 @@ Process specified environments
 .. option::
    -t, --target

-Process specified targets
+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
+* ``uploadlazy`` upload existing firmware without project rebuilding
+* ``envdump`` dump current build environment
+* ``size`` print the size of the sections in a firmware/program

 .. option::
    --upload-port
@@ -42,10 +51,10 @@ Upload port of embedded board. To print all available ports use
 :ref:`cmd_serialports` command

 .. option::
-    --build-dir
+    -d, --project-dir

-Specify the path to project directory. By default, ``--build-dir`` is equal to
-current working directory (``CWD``).
+Specify the path to project directory. By default, ``--project-dir`` is equal
+to current working directory (``CWD``).

 .. option::
    -v, --verbose
--- a/docs/userguide/index.rst
+++ b/docs/userguide/index.rst
@@ -18,7 +18,7 @@ Options
 .. program:: platformio

 .. option::
-    --force, - f
+    --force, -f

 Force to accept any confirmation prompts. This option allows to avoid an issue
 with :ref:`faq_troubleshooting_pioblocksprompt`
@@ -29,7 +29,7 @@ with :ref:`faq_troubleshooting_pioblocksprompt`
 Show the version of PlatformIO

 .. option::
-    --help
+    --help, -h

 Show help for the available options and commands

--- a/docs/userguide/platforms/index.rst
+++ b/docs/userguide/platforms/index.rst
@@ -1,7 +1,7 @@
 .. _userguide_platforms:

-Platforms Manager
-=================
+Platform Manager
+================

 To print all available commands and options use:

--- a/examples/atmelavr-and-arduino/adafruit-blink/lib/readme.txt
+++ b/examples/atmelavr-and-arduino/adafruit-blink/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/atmelavr-and-arduino/arduino-external-libs/lib/readme.txt
+++ b/examples/atmelavr-and-arduino/arduino-external-libs/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/atmelavr-and-arduino/arduino-internal-libs/lib/readme.txt
+++ b/examples/atmelavr-and-arduino/arduino-internal-libs/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/atmelavr-and-arduino/arduino-own-src_dir/lib/readme.txt
+++ b/examples/atmelavr-and-arduino/arduino-own-src_dir/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/atmelavr-and-arduino/atmelavr-native-blink/lib/readme.txt
+++ b/examples/atmelavr-and-arduino/atmelavr-native-blink/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/atmelavr-and-arduino/digitstump-mouse/lib/readme.txt
+++ b/examples/atmelavr-and-arduino/digitstump-mouse/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/atmelavr-and-arduino/engduino-magnetometer/lib/readme.txt
+++ b/examples/atmelavr-and-arduino/engduino-magnetometer/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/atmelavr-and-arduino/panstamp-blink/lib/readme.txt
+++ b/examples/atmelavr-and-arduino/panstamp-blink/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/desktop/hello-world/README.rst
+++ b/examples/desktop/hello-world/README.rst
@@ -0,0 +1,18 @@
+How to build PlatformIO based project
+=====================================
+
+1. `Install PlatformIO <http://docs.platformio.org/en/latest/installation.html>`_
+2. Download `source code with examples <https://github.com/platformio/platformio/archive/develop.zip>`_
+3. Extract ZIP archive
+4. Run these commands:
+
+.. code-block:: bash
+
+    # Change directory to example
+    > cd platformio-develop/examples/desktop/hello-world
+
+    # Process example project
+    > platformio run
+
+    # Clean build files
+    > platformio run --target clean
--- a/examples/desktop/hello-world/lib/readme.txt
+++ b/examples/desktop/hello-world/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/desktop/hello-world/platformio.ini
+++ b/examples/desktop/hello-world/platformio.ini
@@ -0,0 +1,51 @@
+#
+# Project Configuration File
+#
+# A detailed documentation with the EXAMPLES is located here:
+# http://docs.platformio.org/en/latest/projectconf.html
+#
+
+# A sign `#` at the beginning of the line indicates a comment
+# Comment lines are ignored.
+
+# Simple and base environment
+# [env:mybaseenv]
+# platform = %INSTALLED_PLATFORM_NAME_HERE%
+# framework =
+# board =
+#
+# Automatic targets - enable auto-uploading
+# targets = upload
+
+[env:native]
+platform = native
+
+#
+# If host OS is Mac OS X
+#
+
+# [env:darwin_x86_64]
+# platform = native
+
+# [env:linux_i686]
+# platform = linux_i686
+
+# [env:linux_x86_64]
+# platform = linux_x86_64
+
+# [env:windows_x86]
+# platform = windows_x86
+
+# [env:linux_armv6l]
+# platform = linux_arm
+# build_flags = -march=armv6
+
+#
+# If host OS is Linux
+#
+
+# [env:linux_i686]
+# platform = linux_i686
+
+# [env:linux_x86_64]
+# platform = linux_x86_64
--- a/examples/desktop/hello-world/src/main.c
+++ b/examples/desktop/hello-world/src/main.c
@@ -0,0 +1,7 @@
+#include <stdio.h>
+
+int main()
+{
+    printf("Hello World from PlatformIO!\n");
+    return 0;
+}
--- a/examples/espressif/esp8266-native/lib/readme.txt
+++ b/examples/espressif/esp8266-native/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/espressif/esp8266-webserver/lib/readme.txt
+++ b/examples/espressif/esp8266-webserver/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/espressif/esp8266-wifiscan/lib/readme.txt
+++ b/examples/espressif/esp8266-wifiscan/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/ide-eclipse/README.rst
+++ b/examples/ide-eclipse/README.rst
@@ -1,14 +0,0 @@
-Eclipse IDE Integration
-=======================
-
-The detailed information and steps are described in this article:
-`Building and debugging Atmel AVR (Arduino-based) project using Eclipse IDE+PlatformIO <http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio>`_.
-
-
-.. image:: http://www.ikravets.com/wp-content/uploads/2014/06/eclipse_platformio_build_arduino_uno.png
-    :width: 850px
-    :target: http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio
-
-.. image:: http://www.ikravets.com/wp-content/uploads/2014/06/eclipse_debugging_result_1-1024x775.png
-    :width: 850px
-    :target: http://www.ikravets.com/computer-life/programming/2014/06/20/building-and-debugging-atmel-avr-arduino-based-project-using-eclipse-ideplatformio
--- a/examples/ide-eclipse/arduino_pro5/src/main.c
+++ b/examples/ide-eclipse/arduino_pro5/src/main.c
@@ -1,20 +0,0 @@
-/**
- * Copyright (C) Ivan Kravets <me@ikravets.com>
- * See LICENSE for details.
- */
-
-#include "Arduino.h"
-#define WLED	13  // Most Arduino boards already have an LED attached to pin 13 on the board itself
-
-void setup()
-{
-  pinMode(WLED, OUTPUT);  // set pin as output
-}
-
-void loop()
-{
-  digitalWrite(WLED, HIGH);  // set the LED on
-  delay(1000);               // wait for a second
-  digitalWrite(WLED, LOW);   // set the LED off
-  delay(1000);               // wait for a second
-}
--- a/examples/ide-eclipse/atmelavr_atmega168/.cproject
+++ b/examples/ide-eclipse/atmelavr_atmega168/.cproject
@@ -1,76 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<?fileVersion 4.0.0?><cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
-	<storageModule moduleId="org.eclipse.cdt.core.settings">
-		<cconfiguration id="0.1706826288">
-			<storageModule buildSystemId="org.eclipse.cdt.managedbuilder.core.configurationDataProvider" id="0.1706826288" moduleId="org.eclipse.cdt.core.settings" name="Default">
-				<externalSettings/>
-				<extensions>
-					<extension id="org.eclipse.cdt.core.VCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.GmakeErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.CWDLocator" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.GCCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.GASErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.GLDErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.ELF" point="org.eclipse.cdt.core.BinaryParser"/>
-				</extensions>
-			</storageModule>
-			<storageModule moduleId="cdtBuildSystem" version="4.0.0">
-				<configuration artifactName="${ProjName}" buildProperties="" description="" id="0.1706826288" name="Default" parent="org.eclipse.cdt.build.core.prefbase.cfg">
-					<folderInfo id="0.1706826288." name="/" resourcePath="">
-						<toolChain id="org.eclipse.cdt.build.core.prefbase.toolchain.944229927" name="No ToolChain" resourceTypeBasedDiscovery="false" superClass="org.eclipse.cdt.build.core.prefbase.toolchain">
-							<targetPlatform binaryParser="org.eclipse.cdt.core.ELF" id="org.eclipse.cdt.build.core.prefbase.toolchain.944229927.1146791472" name=""/>
-							<builder cleanBuildTarget="run --target clean" command="platformio" id="org.eclipse.cdt.build.core.settings.default.builder.81097189" incrementalBuildTarget="run" keepEnvironmentInBuildfile="false" managedBuildOn="false" name="Gnu Make Builder" superClass="org.eclipse.cdt.build.core.settings.default.builder"/>
-							<tool id="org.eclipse.cdt.build.core.settings.holder.libs.615700392" name="holder for library settings" superClass="org.eclipse.cdt.build.core.settings.holder.libs"/>
-							<tool id="org.eclipse.cdt.build.core.settings.holder.509191184" name="Assembly" superClass="org.eclipse.cdt.build.core.settings.holder">
-								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.1976688999" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-atmelavr/avr/include&quot;"/>
-								</option>
-								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.1146079252" name="Symbols" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
-									<listOptionValue builtIn="false" value="__AVR_ATmega168__"/>
-								</option>
-								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.1061741986" languageId="org.eclipse.cdt.core.assembly" languageName="Assembly" sourceContentType="org.eclipse.cdt.core.asmSource" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
-							</tool>
-							<tool id="org.eclipse.cdt.build.core.settings.holder.524184308" name="GNU C++" superClass="org.eclipse.cdt.build.core.settings.holder">
-								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.1379816017" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/tools/toolchain/avr/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-atmelavr/avr/include&quot;"/>
-								</option>
-								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.1180078676" name="Symbols" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
-									<listOptionValue builtIn="false" value="__AVR_ATmega168__"/>
-								</option>
-								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.492516621" languageId="org.eclipse.cdt.core.g++" languageName="GNU C++" sourceContentType="org.eclipse.cdt.core.cxxSource,org.eclipse.cdt.core.cxxHeader" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
-							</tool>
-							<tool id="org.eclipse.cdt.build.core.settings.holder.746817635" name="GNU C" superClass="org.eclipse.cdt.build.core.settings.holder">
-								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.905883681" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/tools/toolchain/avr/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-atmelavr/avr/include&quot;"/>
-								</option>
-								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.1589314232" name="Symbols" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
-									<listOptionValue builtIn="false" value="__AVR_ATmega168__"/>
-								</option>
-								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.247974714" languageId="org.eclipse.cdt.core.gcc" languageName="GNU C" sourceContentType="org.eclipse.cdt.core.cSource,org.eclipse.cdt.core.cHeader" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
-							</tool>
-						</toolChain>
-					</folderInfo>
-				</configuration>
-			</storageModule>
-			<storageModule moduleId="org.eclipse.cdt.core.externalSettings"/>
-		</cconfiguration>
-	</storageModule>
-	<storageModule moduleId="cdtBuildSystem" version="4.0.0">
-		<project id="test.null.312168076" name="test"/>
-	</storageModule>
-	<storageModule moduleId="scannerConfiguration">
-		<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
-		<scannerConfigBuildInfo instanceId="0.1706826288">
-			<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
-		</scannerConfigBuildInfo>
-	</storageModule>
-	<storageModule moduleId="org.eclipse.cdt.core.LanguageSettingsProviders"/>
-	<storageModule moduleId="refreshScope" versionNumber="2">
-		<configuration configurationName="Default">
-			<resource resourceType="PROJECT" workspacePath="/test"/>
-		</configuration>
-	</storageModule>
-	<storageModule moduleId="org.eclipse.cdt.internal.ui.text.commentOwnerProjectMappings"/>
-</cproject>
--- a/examples/ide-eclipse/atmelavr_atmega168/.project
+++ b/examples/ide-eclipse/atmelavr_atmega168/.project
@@ -1,27 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<projectDescription>
-	<name>atmelavr_atmega168</name>
-	<comment></comment>
-	<projects>
-	</projects>
-	<buildSpec>
-		<buildCommand>
-			<name>org.eclipse.cdt.managedbuilder.core.genmakebuilder</name>
-			<triggers>clean,full,incremental,</triggers>
-			<arguments>
-			</arguments>
-		</buildCommand>
-		<buildCommand>
-			<name>org.eclipse.cdt.managedbuilder.core.ScannerConfigBuilder</name>
-			<triggers>full,incremental,</triggers>
-			<arguments>
-			</arguments>
-		</buildCommand>
-	</buildSpec>
-	<natures>
-		<nature>org.eclipse.cdt.core.cnature</nature>
-		<nature>org.eclipse.cdt.core.ccnature</nature>
-		<nature>org.eclipse.cdt.managedbuilder.core.managedBuildNature</nature>
-		<nature>org.eclipse.cdt.managedbuilder.core.ScannerConfigNature</nature>
-	</natures>
-</projectDescription>
--- a/examples/ide-eclipse/atmelavr_atmega168/.settings/org.eclipse.cdt.codan.core.prefs
+++ b/examples/ide-eclipse/atmelavr_atmega168/.settings/org.eclipse.cdt.codan.core.prefs
@@ -1,67 +0,0 @@
-eclipse.preferences.version=1
-org.eclipse.cdt.codan.checkers.errnoreturn=Warning
-org.eclipse.cdt.codan.checkers.errnoreturn.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true},implicit\=>false}
-org.eclipse.cdt.codan.checkers.errreturnvalue=Error
-org.eclipse.cdt.codan.checkers.errreturnvalue.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.checkers.noreturn=Error
-org.eclipse.cdt.codan.checkers.noreturn.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true},implicit\=>false}
-org.eclipse.cdt.codan.internal.checkers.AbstractClassCreation=Error
-org.eclipse.cdt.codan.internal.checkers.AbstractClassCreation.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.AmbiguousProblem=Error
-org.eclipse.cdt.codan.internal.checkers.AmbiguousProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.AssignmentInConditionProblem=Warning
-org.eclipse.cdt.codan.internal.checkers.AssignmentInConditionProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.AssignmentToItselfProblem=Error
-org.eclipse.cdt.codan.internal.checkers.AssignmentToItselfProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.CaseBreakProblem=Warning
-org.eclipse.cdt.codan.internal.checkers.CaseBreakProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true},no_break_comment\=>"no break",last_case_param\=>false,empty_case_param\=>false}
-org.eclipse.cdt.codan.internal.checkers.CatchByReference=Warning
-org.eclipse.cdt.codan.internal.checkers.CatchByReference.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true},unknown\=>false,exceptions\=>()}
-org.eclipse.cdt.codan.internal.checkers.CircularReferenceProblem=Error
-org.eclipse.cdt.codan.internal.checkers.CircularReferenceProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.ClassMembersInitialization=Warning
-org.eclipse.cdt.codan.internal.checkers.ClassMembersInitialization.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true},skip\=>true}
-org.eclipse.cdt.codan.internal.checkers.FieldResolutionProblem=Error
-org.eclipse.cdt.codan.internal.checkers.FieldResolutionProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.FunctionResolutionProblem=Error
-org.eclipse.cdt.codan.internal.checkers.FunctionResolutionProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.InvalidArguments=Error
-org.eclipse.cdt.codan.internal.checkers.InvalidArguments.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.InvalidTemplateArgumentsProblem=Error
-org.eclipse.cdt.codan.internal.checkers.InvalidTemplateArgumentsProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.LabelStatementNotFoundProblem=Error
-org.eclipse.cdt.codan.internal.checkers.LabelStatementNotFoundProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.MemberDeclarationNotFoundProblem=Error
-org.eclipse.cdt.codan.internal.checkers.MemberDeclarationNotFoundProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.MethodResolutionProblem=Error
-org.eclipse.cdt.codan.internal.checkers.MethodResolutionProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.NamingConventionFunctionChecker=-Info
-org.eclipse.cdt.codan.internal.checkers.NamingConventionFunctionChecker.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true},pattern\=>"^[a-z]",macro\=>true,exceptions\=>()}
-org.eclipse.cdt.codan.internal.checkers.NonVirtualDestructorProblem=Warning
-org.eclipse.cdt.codan.internal.checkers.NonVirtualDestructorProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.OverloadProblem=Error
-org.eclipse.cdt.codan.internal.checkers.OverloadProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.RedeclarationProblem=Error
-org.eclipse.cdt.codan.internal.checkers.RedeclarationProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.RedefinitionProblem=Error
-org.eclipse.cdt.codan.internal.checkers.RedefinitionProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.ReturnStyleProblem=-Warning
-org.eclipse.cdt.codan.internal.checkers.ReturnStyleProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.ScanfFormatStringSecurityProblem=-Warning
-org.eclipse.cdt.codan.internal.checkers.ScanfFormatStringSecurityProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.StatementHasNoEffectProblem=Warning
-org.eclipse.cdt.codan.internal.checkers.StatementHasNoEffectProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true},macro\=>true,exceptions\=>()}
-org.eclipse.cdt.codan.internal.checkers.SuggestedParenthesisProblem=Warning
-org.eclipse.cdt.codan.internal.checkers.SuggestedParenthesisProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true},paramNot\=>false}
-org.eclipse.cdt.codan.internal.checkers.SuspiciousSemicolonProblem=Warning
-org.eclipse.cdt.codan.internal.checkers.SuspiciousSemicolonProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true},else\=>false,afterelse\=>false}
-org.eclipse.cdt.codan.internal.checkers.TypeResolutionProblem=Error
-org.eclipse.cdt.codan.internal.checkers.TypeResolutionProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
-org.eclipse.cdt.codan.internal.checkers.UnusedFunctionDeclarationProblem=Warning
-org.eclipse.cdt.codan.internal.checkers.UnusedFunctionDeclarationProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true},macro\=>true}
-org.eclipse.cdt.codan.internal.checkers.UnusedStaticFunctionProblem=Warning
-org.eclipse.cdt.codan.internal.checkers.UnusedStaticFunctionProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true},macro\=>true}
-org.eclipse.cdt.codan.internal.checkers.UnusedVariableDeclarationProblem=Warning
-org.eclipse.cdt.codan.internal.checkers.UnusedVariableDeclarationProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true},macro\=>true,exceptions\=>("@(\#)","$Id")}
-org.eclipse.cdt.codan.internal.checkers.VariableResolutionProblem=Error
-org.eclipse.cdt.codan.internal.checkers.VariableResolutionProblem.params={launchModes\=>{RUN_ON_FULL_BUILD\=>true,RUN_ON_INC_BUILD\=>true,RUN_ON_FILE_OPEN\=>false,RUN_ON_FILE_SAVE\=>false,RUN_AS_YOU_TYPE\=>true,RUN_ON_DEMAND\=>true}}
--- a/examples/ide-eclipse/atmelavr_atmega168/platformio.ini
+++ b/examples/ide-eclipse/atmelavr_atmega168/platformio.ini
@@ -1,28 +0,0 @@
-#
-# Project Configuration File
-#
-# A detailed documentation with the EXAMPLES is located here:
-# http://docs.platformio.org/en/latest/projectconf.html
-#
-
-# A sign `#` at the beginning of the line indicates a comment
-# Comment lines are ignored.
-
-# Simple and base environment
-# [env:mybaseenv]
-# platform = %INSTALLED_PLATFORM_NAME_HERE%
-# framework =
-# board =
-#
-# Automatic targets - enable auto-uploading
-# targets = upload
-
-[env:atmelavr_atmega168]
-platform = atmelavr
-board_mcu = atmega168
-board_f_cpu = 16000000L
-
-upload_protocol = arduino
-upload_speed = 19200
-
-# targets = upload
--- a/examples/ide-eclipse/atmelavr_atmega168/src/main.c
+++ b/examples/ide-eclipse/atmelavr_atmega168/src/main.c
@@ -1,23 +0,0 @@
-/**
- * Copyright (C) Ivan Kravets <me@ikravets.com>
- * See LICENSE for details.
- */
-
-#include <avr/io.h>
-#include <util/delay.h>
-
-int main(void)
-{
-    // make the LED pin an output for PORTB5
-    DDRB = 1 << 5;
-
-    while (1)
-    {
-        _delay_ms(500);
-
-        // toggle the LED
-        PORTB ^= 1 << 5;
-    }
-
-    return 0;
-}
--- a/examples/ide-eclipse/tilaunchpad_msp430g2/.cproject
+++ b/examples/ide-eclipse/tilaunchpad_msp430g2/.cproject
@@ -1,69 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<?fileVersion 4.0.0?><cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
-	<storageModule moduleId="org.eclipse.cdt.core.settings">
-		<cconfiguration id="0.1778616297">
-			<storageModule buildSystemId="org.eclipse.cdt.managedbuilder.core.configurationDataProvider" id="0.1778616297" moduleId="org.eclipse.cdt.core.settings" name="Default">
-				<externalSettings/>
-				<extensions>
-					<extension id="org.eclipse.cdt.core.VCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.GmakeErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.CWDLocator" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.GCCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.GASErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.GLDErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.ELF" point="org.eclipse.cdt.core.BinaryParser"/>
-				</extensions>
-			</storageModule>
-			<storageModule moduleId="cdtBuildSystem" version="4.0.0">
-				<configuration artifactName="${ProjName}" buildProperties="" description="" id="0.1778616297" name="Default" parent="org.eclipse.cdt.build.core.prefbase.cfg">
-					<folderInfo id="0.1778616297." name="/" resourcePath="">
-						<toolChain id="org.eclipse.cdt.build.core.prefbase.toolchain.576447412" name="No ToolChain" resourceTypeBasedDiscovery="false" superClass="org.eclipse.cdt.build.core.prefbase.toolchain">
-							<targetPlatform binaryParser="org.eclipse.cdt.core.ELF" id="org.eclipse.cdt.build.core.prefbase.toolchain.576447412.203226592" name=""/>
-							<builder cleanBuildTarget="run --target clean" command="platformio" id="org.eclipse.cdt.build.core.settings.default.builder.592280532" incrementalBuildTarget="run" keepEnvironmentInBuildfile="false" managedBuildOn="false" name="Gnu Make Builder" superClass="org.eclipse.cdt.build.core.settings.default.builder"/>
-							<tool id="org.eclipse.cdt.build.core.settings.holder.libs.251286138" name="holder for library settings" superClass="org.eclipse.cdt.build.core.settings.holder.libs"/>
-							<tool id="org.eclipse.cdt.build.core.settings.holder.1824859462" name="Assembly" superClass="org.eclipse.cdt.build.core.settings.holder">
-								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.2021826184" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-timsp430/msp430/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/framework-energiamsp430/cores/msp430&quot;"/>
-								</option>
-								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.1509314343" languageId="org.eclipse.cdt.core.assembly" languageName="Assembly" sourceContentType="org.eclipse.cdt.core.asmSource" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
-							</tool>
-							<tool id="org.eclipse.cdt.build.core.settings.holder.1251065831" name="GNU C++" superClass="org.eclipse.cdt.build.core.settings.holder">
-								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.1876118829" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/timsp430/tools/toolchain/msp430/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-timsp430/msp430/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/framework-energiamsp430/cores/msp430&quot;"/>
-								</option>
-								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.518683230" languageId="org.eclipse.cdt.core.g++" languageName="GNU C++" sourceContentType="org.eclipse.cdt.core.cxxSource,org.eclipse.cdt.core.cxxHeader" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
-							</tool>
-							<tool id="org.eclipse.cdt.build.core.settings.holder.847615484" name="GNU C" superClass="org.eclipse.cdt.build.core.settings.holder">
-								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.1922525168" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/timsp430/tools/toolchain/msp430/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-timsp430/msp430/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/framework-energiamsp430/cores/msp430&quot;"/>
-								</option>
-								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.68822385" languageId="org.eclipse.cdt.core.gcc" languageName="GNU C" sourceContentType="org.eclipse.cdt.core.cSource,org.eclipse.cdt.core.cHeader" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
-							</tool>
-						</toolChain>
-					</folderInfo>
-				</configuration>
-			</storageModule>
-			<storageModule moduleId="org.eclipse.cdt.core.externalSettings"/>
-		</cconfiguration>
-	</storageModule>
-	<storageModule moduleId="cdtBuildSystem" version="4.0.0">
-		<project id="tilaunchpad_msp430g2.null.26341321" name="tilaunchpad_msp430g2"/>
-	</storageModule>
-	<storageModule moduleId="scannerConfiguration">
-		<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
-		<scannerConfigBuildInfo instanceId="0.1778616297">
-			<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
-		</scannerConfigBuildInfo>
-	</storageModule>
-	<storageModule moduleId="org.eclipse.cdt.core.LanguageSettingsProviders"/>
-	<storageModule moduleId="refreshScope" versionNumber="2">
-		<configuration configurationName="Default">
-			<resource resourceType="PROJECT" workspacePath="/tilaunchpad_msp430g2"/>
-		</configuration>
-	</storageModule>
-</cproject>
--- a/examples/ide-eclipse/tilaunchpad_msp430g2/.project
+++ b/examples/ide-eclipse/tilaunchpad_msp430g2/.project
@@ -1,27 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<projectDescription>
-	<name>tilaunchpad_msp430g2</name>
-	<comment></comment>
-	<projects>
-	</projects>
-	<buildSpec>
-		<buildCommand>
-			<name>org.eclipse.cdt.managedbuilder.core.genmakebuilder</name>
-			<triggers>clean,full,incremental,</triggers>
-			<arguments>
-			</arguments>
-		</buildCommand>
-		<buildCommand>
-			<name>org.eclipse.cdt.managedbuilder.core.ScannerConfigBuilder</name>
-			<triggers>full,incremental,</triggers>
-			<arguments>
-			</arguments>
-		</buildCommand>
-	</buildSpec>
-	<natures>
-		<nature>org.eclipse.cdt.core.cnature</nature>
-		<nature>org.eclipse.cdt.core.ccnature</nature>
-		<nature>org.eclipse.cdt.managedbuilder.core.managedBuildNature</nature>
-		<nature>org.eclipse.cdt.managedbuilder.core.ScannerConfigNature</nature>
-	</natures>
-</projectDescription>
--- a/examples/ide-eclipse/tilaunchpad_msp430g2/platformio.ini
+++ b/examples/ide-eclipse/tilaunchpad_msp430g2/platformio.ini
@@ -1,27 +0,0 @@
-#
-# Project Configuration File
-#
-# A detailed documentation with the EXAMPLES is located here:
-# http://docs.platformio.org/en/latest/projectconf.html
-#
-
-# A sign `#` at the beginning of the line indicates a comment
-# Comment lines are ignored.
-
-# Simple and base environment
-# [env:mybaseenv]
-# platform = %INSTALLED_PLATFORM_NAME_HERE%
-# framework =
-# board =
-#
-# Automatic targets - enable auto-uploading
-# targets = upload
-
-[env:launchpad_msp430g2]
-platform = timsp430
-board_mcu = msp430g2553
-board_f_cpu = 16000000L
-
-upload_protocol = rf2500
-
-# targets = upload
--- a/examples/ide-eclipse/tilaunchpad_msp430g2/src/main.c
+++ b/examples/ide-eclipse/tilaunchpad_msp430g2/src/main.c
@@ -1,26 +0,0 @@
-/**
- * Copyright (C) Ivan Kravets <me@ikravets.com>
- * See LICENSE for details.
- */
-
-#include <msp430g2553.h>
-
-int main(void)
-{
-    WDTCTL = WDTPW + WDTHOLD;
-
-    // make the LED pin an output for P1.0
-    P1DIR |= 0x01;
-
-    volatile int i;
-
-    while (1)
-    {
-        for (i = 0; i < 10000; i++);
-
-        // toggle the LED
-        P1OUT ^= 0x01;
-    }
-
-    return 0;
-}
--- a/examples/ide-eclipse/titiva_lm4f120/.cproject
+++ b/examples/ide-eclipse/titiva_lm4f120/.cproject
@@ -1,63 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<?fileVersion 4.0.0?><cproject storage_type_id="org.eclipse.cdt.core.XmlProjectDescriptionStorage">
-	<storageModule moduleId="org.eclipse.cdt.core.settings">
-		<cconfiguration id="0.18931736">
-			<storageModule buildSystemId="org.eclipse.cdt.managedbuilder.core.configurationDataProvider" id="0.18931736" moduleId="org.eclipse.cdt.core.settings" name="Default">
-				<externalSettings/>
-				<extensions>
-					<extension id="org.eclipse.cdt.core.VCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.GmakeErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.CWDLocator" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.GCCErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.GASErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.GLDErrorParser" point="org.eclipse.cdt.core.ErrorParser"/>
-					<extension id="org.eclipse.cdt.core.ELF" point="org.eclipse.cdt.core.BinaryParser"/>
-				</extensions>
-			</storageModule>
-			<storageModule moduleId="cdtBuildSystem" version="4.0.0">
-				<configuration artifactName="${ProjName}" buildProperties="" description="" id="0.18931736" name="Default" parent="org.eclipse.cdt.build.core.prefbase.cfg">
-					<folderInfo id="0.18931736." name="/" resourcePath="">
-						<toolChain id="org.eclipse.cdt.build.core.prefbase.toolchain.946409409" name="No ToolChain" resourceTypeBasedDiscovery="false" superClass="org.eclipse.cdt.build.core.prefbase.toolchain">
-							<targetPlatform binaryParser="org.eclipse.cdt.core.ELF" id="org.eclipse.cdt.build.core.prefbase.toolchain.946409409.264614082" name=""/>
-							<builder cleanBuildTarget="run --target clean" command="platformio" id="org.eclipse.cdt.build.core.settings.default.builder.2099118713" incrementalBuildTarget="run" keepEnvironmentInBuildfile="false" managedBuildOn="false" name="Gnu Make Builder" superClass="org.eclipse.cdt.build.core.settings.default.builder"/>
-							<tool id="org.eclipse.cdt.build.core.settings.holder.libs.1860044306" name="holder for library settings" superClass="org.eclipse.cdt.build.core.settings.holder.libs"/>
-							<tool id="org.eclipse.cdt.build.core.settings.holder.490604788" name="Assembly" superClass="org.eclipse.cdt.build.core.settings.holder">
-								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.1186638432" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-gccarmnoneeabi/arm-none-eabi/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/framework-energiativa/cores/lm4f&quot;"/>
-								</option>
-								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.1338936035" languageId="org.eclipse.cdt.core.assembly" languageName="Assembly" sourceContentType="org.eclipse.cdt.core.asmSource" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
-							</tool>
-							<tool id="org.eclipse.cdt.build.core.settings.holder.1620533967" name="GNU C++" superClass="org.eclipse.cdt.build.core.settings.holder">
-								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.1007143336" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-gccarmnoneeabi/arm-none-eabi/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/framework-energiativa/cores/lm4f&quot;"/>
-								</option>
-								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.2051673558" languageId="org.eclipse.cdt.core.g++" languageName="GNU C++" sourceContentType="org.eclipse.cdt.core.cxxSource,org.eclipse.cdt.core.cxxHeader" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
-							</tool>
-							<tool id="org.eclipse.cdt.build.core.settings.holder.549164281" name="GNU C" superClass="org.eclipse.cdt.build.core.settings.holder">
-								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.454536693" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-gccarmnoneeabi/arm-none-eabi/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/framework-energiativa/cores/lm4f&quot;"/>
-								</option>
-								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.1468046922" languageId="org.eclipse.cdt.core.gcc" languageName="GNU C" sourceContentType="org.eclipse.cdt.core.cSource,org.eclipse.cdt.core.cHeader" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
-							</tool>
-						</toolChain>
-					</folderInfo>
-				</configuration>
-			</storageModule>
-			<storageModule moduleId="org.eclipse.cdt.core.externalSettings"/>
-		</cconfiguration>
-	</storageModule>
-	<storageModule moduleId="cdtBuildSystem" version="4.0.0">
-		<project id="titiva_lm4f120h5qr.null.1743670775" name="titiva_lm4f120h5qr"/>
-	</storageModule>
-	<storageModule moduleId="scannerConfiguration">
-		<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
-		<scannerConfigBuildInfo instanceId="0.18931736">
-			<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
-		</scannerConfigBuildInfo>
-	</storageModule>
-	<storageModule moduleId="org.eclipse.cdt.core.LanguageSettingsProviders"/>
-	<storageModule moduleId="refreshScope"/>
-</cproject>
--- a/examples/ide-eclipse/titiva_lm4f120/.project
+++ b/examples/ide-eclipse/titiva_lm4f120/.project
@@ -1,27 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<projectDescription>
-	<name>titiva_lm4f120</name>
-	<comment></comment>
-	<projects>
-	</projects>
-	<buildSpec>
-		<buildCommand>
-			<name>org.eclipse.cdt.managedbuilder.core.genmakebuilder</name>
-			<triggers>clean,full,incremental,</triggers>
-			<arguments>
-			</arguments>
-		</buildCommand>
-		<buildCommand>
-			<name>org.eclipse.cdt.managedbuilder.core.ScannerConfigBuilder</name>
-			<triggers>full,incremental,</triggers>
-			<arguments>
-			</arguments>
-		</buildCommand>
-	</buildSpec>
-	<natures>
-		<nature>org.eclipse.cdt.core.cnature</nature>
-		<nature>org.eclipse.cdt.core.ccnature</nature>
-		<nature>org.eclipse.cdt.managedbuilder.core.managedBuildNature</nature>
-		<nature>org.eclipse.cdt.managedbuilder.core.ScannerConfigNature</nature>
-	</natures>
-</projectDescription>
--- a/examples/ide-eclipse/titiva_lm4f120/src/main.c
+++ b/examples/ide-eclipse/titiva_lm4f120/src/main.c
@@ -1,36 +0,0 @@
-/**
- * Copyright (C) Ivan Kravets <me@ikravets.com>
- * See LICENSE for details.
- */
-
-#define    false    0
-#define    true    1
-typedef int bool;
-
-#include <stdint.h>
-#include "inc/hw_memmap.h"
-#include "driverlib/gpio.h"
-#include "driverlib/sysctl.h"
-
-#define LED_RED GPIO_PIN_1
-#define LED_BLUE GPIO_PIN_2
-#define LED_GREEN GPIO_PIN_3
-
-
-void setup() {
-    SysCtlClockSet(
-        SYSCTL_SYSDIV_4|SYSCTL_USE_PLL|SYSCTL_XTAL_16MHZ|SYSCTL_OSC_MAIN);
-
-    SysCtlPeripheralEnable(SYSCTL_PERIPH_GPIOF);
-    GPIOPinTypeGPIOOutput(GPIO_PORTF_BASE, LED_RED|LED_BLUE|LED_GREEN);
-}
-
-
-void loop() {
-    GPIOPinWrite(GPIO_PORTF_BASE, LED_RED|LED_BLUE|LED_GREEN, LED_RED);
-    SysCtlDelay(3000000);
-    GPIOPinWrite(GPIO_PORTF_BASE, LED_RED|LED_BLUE|LED_GREEN, LED_BLUE);
-    SysCtlDelay(3000000);
-    GPIOPinWrite(GPIO_PORTF_BASE, LED_RED|LED_BLUE|LED_GREEN, LED_GREEN);
-    SysCtlDelay(3000000);
-}
--- a/examples/ide/clion/.idea/clion.iml
+++ b/examples/ide/clion/.idea/clion.iml
@@ -0,0 +1,10 @@
+<?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>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>
--- a/examples/ide/clion/.idea/misc.xml
+++ b/examples/ide/clion/.idea/misc.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="CMakeWorkspace" PROJECT_DIR="$PROJECT_DIR$" />
+  <component name="ProjectRootManager" version="2" />
+</project>
--- a/examples/ide/clion/.idea/modules.xml
+++ b/examples/ide/clion/.idea/modules.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/clion.iml" filepath="$PROJECT_DIR$/.idea/clion.iml" />
+      <module fileurl="file://$PROJECT_DIR$/.idea/platformio.iml" filepath="$PROJECT_DIR$/.idea/platformio.iml" />
+    </modules>
+  </component>
+</project>
--- a/examples/ide/clion/.idea/platformio.iml
+++ b/examples/ide/clion/.idea/platformio.iml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="CPP_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>
--- a/examples/ide/clion/.idea/vcs.xml
+++ b/examples/ide/clion/.idea/vcs.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="" />
+  </component>
+</project>
--- a/examples/ide/clion/.idea/workspace.xml
+++ b/examples/ide/clion/.idea/workspace.xml
@@ -0,0 +1,287 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<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" />
+    </generated>
+  </component>
+  <component name="CMakeSettings" AUTO_RELOAD="true" GENERATION_PASS_SYSTEM_ENVIRONMENT="true">
+    <ADDITIONAL_GENERATION_ENVIRONMENT>
+      <envs />
+    </ADDITIONAL_GENERATION_ENVIRONMENT>
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="ec922180-b3d3-40f1-af0b-2568113a9075" name="Default" comment="" />
+    <ignored path="platformio.iws" />
+    <ignored path=".idea/workspace.xml" />
+    <option name="EXCLUDED_CONVERTED_TO_IGNORED" value="true" />
+    <option name="TRACKING_ENABLED" value="true" />
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="ChangesViewManager" flattened_view="true" show_ignored="false" />
+  <component name="CreatePatchCommitExecutor">
+    <option name="PATCH_PATH" value="" />
+  </component>
+  <component name="ExecutionTargetManager" SELECTED_TARGET="default_target" />
+  <component name="FavoritesManager">
+    <favorites_list name="PlatformIO" />
+  </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" />
+              <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">
+          <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>
+      </file>
+    </leaf>
+  </component>
+  <component name="JsBuildToolGruntFileManager" detection-done="true" />
+  <component name="JsGulpfileManager">
+    <detection-done>true</detection-done>
+  </component>
+  <component name="NamedScopeManager">
+    <order />
+  </component>
+  <component name="ProjectFrameBounds">
+    <option name="x" value="162" />
+    <option name="y" value="23" />
+    <option name="width" value="1400" />
+    <option name="height" value="1000" />
+  </component>
+  <component name="ProjectInspectionProfilesVisibleTreeState">
+    <entry key="Project Default">
+      <profile-state>
+        <expanded-state>
+          <State>
+            <id />
+          </State>
+        </expanded-state>
+        <selected-state>
+          <State>
+            <id>C/C++</id>
+          </State>
+        </selected-state>
+      </profile-state>
+    </entry>
+  </component>
+  <component name="ProjectLevelVcsManager" settingsEditedManually="false">
+    <OptionsSetting value="true" id="Add" />
+    <OptionsSetting value="true" id="Remove" />
+    <OptionsSetting value="true" id="Checkout" />
+    <OptionsSetting value="true" id="Update" />
+    <OptionsSetting value="true" id="Status" />
+    <OptionsSetting value="true" id="Edit" />
+    <ConfirmationsSetting value="0" id="Add" />
+    <ConfirmationsSetting value="0" id="Remove" />
+  </component>
+  <component name="ProjectView">
+    <navigator currentView="ProjectPane" proportions="" version="1">
+      <flattenPackages />
+      <showMembers />
+      <showModules />
+      <showLibraryContents />
+      <hideEmptyPackages />
+      <abbreviatePackageNames />
+      <autoscrollToSource />
+      <autoscrollFromSource />
+      <sortByType />
+    </navigator>
+    <panes>
+      <pane id="ProjectPane">
+        <subPane>
+          <PATH>
+            <PATH_ELEMENT>
+              <option name="myItemId" value="clion" />
+              <option name="myItemType" value="com.jetbrains.cidr.projectView.CidrFilesViewHelper$MyProjectTreeStructure$1" />
+            </PATH_ELEMENT>
+          </PATH>
+          <PATH>
+            <PATH_ELEMENT>
+              <option name="myItemId" value="clion" />
+              <option name="myItemType" value="com.jetbrains.cidr.projectView.CidrFilesViewHelper$MyProjectTreeStructure$1" />
+            </PATH_ELEMENT>
+            <PATH_ELEMENT>
+              <option name="myItemId" value="clion" />
+              <option name="myItemType" value="com.intellij.ide.projectView.impl.nodes.PsiDirectoryNode" />
+            </PATH_ELEMENT>
+          </PATH>
+          <PATH>
+            <PATH_ELEMENT>
+              <option name="myItemId" value="clion" />
+              <option name="myItemType" value="com.jetbrains.cidr.projectView.CidrFilesViewHelper$MyProjectTreeStructure$1" />
+            </PATH_ELEMENT>
+            <PATH_ELEMENT>
+              <option name="myItemId" value="clion" />
+              <option name="myItemType" value="com.intellij.ide.projectView.impl.nodes.PsiDirectoryNode" />
+            </PATH_ELEMENT>
+            <PATH_ELEMENT>
+              <option name="myItemId" value="src" />
+              <option name="myItemType" value="com.intellij.ide.projectView.impl.nodes.PsiDirectoryNode" />
+            </PATH_ELEMENT>
+          </PATH>
+        </subPane>
+      </pane>
+    </panes>
+  </component>
+  <component name="PropertiesComponent">
+    <property name="recentsLimit" value="5" />
+    <property name="settings.editor.selected.configurable" value="CPPToolchains" />
+    <property name="settings.editor.splitter.proportion" value="0.2" />
+    <property name="last_opened_file_path" value="$PROJECT_DIR$/CMakeLists.txt" />
+    <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">
+      <envs />
+      <method />
+    </configuration>
+    <configuration default="true" type="js.build_tools.gulp" factoryName="Gulp.js">
+      <node-options />
+      <gulpfile />
+      <tasks />
+      <arguments />
+      <pass-parent-envs>true</pass-parent-envs>
+      <envs />
+      <method />
+    </configuration>
+    <configuration default="false" name="Build All" type="CMakeRunConfiguration" factoryName="Application" WORKING_DIR="" PASS_PARENT_ENVS="FALSE" CONFIG_NAME="Debug" EXPLICIT_BUILD_TARGET_NAME="all">
+      <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">
+      <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">
+      <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">
+      <envs />
+      <method />
+    </configuration>
+    <list size="4">
+      <item index="0" class="java.lang.String" itemvalue="Application.Build All" />
+      <item index="1" class="java.lang.String" itemvalue="Application.PLATFORMIO_BUILD" />
+      <item index="2" class="java.lang.String" itemvalue="Application.PLATFORMIO_CLEAN" />
+      <item index="3" class="java.lang.String" itemvalue="Application.PLATFORMIO_UPLOAD" />
+    </list>
+  </component>
+  <component name="ShelveChangesManager" show_recycled="false" />
+  <component name="SvnConfiguration">
+    <configuration />
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="ec922180-b3d3-40f1-af0b-2568113a9075" name="Default" comment="" />
+      <created>1435919971910</created>
+      <option name="number" value="Default" />
+      <updated>1435919971910</updated>
+    </task>
+    <servers />
+  </component>
+  <component name="ToolWindowManager">
+    <frame x="162" y="23" 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="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="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="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" />
+    </layout>
+  </component>
+  <component name="Vcs.Log.UiProperties">
+    <option name="RECENTLY_FILTERED_USER_GROUPS">
+      <collection />
+    </option>
+    <option name="RECENTLY_FILTERED_BRANCH_GROUPS">
+      <collection />
+    </option>
+  </component>
+  <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">
+        <settings>
+          <splitter-proportions>
+            <option name="proportions">
+              <list>
+                <option value="0.2" />
+              </list>
+            </option>
+          </splitter-proportions>
+        </settings>
+      </state>
+    </states>
+  </component>
+</project>
--- a/examples/ide/clion/CMakeLists.txt
+++ b/examples/ide/clion/CMakeLists.txt
@@ -0,0 +1,36 @@
+cmake_minimum_required(VERSION 3.2)
+project(PlatformIO)
+
+set(PLATFORMIO_CMD platformio)
+
+include_directories("$ENV{HOME}/.platformio/packages/framework-arduinoavr/variants/standard")
+include_directories("$ENV{HOME}/.platformio/packages/framework-arduinoavr/cores/arduino")
+include_directories("$ENV{HOME}/.platformio/packages/toolchain-atmelavr/avr/include")
+include_directories("$ENV{HOME}/.platformio/packages/toolchain-atmelavr/bfd/include")
+include_directories("$ENV{HOME}/.platformio/packages/toolchain-atmelavr/lib/gcc/avr/4.8.1/include")
+include_directories("$ENV{HOME}/.platformio/packages/toolchain-atmelavr/lib/gcc/avr/4.8.1/include-fixed")
+
+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(-D__AVR_ATmega328P__)
+
+add_custom_target(
+    PLATFORMIO_BUILD ALL
+    COMMAND ${PLATFORMIO_CMD} -f -c clion run
+    WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+)
+
+add_custom_target(
+    PLATFORMIO_UPLOAD ALL
+    COMMAND ${PLATFORMIO_CMD} -f -c clion run --target upload
+    WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+)
+
+add_custom_target(
+    PLATFORMIO_CLEAN ALL
+    COMMAND ${PLATFORMIO_CMD} -f -c clion run --target clean
+    WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+)
--- a/examples/ide/clion/README.rst
+++ b/examples/ide/clion/README.rst
@@ -0,0 +1,8 @@
+CLion IDE Integration
+=====================
+
+The detailed information and steps are described in the main documentation:
+`PlatformIO integration with CLion IDE <http://docs.platformio.org/en/latest/ide/clion.html>`_.
+
+.. image:: http://docs.platformio.org/en/latest/_images/ide-platformio-clion.png
+    :target: http://docs.platformio.org/en/latest/ide/clion.html
--- a/examples/ide/clion/lib/readme.txt
+++ b/examples/ide/clion/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/ide/sublime-text/platformio.ini
+++ b/examples/ide/sublime-text/platformio.ini
@@ -17,7 +17,8 @@
 # Automatic targets - enable auto-uploading
 # targets = upload

-[env:flora8]
+[env:uno]
 platform = atmelavr
 framework = arduino
-board = flora8
+board = uno
+# targets = upload
--- a/examples/ide/clion/src/blink.cpp
+++ b/examples/ide/clion/src/blink.cpp
@@ -0,0 +1,15 @@
+#include "Arduino.h"
+
+// Most Arduino boards already have a LED attached to pin 13 on the board itself
+#define LED_PIN 13
+
+void setup() {
+  pinMode(LED_PIN, OUTPUT);     // set pin as output
+}
+
+void loop() {
+  digitalWrite(LED_PIN, HIGH);  // set the LED on
+  delay(1000);                  // wait for a second
+  digitalWrite(LED_PIN, LOW);   // set the LED off
+  delay(1000);                  // wait for a second
+}
--- a/examples/ide-eclipse/arduino_pro5/.cproject
+++ b/examples/ide-eclipse/arduino_pro5/.cproject
@@ -15,43 +15,66 @@
 				</extensions>
 			</storageModule>
 			<storageModule moduleId="cdtBuildSystem" version="4.0.0">
-				<configuration artifactName="${ProjName}" buildProperties="" description="" id="0.910961921" name="Default" parent="org.eclipse.cdt.build.core.prefbase.cfg">
+				<configuration artifactName="PlatformIO" buildProperties="" description="" id="0.910961921" name="Default" parent="org.eclipse.cdt.build.core.prefbase.cfg">
 					<folderInfo id="0.910961921." name="/" resourcePath="">
 						<toolChain id="org.eclipse.cdt.build.core.prefbase.toolchain.952979152" name="No ToolChain" resourceTypeBasedDiscovery="false" superClass="org.eclipse.cdt.build.core.prefbase.toolchain">
 							<targetPlatform binaryParser="org.eclipse.cdt.core.ELF" id="org.eclipse.cdt.build.core.prefbase.toolchain.952979152.52310970" name=""/>
-							<builder cleanBuildTarget="run --target clean" command="platformio" id="org.eclipse.cdt.build.core.settings.default.builder.1519453406" incrementalBuildTarget="run" keepEnvironmentInBuildfile="false" managedBuildOn="false" name="Gnu Make Builder" superClass="org.eclipse.cdt.build.core.settings.default.builder"/>
+							<builder cleanBuildTarget="-f -c eclipse run --target clean" command="platformio" id="org.eclipse.cdt.build.core.settings.default.builder.1519453406" incrementalBuildTarget="-f -c eclipse run" keepEnvironmentInBuildfile="false" managedBuildOn="false" name="Gnu Make Builder" superClass="org.eclipse.cdt.build.core.settings.default.builder"/>
 							<tool id="org.eclipse.cdt.build.core.settings.holder.libs.1409095472" name="holder for library settings" superClass="org.eclipse.cdt.build.core.settings.holder.libs"/>
 							<tool id="org.eclipse.cdt.build.core.settings.holder.1624502120" name="Assembly" superClass="org.eclipse.cdt.build.core.settings.holder">
 								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.239157887" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-atmelavr/avr/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/framework-arduinoavr/cores/arduino&quot;"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/framework-arduinoavr/variants/standard"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/framework-arduinoavr/cores/arduino"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/toolchain-atmelavr/avr/include"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/toolchain-atmelavr/bfd/include"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/toolchain-atmelavr/lib/gcc/avr/4.8.1/include"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/toolchain-atmelavr/lib/gcc/avr/4.8.1/include-fixed"/>
 								</option>
 								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.922107295" name="Symbols" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
-									<listOptionValue builtIn="false" value="__AVR_ATmega168__"/>
+									<listOptionValue builtIn="false" value="F_CPU=16000000L"/>
+									<listOptionValue builtIn="false" value="ARDUINO_ARCH_AVR"/>
+									<listOptionValue builtIn="false" value="ARDUINO_AVR_UNO"/>
+									<listOptionValue builtIn="false" value="ARDUINO=10605"/>
+									<listOptionValue builtIn="false" value="PLATFORMIO=020300"/>
+									<listOptionValue builtIn="false" value="__AVR_ATmega328P__"/>
 								</option>
 								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.149990277" languageId="org.eclipse.cdt.core.assembly" languageName="Assembly" sourceContentType="org.eclipse.cdt.core.asmSource" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
 							</tool>
 							<tool id="org.eclipse.cdt.build.core.settings.holder.54121539" name="GNU C++" superClass="org.eclipse.cdt.build.core.settings.holder">
 								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.1096940598" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/tools/toolchain/avr/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/frameworks/arduino/cores/arduino&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-atmelavr/avr/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/framework-arduinoavr/cores/arduino&quot;"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/framework-arduinoavr/variants/standard"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/framework-arduinoavr/cores/arduino"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/toolchain-atmelavr/avr/include"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/toolchain-atmelavr/bfd/include"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/toolchain-atmelavr/lib/gcc/avr/4.8.1/include"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/toolchain-atmelavr/lib/gcc/avr/4.8.1/include-fixed"/>
 								</option>
 								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.1198905600" name="Symbols" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
-									<listOptionValue builtIn="false" value="__AVR_ATmega168__"/>
+									<listOptionValue builtIn="false" value="F_CPU=16000000L"/>
+									<listOptionValue builtIn="false" value="ARDUINO_ARCH_AVR"/>
+									<listOptionValue builtIn="false" value="ARDUINO_AVR_UNO"/>
+									<listOptionValue builtIn="false" value="ARDUINO=10605"/>
+									<listOptionValue builtIn="false" value="PLATFORMIO=020300"/>
+									<listOptionValue builtIn="false" value="__AVR_ATmega328P__"/>
 								</option>
 								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.762536863" languageId="org.eclipse.cdt.core.g++" languageName="GNU C++" sourceContentType="org.eclipse.cdt.core.cxxSource,org.eclipse.cdt.core.cxxHeader" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
 							</tool>
 							<tool id="org.eclipse.cdt.build.core.settings.holder.1310559623" name="GNU C" superClass="org.eclipse.cdt.build.core.settings.holder">
 								<option id="org.eclipse.cdt.build.core.settings.holder.incpaths.41298875" name="Include Paths" superClass="org.eclipse.cdt.build.core.settings.holder.incpaths" valueType="includePath">
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/tools/toolchain/avr/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/atmelavr/frameworks/arduino/cores/arduino&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/toolchain-atmelavr/avr/include&quot;"/>
-									<listOptionValue builtIn="false" value="&quot;${HOME}/.platformio/packages/framework-arduinoavr/cores/arduino&quot;"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/framework-arduinoavr/variants/standard"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/framework-arduinoavr/cores/arduino"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/toolchain-atmelavr/avr/include"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/toolchain-atmelavr/bfd/include"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/toolchain-atmelavr/lib/gcc/avr/4.8.1/include"/>
+									<listOptionValue builtIn="false" value="${HOME}/.platformio/packages/toolchain-atmelavr/lib/gcc/avr/4.8.1/include-fixed"/>
 								</option>
 								<option id="org.eclipse.cdt.build.core.settings.holder.symbols.884639970" name="Symbols" superClass="org.eclipse.cdt.build.core.settings.holder.symbols" valueType="definedSymbols">
-									<listOptionValue builtIn="false" value="__AVR_ATmega168__"/>
+									<listOptionValue builtIn="false" value="F_CPU=16000000L"/>
+									<listOptionValue builtIn="false" value="ARDUINO_ARCH_AVR"/>
+									<listOptionValue builtIn="false" value="ARDUINO_AVR_UNO"/>
+									<listOptionValue builtIn="false" value="ARDUINO=10605"/>
+									<listOptionValue builtIn="false" value="PLATFORMIO=020300"/>
+									<listOptionValue builtIn="false" value="__AVR_ATmega328P__"/>
 								</option>
 								<inputType id="org.eclipse.cdt.build.core.settings.holder.inType.549319812" languageId="org.eclipse.cdt.core.gcc" languageName="GNU C" sourceContentType="org.eclipse.cdt.core.cSource,org.eclipse.cdt.core.cHeader" superClass="org.eclipse.cdt.build.core.settings.holder.inType"/>
 							</tool>
@@ -63,7 +86,7 @@
 		</cconfiguration>
 	</storageModule>
 	<storageModule moduleId="cdtBuildSystem" version="4.0.0">
-		<project id="arduino_pro5.null.189551033" name="arduino_pro5"/>
+		<project id="PlatformIO.null.189551033" name="PlatformIO"/>
 	</storageModule>
 	<storageModule moduleId="scannerConfiguration">
 		<autodiscovery enabled="true" problemReportingEnabled="true" selectedProfileId=""/>
@@ -74,7 +97,7 @@
 	<storageModule moduleId="org.eclipse.cdt.core.LanguageSettingsProviders"/>
 	<storageModule moduleId="refreshScope" versionNumber="2">
 		<configuration configurationName="Default">
-			<resource resourceType="PROJECT" workspacePath="/arduino_pro5"/>
+			<resource resourceType="PROJECT" workspacePath="/uno"/>
 		</configuration>
 	</storageModule>
 	<storageModule moduleId="org.eclipse.cdt.internal.ui.text.commentOwnerProjectMappings"/>
--- a/examples/ide-eclipse/arduino_pro5/.project
+++ b/examples/ide-eclipse/arduino_pro5/.project
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <projectDescription>
-	<name>arduino_pro5</name>
+	<name>PlatformIO</name>
 	<comment></comment>
 	<projects>
 	</projects>
--- a/examples/ide/eclipse/.settings/language.settings.xml
+++ b/examples/ide/eclipse/.settings/language.settings.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<project>
+	<configuration id="0.910961921" name="Default">
+		<extension point="org.eclipse.cdt.core.LanguageSettingsProvider">
+			<provider copy-of="extension" id="org.eclipse.cdt.ui.UserLanguageSettingsProvider"/>
+			<provider-reference id="org.eclipse.cdt.core.ReferencedProjectsLanguageSettingsProvider" ref="shared-provider"/>
+			<provider-reference id="org.eclipse.cdt.managedbuilder.core.MBSLanguageSettingsProvider" ref="shared-provider"/>
+			<provider class="org.eclipse.cdt.internal.build.crossgcc.CrossGCCBuiltinSpecsDetector" console="false" env-hash="-869785120007741010" id="org.eclipse.cdt.build.crossgcc.CrossGCCBuiltinSpecsDetector" keep-relative-paths="false" name="CDT Cross GCC Built-in Compiler Settings" parameter="${HOME}/.platformio/packages/toolchain-atmelavr/bin/avr-g++ ${FLAGS} -E -P -v -dD &quot;${INPUTS}&quot;" prefer-non-shared="true" store-entries-with-project="false">
+				<language-scope id="org.eclipse.cdt.core.gcc"/>
+				<language-scope id="org.eclipse.cdt.core.g++"/>
+			</provider>
+		</extension>
+	</configuration>
+</project>
--- a/examples/ide/eclipse/README.rst
+++ b/examples/ide/eclipse/README.rst
@@ -0,0 +1,8 @@
+Eclipse IDE Integration
+=======================
+
+The detailed information and steps are described in the main documentation:
+`PlatformIO integration with Eclipse IDE <http://docs.platformio.org/en/latest/ide/eclipse.html>`_.
+
+.. image:: http://docs.platformio.org/en/latest/_images/ide-platformio-eclipse.png
+    :target: http://docs.platformio.org/en/latest/ide/eclipse.html
--- a/examples/ide/eclipse/lib/readme.txt
+++ b/examples/ide/eclipse/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/ide/visual-studio/platformio.ini
+++ b/examples/ide/visual-studio/platformio.ini
@@ -17,7 +17,8 @@
 # Automatic targets - enable auto-uploading
 # targets = upload

-[env:arduino_uno]
+[env:uno]
 platform = atmelavr
 framework = arduino
-board = uno
+board = uno
+# targets = upload
--- a/examples/ide/eclipse/src/blink.cpp
+++ b/examples/ide/eclipse/src/blink.cpp
@@ -0,0 +1,15 @@
+#include "Arduino.h"
+
+// Most Arduino boards already have a LED attached to pin 13 on the board itself
+#define LED_PIN 13
+
+void setup() {
+  pinMode(LED_PIN, OUTPUT);     // set pin as output
+}
+
+void loop() {
+  digitalWrite(LED_PIN, HIGH);  // set the LED on
+  delay(1000);                  // wait for a second
+  digitalWrite(LED_PIN, LOW);   // set the LED off
+  delay(1000);                  // wait for a second
+}
--- a/examples/ide/qtcreator/README.rst
+++ b/examples/ide/qtcreator/README.rst
@@ -0,0 +1,8 @@
+Qt Creator IDE Integration
+==========================
+
+The detailed information and steps are described in the main documentation:
+`PlatformIO integration with Qt Creator <http://docs.platformio.org/en/latest/ide/qtcreator.html>`_.
+
+.. image:: http://docs.platformio.org/en/latest/_static/ide-platformio-qtcreator-7.png
+    :target: http://docs.platformio.org/en/latest/ide/qtcreator.html
--- a/examples/ide/qtcreator/lib/readme.txt
+++ b/examples/ide/qtcreator/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/ide/qtcreator/platformio.ini
+++ b/examples/ide/qtcreator/platformio.ini
@@ -17,7 +17,8 @@
 # Automatic targets - enable auto-uploading
 # targets = upload

-[env:arduino_uno]
+[env:uno]
 platform = atmelavr
 framework = arduino
-board = uno
+board = uno
+# targets = upload
--- a/examples/ide/qtcreator/platformio.pro
+++ b/examples/ide/qtcreator/platformio.pro
@@ -2,18 +2,25 @@ win32 {
    HOMEDIR += $$(USERPROFILE)
 }
 else {
-    HOMEDIR += $$(PWD)
+    HOMEDIR += $$(HOME)
 }

-INCLUDEPATH += "$$HOMEDIR/.platformio/packages/framework-arduinoavr/cores/arduino"
-INCLUDEPATH += "$$HOMEDIR/.platformio/packages/toolchain-atmelavr/avr/include"
+INCLUDEPATH += "$${HOMEDIR}/.platformio/packages/framework-arduinoavr/variants/standard"
+INCLUDEPATH += "$${HOMEDIR}/.platformio/packages/framework-arduinoavr/cores/arduino"
+INCLUDEPATH += "$${HOMEDIR}/.platformio/packages/toolchain-atmelavr/avr/include"
+INCLUDEPATH += "$${HOMEDIR}/.platformio/packages/toolchain-atmelavr/bfd/include"
+INCLUDEPATH += "$${HOMEDIR}/.platformio/packages/toolchain-atmelavr/lib/gcc/avr/4.8.1/include"
+INCLUDEPATH += "$${HOMEDIR}/.platformio/packages/toolchain-atmelavr/lib/gcc/avr/4.8.1/include-fixed"

-win32:INCLUDEPATH ~= s,/,\\,g
-
-# DEFINES += __AVR_ATmega328__
+DEFINES += "F_CPU=16000000L"
+DEFINES += "ARDUINO_ARCH_AVR"
+DEFINES += "ARDUINO_AVR_UNO"
+DEFINES += "ARDUINO=10605"
+DEFINES += "PLATFORMIO=020300"
+DEFINES += "__AVR_ATmega328P__"

 OTHER_FILES += \
    platformio.ini

 SOURCES += \
-    src/main.c
+    src/blink.cpp
--- a/examples/ide/qtcreator/src/blink.cpp
+++ b/examples/ide/qtcreator/src/blink.cpp
@@ -0,0 +1,15 @@
+#include "Arduino.h"
+
+// Most Arduino boards already have a LED attached to pin 13 on the board itself
+#define LED_PIN 13
+
+void setup() {
+  pinMode(LED_PIN, OUTPUT);     // set pin as output
+}
+
+void loop() {
+  digitalWrite(LED_PIN, HIGH);  // set the LED on
+  delay(1000);                  // wait for a second
+  digitalWrite(LED_PIN, LOW);   // set the LED off
+  delay(1000);                  // wait for a second
+}
--- a/examples/ide/qtcreator/src/main.c
+++ b/examples/ide/qtcreator/src/main.c
@@ -1,25 +0,0 @@
-#include "Arduino.h"
-/*
-  Blink
-  Turns on an LED on for one second, then off for one second, repeatedly.
- 
-  This example code is in the public domain.
-*/
- 
-int led = 1; // blink 'digital' pin 1 - AKA the built in red LED
-
-// the setup routine runs once when you press reset:
-void setup() {
-  // initialize the digital pin as an output.
-  pinMode(led, OUTPUT);
-
-}
-
-// the loop routine runs over and over again forever:
-void loop() {
-    digitalWrite(led, HIGH); 
-    delay(1000);
-    digitalWrite(led, LOW);
-    delay(1000);
-}
-    
--- a/examples/ide/sublime-text/src/Blink.pde
+++ b/examples/ide/sublime-text/src/Blink.pde
@@ -1,24 +0,0 @@
-/*
-  Blink
-  Turns on an LED on for one second, then off for one second, repeatedly.
- 
-  This example code is in the public domain.
-*/
- 
-int led = 1; // blink 'digital' pin 1 - AKA the built in red LED
-
-// the setup routine runs once when you press reset:
-void setup() {
-  // initialize the digital pin as an output.
-  pinMode(led, OUTPUT);
-
-}
-
-// the loop routine runs over and over again forever:
-void loop() {
-    digitalWrite(led, HIGH); 
-    delay(1000);
-    digitalWrite(led, LOW);
-    delay(1000);
-}
-    
--- a/examples/ide/sublimetext/README.rst
+++ b/examples/ide/sublimetext/README.rst
@@ -0,0 +1,8 @@
+Sublime Text Integration
+========================
+
+The detailed information and steps are described in the main documentation:
+`PlatformIO integration with Sublime Text <http://docs.platformio.org/en/latest/ide/sublimetext.html>`_.
+
+.. image:: http://docs.platformio.org/en/latest/_images/ide-sublime-text-platformio-newproject-5.png
+    :target: http://docs.platformio.org/en/latest/ide/sublimetext.html
--- a/examples/ide/sublimetext/lib/readme.txt
+++ b/examples/ide/sublimetext/lib/readme.txt
@@ -0,0 +1,38 @@
+
+This directory is intended for the project specific (private) libraries.
+PlatformIO will compile them to static libraries and link to executable file.
+
+The source code of each library should be placed in separate directory, like
+"lib/private_lib/[here are source files]".
+
+For example, see how can be organised `Foo` and `Bar` libraries:
+
+|--lib
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |- readme.txt --> THIS FILE
+|- platformio.ini
+|--src
+   |- main.c
+
+Then in `src/main.c` you should use:
+
+#include <Foo.h>
+#include <Bar.h>
+
+// rest H/C/CPP code
+
+PlatformIO will find your libraries automatically, configure preprocessor's
+include paths and build them.
+
+See additional options for PlatformIO Library Dependency Finder `lib_*`:
+
+http://docs.platformio.org/en/latest/projectconf.html#lib-install
+
--- a/examples/ide-eclipse/arduino_pro5/platformio.ini
+++ b/examples/ide-eclipse/arduino_pro5/platformio.ini
@@ -17,9 +17,8 @@
 # Automatic targets - enable auto-uploading
 # targets = upload

-[env:arduino_pro5v]
+[env:uno]
 platform = atmelavr
 framework = arduino
-board = pro16MHzatmega168
-
-# targets = upload
+board = uno
+# targets = upload
--- a/examples/ide/sublime-text/platformio.sublime-project
+++ b/examples/ide/sublime-text/platformio.sublime-project
@@ -5,6 +5,7 @@
 			"cmd":
 			[
 				"platformio",
+				"-f", "-c", "sublimetext",
 				"run"
 			],
 			"name": "PlatformIO",
@@ -14,8 +15,9 @@
 					"cmd":
 					[
 						"platformio",
+						"-f", "-c", "sublimetext",
 						"run",
-						"-t",
+						"--target",
 						"clean"
 					],
 					"name": "Clean"
@@ -24,14 +26,16 @@
 					"cmd":
 					[
 						"platformio",
+						"-f", "-c", "sublimetext",
 						"run",
-						"-t",
+						"--target",
 						"upload"
 					],
 					"name": "Upload"
 				}
 			],
-			"working_dir": "${project_path:${folder}}"
+			"working_dir": "${project_path:${folder}}",
+			"selector": "source.c, source.c++"
 		}
 	],
 	"folders":
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Ivan Kravets	ec6af9a460	Merge branch 'release/v2.3.3'	2015-10-02 16:24:02 +01:00
Ivan Kravets	e1c9cb2c00	Version bump to 2.3.3 (issues #263 , #288 , #292 , #295 , #296 , #297 )	2015-10-02 16:23:46 +01:00
Ivan Kravets	2c0d26e06d	Skip empty serial ports // Issue #294	2015-10-02 16:20:07 +01:00
Ivan Kravets	3c36eafdfa	Avoid pip cache when problem occurs for upgrade process // Issue #295	2015-10-02 16:14:04 +01:00
Ivan Kravets	e22ab787dd	Fix ESP8266 compile errors about RAM size when adding 1 library // Resolve #297	2015-10-02 15:34:36 +01:00
Ivan Kravets	948b75aeda	Merge pull request #299 from valeros/develop Update espressif platform // Resolve #296, #297	2015-10-02 15:22:09 +01:00
Valeriy Koval	4dcef89301	Update espressif platform // Resolve #296 , #297	2015-10-02 16:11:00 +03:00
Ivan Kravets	12b29a760a	More explanations about NotPlatformProject	2015-10-01 17:04:26 +01:00
Ivan Kravets	43ca0e149f	Remove debug info	2015-09-30 16:56:13 +01:00
Ivan Kravets	ad1666dd0a	Fix double quotes in defines for Project Generator // Issue #294	2015-09-30 16:54:12 +01:00
Ivan Kravets	1b4d4f5695	Handle Atom & Vim as IDE	2015-09-30 14:54:07 +01:00
Ivan Kravets	a714e6084a	Add to FAQ "Unable to install PlatformIO: [Errno 1] Operation not permitted" // Resolve #295	2015-09-28 16:57:28 +01:00
Ivan Kravets	a8dd5d85a5	Add support for ST Nucleo F446RE board // Pull #293	2015-09-28 13:19:07 +01:00
Ivan Kravets	83363c7077	Merge pull request #293 from dkuku/patch-1 Add support for ST Nucleo F446RE board	2015-09-28 13:12:48 +01:00
Ivan Kravets	d99a57365f	Add support for LightBlue Bean board // Issue #292	2015-09-28 12:09:03 +01:00
Daniel Kuku	3cb41cf6b0	Update ststm32.json added nucleo_f446re	2015-09-27 03:02:34 +01:00
Ivan Kravets	5201626d6a	Merge pull request #292 from mplewis/add-lightblue-boards config: add LightBlue Bean board definition and docs	2015-09-24 09:43:57 +02:00
Matthew Lewis	f812e74324	config: fix Punch Through vendor name	2015-09-23 11:57:54 -05:00
Matthew Lewis	0668d6d290	docs: remove LightBlue Bean docs	2015-09-23 11:54:00 -05:00
Ivan Kravets	46d1c2c86c	Fix broken lock file for "appstate" storage // Resolve #288	2015-09-23 16:35:31 +03:00
Ivan Kravets	ee7fe1fc10	Add to FAQ info about Archlinux issue with libncurses.so.5 // Resolve #291	2015-09-23 15:55:19 +03:00
Matthew Lewis	c997495b5d	docs: fix underline length	2015-09-22 15:04:06 -05:00
Matthew Lewis	605b5755bf	config: add LightBlue Bean board definition and docs	2015-09-22 14:54:32 -05:00
Ivan Kravets	b60c761cce	Fix firmware uploading to Arduino Leonardo board using Mac OS // Resolve #287	2015-09-11 12:53:04 +03:00
Ivan Kravets	12d6df6962	Merge branch 'release/v2.3.2'	2015-09-10 20:44:53 +03:00
Ivan Kravets	34972c77f5	Merge branch 'release/v2.3.2' into develop	2015-09-10 20:44:53 +03:00
Ivan Kravets	2c5db64677	Version bump to 2.3.2 (issues #279 )	2015-09-10 20:44:39 +03:00
Ivan Kravets	fa33d53180	Show float RAM values for boards // Issue #286	2015-09-10 20:41:23 +03:00
Ivan Kravets	57b877f445	Fix Cygwin disabling	2015-09-10 20:31:26 +03:00
Ivan Kravets	dcb6d8286b	Disable Cygwin support	2015-09-10 20:23:37 +03:00
Ivan Kravets	3a8c515e21	Minor fix	2015-09-10 20:22:54 +03:00
Ivan Kravets	50984f1475	Correct OS arch within Cygwin emu	2015-09-10 19:47:14 +03:00
Ivan Kravets	4338bade5b	Allow PlatformIO to be run within Cygwin environment	2015-09-10 19:35:32 +03:00
Ivan Kravets	ed10ecd142	Explain how to use "lib" directory from the PlatformIO based project // Issue #273	2015-09-10 18:19:23 +03:00
Ivan Kravets	6815297b0c	Merge branch 'feature/issue-287' into develop	2015-09-10 17:52:40 +03:00
Ivan Kravets	c72bf9ea31	Found solution for "pip/scons error: option –single-version-externally-managed not recognized" // Resolve #279	2015-09-10 17:47:19 +03:00
Ivan Kravets	d4f4d9c789	Fix using $UPLOAD_PROTOCOL env variable	2015-09-10 16:56:33 +03:00
Ivan Kravets	61ef27c345	Allow to use ST-Link uploader for mbed-based projects	2015-09-10 16:43:09 +03:00
Ivan Kravets	9c73e59772	Fix firmware uploading for Arduino Leonardo under Unix	2015-09-10 15:20:29 +03:00
Ivan Kravets	0405ba3f31	Update virtualenv if exists	2015-09-09 01:28:43 +03:00
Ivan Kravets	f5f97fe0fd	More explanations about lib directory	2015-09-09 01:01:41 +03:00
Ivan Kravets	82a8bd01fc	Fix `SConsNotInstalled` error for Linux Debian-based distributives	2015-09-09 00:45:51 +03:00
Ivan Kravets	b15408e693	Depend on lockfile >= 0.9.1	2015-09-08 15:08:44 +03:00
Ivan Kravets	74ac9ffa1c	Merge branch 'release/v2.3.1'	2015-09-06 18:17:53 +03:00
Ivan Kravets	ed5f035d1c	Merge branch 'release/v2.3.1' into develop	2015-09-06 18:17:53 +03:00
Ivan Kravets	0f5417bab4	Version bump to 2.3.1 (issues #283 )	2015-09-06 18:17:40 +03:00
Ivan Kravets	0311418bfc	Fix critical issue when `platformio init --ide`__ command hangs PlatformIO // Resolve #283	2015-09-06 18:16:09 +03:00
Ivan Kravets	bc449fec48	Remove SCons from pip instruction	2015-09-05 23:17:01 +03:00
Ivan Kravets	1e7240d6dc	Merge branch 'release/v2.3.0' into develop	2015-09-05 23:05:34 +03:00
Ivan Kravets	2732d63362	Merge branch 'release/v2.3.0'	2015-09-05 23:05:33 +03:00
Ivan Kravets	78bf56e327	Version bump to 2.3.0 (issues #234 , #252 , #256 , #263 , #268 , #270 , #272 , #274 , #277 , #279 )	2015-09-05 23:04:53 +03:00
Ivan Kravets	01eb25cb39	Handle Miniterm exceptions	2015-09-05 22:58:42 +03:00
Ivan Kravets	1f612b466c	Fix platformio path for Windows	2015-09-05 22:43:12 +03:00
Ivan Kravets	0a85e01322	Cleanup	2015-09-05 20:53:50 +03:00
Ivan Kravets	3cb4e6e854	Fix project generator for Windows; update docs for IDE	2015-09-05 20:50:30 +03:00
Ivan Kravets	d566eb2a36	Include subdirectories with tpls for project generator	2015-09-05 10:45:09 +03:00
Ivan Kravets	71890a34be	Reorganise IDE examples	2015-09-04 23:48:57 +03:00
Ivan Kravets	c254a3490c	Fix path for Windows-based projects	2015-09-04 20:35:56 +03:00
Ivan Kravets	a032026f46	Significantly improve "Project Generator" // Resolve #280	2015-09-04 19:31:59 +03:00
Ivan Kravets	e1ee61d31b	Add "-d" option for "--project-dir" to init & run commands	2015-09-04 18:28:13 +03:00
Ivan Kravets	ca4694e1af	Update mbed framework	2015-09-04 13:10:14 +03:00
Ivan Kravets	9fea8f4488	Switch to requires.io	2015-09-04 12:57:11 +03:00
Ivan Kravets	f9f54da914	Fix invalid command context	2015-09-03 20:07:35 +03:00
Ivan Kravets	97c1a27031	Fix serial monitor args	2015-09-03 20:00:24 +03:00
Ivan Kravets	0d8d5fdb32	Allow multiple instances of @PlatformIO	2015-09-03 19:04:09 +03:00
Ivan Kravets	25c448627e	Added short "-h" help option for PlatformIO and sub-commands	2015-09-02 23:07:45 +03:00
Ivan Kravets	baa83c6ee6	Improve PlatformIO upgrading	2015-09-02 13:42:01 +03:00
Ivan Kravets	2f7a6ef0a1	Check that SCons is installed properly	2015-09-01 16:42:41 +03:00
Ivan Kravets	c50332daa2	Allow to run `platformio` directly from the bin folder	2015-09-01 16:15:04 +03:00
Ivan Kravets	8dbb282416	Info about "Add" button when $PATH doesn't exist	2015-08-29 00:51:21 +03:00
Ivan Kravets	ef8f7d4fc0	More explanation about Eclipse and $PATH	2015-08-29 00:47:56 +03:00
Ivan Kravets	74ea4ae9c2	Update installation via pip	2015-08-29 00:25:29 +03:00
Ivan Kravets	2cf1b1420c	Fix used command and version	2015-08-28 23:53:45 +03:00
Ivan Kravets	8bdcf54d9f	Add new article about MBED FRDM-K64F Eclipse/PlatformIO	2015-08-28 23:50:46 +03:00
Ivan Kravets	a815aa15ec	Fix installation issue with pip // Resolve #279	2015-08-28 22:32:39 +03:00
Ivan Kravets	b1dbba6224	Add demo to README	2015-08-28 20:15:40 +03:00
Ivan Kravets	35901a125d	Fix upload link for Wiring Blink demo	2015-08-28 19:55:16 +03:00
Ivan Kravets	52b28867a0	Add "Demo" page	2015-08-28 19:52:37 +03:00
Ivan Kravets	d7d71b60f8	Full text of docs	2015-08-28 17:19:33 +03:00
Ivan Kravets	465e952ae4	Update TOP links	2015-08-28 17:16:30 +03:00
Ivan Kravets	200658ae6d	Use Circle built-in setuptools	2015-08-27 11:09:25 +03:00
Ivan Kravets	e58f5e3617	Fix tox @develop	2015-08-25 18:08:57 +03:00
Ivan Kravets	78ba3176f2	Remove SCons package from develop docs	2015-08-25 16:51:46 +03:00
Ivan Kravets	abd02570f4	Use toolchain's includes pattern "include*" for Project Generator // Resolve #277	2015-08-25 16:45:12 +03:00
Ivan Kravets	97b8d4eeea	Add SCons to requirements list	2015-08-25 16:35:19 +03:00
Ivan Kravets	92036356ca	Pre-upgrade for pip and setuptools for CI	2015-08-25 16:30:16 +03:00
Ivan Kravets	6842df5577	Install @PlatformIO without -U flag by default	2015-08-25 15:21:13 +03:00
Ivan Kravets	793352dfbf	Rephrase installation text	2015-08-25 15:16:25 +03:00
Ivan Kravets	b96535abff	Install @PlatformIO with update option	2015-08-25 15:12:31 +03:00
Ivan Kravets	2b4b50ee08	Add info about pip	2015-08-25 15:11:23 +03:00
Ivan Kravets	e2795716f9	Generate "readme.txt" for project "lib" directory // Resolve #273	2015-08-22 23:11:48 +03:00
Ivan Kravets	47d5783700	Improve installation section	2015-08-22 22:27:35 +03:00
Ivan Kravets	9f6c677276	Remove SCons temporary from requirements list (Circle CI fails)	2015-08-22 17:44:51 +03:00
Ivan Kravets	70f117f63f	Install the latest pip & setuptools packages	2015-08-22 17:42:01 +03:00
Ivan Kravets	83c8e914ae	Fix YAML format	2015-08-22 17:39:19 +03:00
Ivan Kravets	38b6a86858	Install the latest pip & setuptools packages	2015-08-22 17:38:15 +03:00
Ivan Kravets	76267b7db6	Group PlatformIO releases	2015-08-22 17:31:26 +03:00
Ivan Kravets	4cd0febb18	Add information about symlinks // Issue #272	2015-08-22 17:30:58 +03:00
Ivan Kravets	9d9488edd1	Add SCons to requirement list	2015-08-22 17:16:28 +03:00
Ivan Kravets	a1483c263f	Simplified installation process of PlatformIO // Resolve #274	2015-08-22 17:09:28 +03:00
Ivan Kravets	8e42c4ae31	Explain that `lib` dir is suitable for private libraries // Issue #273	2015-08-21 23:56:22 +03:00
Ivan Kravets	bf15ba3a78	Add answer to FAQ when Program “platformio” not found in PATH // Resolve #272	2015-08-21 23:41:50 +03:00
Ivan Kravets	20a0592b37	Fix "AttributeError: 'module' object has no attribute 'packages'" // Resolve #252	2015-08-21 23:09:56 +03:00
Ivan Kravets	5422054ae4	Use original 'returncode' from exec command	2015-08-21 19:50:21 +03:00
Ivan Kravets	ac3844aa95	Add new articles	2015-08-21 17:17:47 +03:00
Valeriy Koval	1b41ffba60	Fix home path environment variable in Eclipse project on Windows // Resolve #270	2015-08-20 14:52:03 +03:00
Ivan Kravets	3393d81452	Hint "save as..." for download get-platformio.py script	2015-08-19 23:11:42 +03:00
Ivan Kravets	25baee266c	Add @PlatformIO Storage stats badge	2015-08-18 16:37:44 +03:00
Ivan Kravets	731467d4e9	Add MinGW to PATH env for AppVeyor	2015-08-17 11:55:42 +03:00
Ivan Kravets	bd03d75f14	Switch to click 5.0	2015-08-17 10:37:53 +03:00
Ivan Kravets	260dd03179	Restore external build flags	2015-08-14 16:09:48 +03:00
Ivan Kravets	35f7d8a4cc	Enhance docs	2015-08-14 00:14:04 +03:00
Ivan Kravets	84fb5e59a9	Update hello-world example	2015-08-10 22:17:37 +03:00
Ivan Kravets	838ba3ad4f	Add new article by Russell Davis	2015-08-10 21:51:09 +03:00
Ivan Kravets	ad7be3b397	Add new development platforms: linux_arm, linux_i686 and linux_x86_64	2015-08-10 21:39:31 +03:00
Ivan Kravets	27ca987284	iSort passed	2015-08-10 16:17:00 +03:00
Ivan Kravets	2b8f7824c2	Add support for Linux 32/64 as host OS for cross compiling to Windows x86	2015-08-10 16:16:16 +03:00
Ivan Kravets	5679271913	Add "Hello World" example for desktop platforms	2015-08-09 21:46:43 +03:00
Ivan Kravets	c9491f47e1	Add support for mingw-linux toolchains	2015-08-09 21:46:07 +03:00
Ivan Kravets	5e2415cb37	Add support for "windows_x86" development platform // Issue #263	2015-08-09 19:05:16 +03:00
Ivan Kravets	2715efd910	Add support for Adafruit Gemma board	2015-08-09 18:08:34 +03:00
Ivan Kravets	b65a356669	Merge pull request #265 from WillemMali/develop improved error wording	2015-08-07 14:56:45 +03:00
WillemMali	9ec0d3bc8c	improved error wording Fixed a grammatical mistake and made the meaning clearer by replacing "it" with "this" and by adding an example. It does increase the length of the output, but I think it's much easier to read and more informative.	2015-08-07 13:14:14 +02:00
Ivan Kravets	acd0ecf38a	Merge pull request #264 from jrobeson/patch-1 fix typo in udev rules file	2015-08-07 13:09:02 +03:00
Johnny Robeson	b75db38e45	fix typo in udev rules file	2015-08-07 05:23:11 -04:00
Ivan Kravets	c7a79cb8b4	Merge pull request #256 from bkudria/adafruit-gemma Adafruit Gemma support	2015-08-05 10:59:59 +03:00
Ivan Kravets	7e5c22706b	Use own mirror when SF is offline	2015-08-04 00:27:13 +03:00
Ivan Kravets	7d5a2c4dfc	Set default PROGNAME to "program"	2015-08-03 23:10:47 +03:00
Ivan Kravets	584d03c802	Propagating External Environment	2015-08-03 15:08:54 +03:00
Ivan Kravets	0646ffc93f	Restore process $PATH for SCons	2015-08-03 12:53:21 +03:00
Ivan Kravets	0f8b506c76	Merge branch 'feature/issue-263-native-platform' into develop	2015-08-03 12:34:03 +03:00
Ivan Kravets	f0d849a702	Added native development platform	2015-08-03 12:33:37 +03:00
Ivan Kravets	0d196ef7b7	Rename env.BuildFirmware to env.BuildProgram	2015-08-02 19:52:37 +03:00
Benjamin Kudria	75edcef099	Adafruit Gemma support	2015-08-01 16:52:14 -07:00
Ivan Kravets	ce82b14f6b	Fix sys env for Windows	2015-08-01 18:33:41 +03:00
Ivan Kravets	e102fb2880	Allow PROGNAME & PROGSUFFIX to be configurable within platform	2015-08-01 17:41:05 +03:00
Ivan Kravets	203026a57b	Use cyclic linker options just for gcc-based compilers	2015-08-01 17:39:15 +03:00
Ivan Kravets	86e39f9b44	More explanations about run --targets	2015-08-01 17:30:20 +03:00
Ivan Kravets	edcad9c251	Add link to Facebook page	2015-07-31 14:22:46 +03:00
Ivan Kravets	cb6d433e15	Add Facebook page	2015-07-31 14:21:30 +03:00