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

[Chris Johns]

On 29/1/19 1:27 am, Sebastian Huber wrote:
> 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

I think this should be `gory details`. Looks like something I would have done.

> +particular :ref:`Microsoft Windows <microsoft-windows>` user should do this.

Chris