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

[Chris Johns]

On 24/1/19 7:55 pm, Sebastian Huber wrote:
> 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

I know this is not in your patch but reading the patch this could change ..

 The *host computer* is a computer you use to develop applications.

>  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.

What about ..

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.

Nice.

Chris