Changeset 0facb9d in rtems-docs


Ignore:
Timestamp:
01/11/19 14:28:57 (5 years ago)
Author:
Sebastian Huber <sebastian.huber@…>
Branches:
5, master
Children:
3ed59ce
Parents:
3de74ba
git-author:
Sebastian Huber <sebastian.huber@…> (01/11/19 14:28:57)
git-committer:
Sebastian Huber <sebastian.huber@…> (01/14/19 06:15:27)
Message:

user: Move "Prefixes" to "Quick Start"

Move "Project Sandboxing" to a separate section of the "Installation"
chapter since this is an advance topic which may confuse new users.

Location:
user
Files:
1 added
2 edited
1 moved

Legend:

Unmodified
Added
Removed
  • user/installation/index.rst

    r3de74ba r0facb9d  
    4646.. toctree::
    4747
    48    prefixes-sandboxing
    4948   releases
    5049   developer
    5150   kernel
     51   project-sandboxing
  • user/installation/project-sandboxing.rst

    r3de74ba r0facb9d  
    55.. index:: Prefixes
    66.. _prefixes:
    7 
    8 Prefixes
    9 ========
    10 
    11 You will see the term :ref:term:`prefix` referred to thoughout this
    12 documentation and in a wide number of software packages you can download from
    13 the internet. A **prefix** is the path on your computer a software package is
    14 built and installed under. Packages that have a **prefix** will place all parts
    15 under the **prefix** path. On a host computer like Linux the packages you
    16 install from your distribution typically use a platform specific standard
    17 **prefix**. For example on Linux it is :file:`/usr` and on FreeBSD it is
    18 :file:`/usr/local`.
    19 
    20 We recommend you *DO NOT* use the standard **prefix** when installing the RTEMS
    21 Tools. The standard **prefix** is the default **prefix** each package built by
    22 the RSB contains. If you are building the tools when logged in as a *Standard
    23 User* and not as the *Super User* (``root``) or *Administrator* the RTEMS
    24 Source Builder (RSB) *will* fail and report an error if the default **prefix**
    25 is not writable. We recommend you leave the standand **prefix** for the
    26 packages your operating system installs or software you manually install such
    27 as applications.
    28 
    29 A further reason not to use the standard **prefix** is to allow more than one
    30 version of RTEMS to exist on your host machine at a time. The ``autoconf`` and
    31 ``automake`` tools required by RTEMS are not versioned and vary between the
    32 various versions of RTEMS. If you use a single **prefix** such as the standard
    33 **prefix** there is a chance parts from a package of different versions may
    34 interact. This should not happen but it can.
    35 
    36 For POSIX or Unix hosts, the RTEMS Project uses :file:`/opt/rtems` as it's
    37 standard **prefix**. We view this **prefix** as a production level path, and we
    38 prefer to place development versions under a different **prefix** away from the
    39 production versions. Under this top level **prefix** we place the various
    40 versions we need for development. For example the version 4.11.0 **prefix**
    41 would be :file:`/opt/rtems/4.11.0`. If an update called 4.11.1 is released the
    42 **prefix** would be :file:`/opt/rtems/4.11.1`. These are recommendations and
    43 the choice of what you use is entirely yours. You may decide to have a single
    44 path for all RTEMS 4.11 releases of :file:`/opt/rtems/4.11`.
    45 
    46 For Windows a typical **prefix** is :file:`C:\\opt\\rtems` and as an MSYS2 path
    47 this is :file:`/c/opt/rtems`.
    487
    498.. _project-sandboxing:
  • user/start/index.rst

    r3de74ba r0facb9d  
    99Quick Start
    1010***********
     11
     12Follow the sections of this chapter step by step to get started developing
     13applications on top of RTEMS.
     14
     15.. toctree::
     16    :maxdepth: 5
     17    :numbered:
     18
     19    prefixes
    1120
    1221The following is a quick start guide that provides a basic set of commands to
Note: See TracChangeset for help on using the changeset viewer.