[PATCH 01/10] user: Rework "Host Computer Setup" section

Sebastian Huber sebastian.huber at embedded-brains.de
Thu Jan 24 08:55:10 UTC 2019


Rename it to "Prepare Your Host Computer".
---
 user/rsb/why-build-from-source.rst |  2 ++
 user/start/host.rst                | 20 +++++++++++---------
 2 files changed, 13 insertions(+), 9 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..23192a5 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
 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 other tools 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