diff --git a/docs/index.rst b/docs/index.rst index b8e05a5a..de7afbc6 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -51,7 +51,7 @@ Embedded Development. *Easier Than Ever.* * Cloud compiling and :ref:`ci` with *AppVeyor, Circle CI, Drone, Shippable, Travis CI* * Built-in :ref:`Serial Port Monitor ` and configurable build :ref:`-flags/-options ` -* Pre-built tool chains, :ref:`frameworks` for the +* Pre-built toolchains, :ref:`frameworks` for the :ref:`Development Platforms ` Smart Code Builder. *Fast and Reliable.* diff --git a/docs/installation.rst b/docs/installation.rst index 5912a302..ea2d663b 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -25,28 +25,27 @@ computers (`Raspberry Pi `_, System requirements ------------------- -* **Operating systems:** - * Mac OS X - * Linux, +ARM - * Windows -* Python 2.6.x or Python 2.7.x(recommended) +:Operating System: Mac OS X, Linux (+ARM) or Windows +:Python Interpreter: -All commands below should be executed in -`Command-line `_ -application (Terminal): + Python 2.6 or 2.7. Python 2.7 is recommended -* Mac OS X / Linux – *Terminal* application -* Windows – ``cmd.exe`` application. + .. attention:: + **Windows Users**: Please `Download the latest Python 2.7.x + `_ and install it. + **DON'T FORGET** to select ``Add python.exe to Path`` feature on the + "Customize" stage. + +:Terminal Application: + + All commands below should be executed in + `Command-line `_ + application (Terminal). For Mac OS X and Linux OS - *Terminal* application, + for Windows OS – ``cmd.exe`` application. Installation Methods -------------------- -.. warning:: - **Windows OS**: Please `Download the latest Python 2.7.x - `_ and install it. - **DON'T FORGET** to select ``Add python.exe to Path`` feature on the - "Customize" stage. - Please *choose ONE of* the following methods: a) Python Package Manager diff --git a/docs/platforms/creating_platform.rst b/docs/platforms/creating_platform.rst index 598d7d56..14cdb8dc 100644 --- a/docs/platforms/creating_platform.rst +++ b/docs/platforms/creating_platform.rst @@ -19,10 +19,10 @@ for the different development platforms via single command :ref:`cmd_run` without any dependent software or requirements. For this purpose *PlatformIO* uses own pre-configured platforms data: -build scripts, tool chains, the settings for the most popular embedded +build scripts, toolchains, the settings for the most popular embedded boards and etc. These data are pre-built and packaged to the different ``packages``. It allows *PlatformIO* to have multiple development platforms -which can use the same packages(tool chains, frameworks), but have +which can use the same packages(toolchains, frameworks), but have different/own build scripts, uploader and etc. .. note:: diff --git a/docs/projectconf.rst b/docs/projectconf.rst index f2ca9ef6..ee79d7e8 100644 --- a/docs/projectconf.rst +++ b/docs/projectconf.rst @@ -44,7 +44,7 @@ Options ``home_dir`` ^^^^^^^^^^^^ -Is used to store platform tool chains, frameworks, external libraries, +Is used to store platform toolchains, frameworks, external libraries, service data and etc. A default value is User's home directory: @@ -398,7 +398,7 @@ Example: ^^^^^^^^^^^^^^^^ Control cyclic (recursive) behaviour for ``Library Dependency Finder (LDF)``. -By default, this option is turned OFF (``lib_dfcyclic=False``) and means, that +By default, this option is turned OFF (``lib_dfcyclic=False``) and means that ``LDF`` will find only libraries which are included in source files from the project :ref:`projectconf_pio_src_dir`. @@ -453,7 +453,7 @@ Example, specify own upload command for :ref:`platform_atmelavr`: * see built-in examples of `PlatformIO build scripts `_. -* take a look on the multiple snippets/answers for the user questions: +* take a look at the multiple snippets/answers for the user questions: `#365 `_, `#351 `_, `#236 `_, diff --git a/docs/quickstart.rst b/docs/quickstart.rst index baa5e1fa..3ec9f2df 100644 --- a/docs/quickstart.rst +++ b/docs/quickstart.rst @@ -14,7 +14,7 @@ Quickstart ========== -.. note:: +.. hint:: Please read `Get Started `_ article from the official WebSite. diff --git a/docs/userguide/cmd_init.rst b/docs/userguide/cmd_init.rst index 69702b05..49a43c22 100644 --- a/docs/userguide/cmd_init.rst +++ b/docs/userguide/cmd_init.rst @@ -73,7 +73,7 @@ Initialise PlatformIO project for the specified IDE which can be imported later via "Import Project" functionality. A list with supported IDE is available within ``platformio init --help`` command. -Also, please look into :ref:`ide` page. +Also, please take a look at :ref:`ide` page. .. option:: --enable-auto-uploading diff --git a/platformio/platforms/native.py b/platformio/platforms/native.py index 8665e12a..b6c2f375 100644 --- a/platformio/platforms/native.py +++ b/platformio/platforms/native.py @@ -19,7 +19,7 @@ class NativePlatform(BasePlatform): """ Native development platform is intended to be used for desktop OS. - This platform uses built-in tool chains (preferable based on GCC), + This platform uses built-in toolchains (preferable based on GCC), frameworks, libs from particular OS where it will be run. http://platformio.org/#!/platforms/native