[PATCH v2 01/10] user: Rework "Host Computer Setup" section
Sebastian Huber
sebastian.huber at embedded-brains.de
Mon Jan 28 12:27:03 UTC 2019
Rename it to "Prepare Your Host Computer".
---
user/rsb/why-build-from-source.rst | 2 ++
user/start/host.rst | 22 ++++++++++++----------
2 files changed, 14 insertions(+), 10 deletions(-)
diff --git a/user/rsb/why-build-from-source.rst b/user/rsb/why-build-from-source.rst
index eefeade..d9cdcff 100644
--- a/user/rsb/why-build-from-source.rst
+++ b/user/rsb/why-build-from-source.rst
@@ -2,6 +2,8 @@
.. Copyright (C) 2012, 2016 Chris Johns <chrisj at rtems.org>
+.. _WhyBuildFromSource:
+
Why Build from Source?
======================
diff --git a/user/start/host.rst b/user/start/host.rst
index 1437290..19bbb9b 100644
--- a/user/start/host.rst
+++ b/user/start/host.rst
@@ -5,15 +5,17 @@
.. _QuickStartHost:
-Host Computer Setup
-===================
+Prepare Your Host Computer
+==========================
-The *host computer* is the thing you use to develop applications. It runs all
+The *host computer* is a computer you use to develop applications. It runs all
your tools, editors, documentation viewers, etc. To get started with RTEMS
-development you need other tools. This includes a native C, C++ and Python
-development environment. Please make sure that you can build native C/C++
-applications on your host computer. You must be able to build native Python C
-modules. Usually you have to install a Python development package for this.
-Please have a look at the :ref:`Host Computer <host-computer>` chapter for the
-glory details. In particular :ref:`Microsoft Windows <microsoft-windows>` user
-should do this.
+development you need tools from your host's operating system to build the RTEMS
+tool suite from source. This is not a one-click installation process, but
+there are :ref:`good reasons <WhyBuildFromSource>` to build everything from
+source. You need a native C, C++ and Python development environment. Please
+make sure that you can build native C/C++ applications on your host computer.
+You must be able to build native Python C modules. Usually, you have to
+install a Python development package for this. Please have a look at the
+:ref:`Host Computer <host-computer>` chapter for the glory details. In
+particular :ref:`Microsoft Windows <microsoft-windows>` user should do this.
--
2.16.4
More information about the devel
mailing list