summaryrefslogtreecommitdiffstats
path: root/user/hosts
diff options
context:
space:
mode:
authorChris Johns <chrisj@rtems.org>2016-11-09 12:20:46 +1100
committerChris Johns <chrisj@rtems.org>2016-11-09 12:20:46 +1100
commitaa1c010e313ed4067e4d477f048cc6f0350b5e97 (patch)
tree81a11b93effebbea497262aff02a0b7accc390ca /user/hosts
parentshell: Fix header levels. (diff)
downloadrtems-docs-aa1c010e313ed4067e4d477f048cc6f0350b5e97.tar.bz2
user: Fix header levels.
Diffstat (limited to 'user/hosts')
-rw-r--r--user/hosts/index.rst2
-rw-r--r--user/hosts/macos.rst2
-rw-r--r--user/hosts/os.rst2
-rw-r--r--user/hosts/posix.rst4
-rw-r--r--user/hosts/windows.rst12
5 files changed, 11 insertions, 11 deletions
diff --git a/user/hosts/index.rst b/user/hosts/index.rst
index 5d562e8..71111f9 100644
--- a/user/hosts/index.rst
+++ b/user/hosts/index.rst
@@ -8,7 +8,7 @@
.. _development-host:
Host Computer
--------------
+*************
.. index:: Host Computer
RTEMS applications are developed using cross-development tools running on a
diff --git a/user/hosts/macos.rst b/user/hosts/macos.rst
index 426b303..057679b 100644
--- a/user/hosts/macos.rst
+++ b/user/hosts/macos.rst
@@ -6,7 +6,7 @@
.. _macos:
Apple OS X
-~~~~~~~~~~
+==========
Apple's OS X is fully supported. You need to download and install a recent
version of the Apple developer application Xcode. Xocde is available in the App
diff --git a/user/hosts/os.rst b/user/hosts/os.rst
index 9197144..a120ec2 100644
--- a/user/hosts/os.rst
+++ b/user/hosts/os.rst
@@ -6,7 +6,7 @@
.. _host-os:
Host Operating Systems
-~~~~~~~~~~~~~~~~~~~~~~
+======================
.. sidebar:: *GDB and Python*
diff --git a/user/hosts/posix.rst b/user/hosts/posix.rst
index fd4fb6c..5906428 100644
--- a/user/hosts/posix.rst
+++ b/user/hosts/posix.rst
@@ -6,7 +6,7 @@
.. _posix-hosts:
POSIX Hosts
-~~~~~~~~~~~
+===========
POSIX hosts are most Unix operating systems such as Linux, FreeBSD and
NetBSD. RTEMS development works well on Unix and can scale from a single user
@@ -14,7 +14,7 @@ and a desktop machine to a team with decentralised or centralised development
infrastructure.
Root Access
-^^^^^^^^^^^
+-----------
You either have ``root`` access to your host development machine or you do
not. Some users are given hardware that is centrally managed. If you do not
diff --git a/user/hosts/windows.rst b/user/hosts/windows.rst
index 093fa31..6a76e7c 100644
--- a/user/hosts/windows.rst
+++ b/user/hosts/windows.rst
@@ -6,7 +6,7 @@
.. _microsoft-windows:
Microsoft Windows
-~~~~~~~~~~~~~~~~~
+=================
RTEMS supports Windows as a development host and the tools for most
architectures are available. The RTEMS Project relies on the GNU tools for
@@ -44,7 +44,7 @@ Building is known to work on `Windows 7 64bit Professional` and `Windows 10`.
.. _windows-path-length:
Windows Path Length
-^^^^^^^^^^^^^^^^^^^
+-------------------
Windows path length is limited and can cause problems when building the
tools. The standard Windows API has a ``MAX_PATH`` length of 260
@@ -61,7 +61,7 @@ smaller to build. This is indicated in :ref:`released-version`.
.. _msys2_parallel_builds:
Parallel Builds with Make
-^^^^^^^^^^^^^^^^^^^^^^^^^
+-------------------------
The MSYS2 GNU ``make`` has problems when using the `jobs` option. The RSB
defaults to automatically using as many cores as the host machine has. To get a
@@ -69,7 +69,7 @@ successful build on Windows it is recommended you add the ``--jobs=none``
option to all RSB build set commands.
POSIX Support
-^^^^^^^^^^^^^
+-------------
Building the RTEMS compilers, debugger, the RTEMS kernel and a number of other
3rd party packages requires a POSIX environment. On Windows you can use Cygwin
@@ -87,7 +87,7 @@ distribution and that is a welcome feature on Windows. You get a powerful tool
to manage your development environment on Windows.
Python
-^^^^^^
+------
We need Python to build the tools as the RSB is written in Python and we need
suitable Python libraries to link to GDB as RTEMS makes use of GDB's Python
@@ -113,7 +113,7 @@ generate.
.. _microsoft-windows-installation:
Installing MSYS2
-^^^^^^^^^^^^^^^^
+----------------
MSYS2 is installed on a new machine using the MSYS2 installer found on
https://msys2.github.io/. Please select the ``x86_64`` variant for 64bit