Changeset dc234b5 in rtems-docs for user/start/depend.rst


Ignore:
Timestamp:
03/23/16 02:57:56 (6 years ago)
Author:
Chris Johns <chrisj@…>
Branches:
4.11, 5, am, master
Children:
6958370
Parents:
c075916
git-author:
Chris Johns <chrisj@…> (03/23/16 02:57:56)
git-committer:
Amar Takhar <verm@…> (05/03/16 00:51:27)
Message:

Corrections from a review.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • user/start/depend.rst

    rc075916 rdc234b5  
    1515it is, however this approach works well. RTEMS is not a host operating system
    1616and it is not a distrbution. Providing binary packages for every possible host
    17 operating system is to big a task for the RTEMS Project and it is not a good
    18 use of the core developer's time. Their time is better spent making RTEMS
    19 better and faster.
     17operating system is too big a task for the RTEMS Project and it is not a good
     18use of core developer time. Their time is better spent making RTEMS better and
     19faster.
    2020
    2121Developer Computer
     
    208208We need Python to build the tools as the RSB is written in Python and we need
    209209suitable Python libraries to link to GDB as RTEMS makes use of GDB's Python
    210 support. This place specific demands on the Python we need installed and
     210support. This places specific demands on the Python we need installed and
    211211available and MSYS2 provides suitable Python versions we can use. You need to
    212212make sure you have the correct type and version of Python installed.
     
    215215as they are built by Microsoft's C (MSC) compiler. Linking the MSC Python
    216216libraries with the MinGW64 executables is not easy and MSYS provided us with a
    217 simple solution so we do not support this.
    218 
    219 MSYS2 provides two types and versions of Python executables, MinGW and MSYS and
    220 Python version 2 and 3. For Windows we need the MinGW executable so we have
    221 suitables libraries and we have to have Python version 2 because on Windows GDB
    222 only builds with Python2.
    223 
    224 You also need to install the MSYS version of Python along with the MinGW64
    225 Python2 package. The MSYS Python is version 3 and the RSB can support version 2
    226 and 3 of Python and it helps handle some of the long paths building GCC can
    227 generate.
    228 
    229 Installing MSYS2
    230 ~~~~~~~~~~~~~~~~
    231 
    232 MSYS2 is installed on a new machine using the MSYS2 installer found on
    233 https://msys2.github.io/. Please select the ``x86_64`` variant for 64bit
    234 support. Run the installer followin the 7 steps listed on the page.
    235 
    236 MSYS2 uses the ``pacman`` package manager. The Arch Linux project has detailed
    237 documentation on how to use ``pacman``. What is shown here is a just few
    238 examples of what you can do.
    239 
    240 .. sidebar:: **Pin MSYS2 Shell to Taskbar**
    241 
    242   Pin the MSYS2 64bit Shell to the Taskbar so you always use it rather than
    243   the 32bit Shell.
    244 
    245 Open a 64bit MSYS shell from the Start Menu:
    246 
    247 .. figure:: msys2-minw64-start-menu.png
    248   :width: 50%
    249   :align: center
    250   :alt: MSYS2 64bit Shell Start Menu
    251 
    252 The packages we require are:
    253 
    254  * python
    255  * mingw-w64-x86_64-python2
    256  * mingw-w64-x86_64-gcc
    257  * git
    258  * bison
    259  * cvs
    260  * diffutils
    261  * make
    262  * patch
    263  * tar
    264  * texinfo
    265  * unzip
    266 
    267 .. note::
    268 
    269   The actual output provided may vary due to changes in the dependent packages
    270   or newer package versions.
    271 
    272 Install the packages using ``pacman``:
    273 
    274 .. code-block:: shell
    275 
    276   ~
    277   $ pacman -S python mingw-w64-x86_64-python2 mingw-w64-x86_64-gcc \
    278   >          bison cvs diffutils git make patch tar texinfo unzip
    279   resolving dependencies...
     217| simple solution so we do not support linking MSC libraries.
     218
     219| MSYS2 provides two types and versions of Python executables, MinGW and MSYS and
     220| Python version 2 and 3. For Windows we need the MinGW executable so we have
     221| suitables libraries and we have to have Python version 2 because on Windows GDB
     222| only builds with Python2.
     223
     224| You also need to install the MSYS version of Python along with the MinGW64
     225| Python2 package. The MSYS Python is version 3 and the RSB can support version 2
     226| and 3 of Python and it helps handle some of the long paths building GCC can
     227| generate.
     228
     229| Installing MSYS2
     230| ~~~~~~~~~~~~~~~~
     231
     232| MSYS2 is installed on a new machine using the MSYS2 installer found on
     233| https://msys2.github.io/. Please select the ``x86_64`` variant for 64bit
     234| support. Run the installer following the 7 steps listed on the page.
     235
     236| MSYS2 uses the ``pacman`` package manager. The Arch Linux project has detailed
     237| documentation on how to use ``pacman``. What is shown here is a just few
     238| examples of what you can do.
     239
     240| .. sidebar:: **Pin MSYS2 Shell to Taskbar**
     241
     242| Pin the MSYS2 64bit Shell to the Taskbar so you always use it rather than
     243| the 32bit Shell.
     244
     245| Open a 64bit MSYS shell from the Start Menu:
     246
     247| .. figure:: msys2-minw64-start-menu.png
     248| :width: 50%
     249| :align: center
     250| :alt: MSYS2 64bit Shell Start Menu
     251
     252| The packages we require are:
     253
     254| * python
     255| * mingw-w64-x86_64-python2
     256| * mingw-w64-x86_64-gcc
     257| * git
     258| * bison
     259| * cvs
     260| * diffutils
     261| * make
     262| * patch
     263| * tar
     264| * texinfo
     265| * unzip
     266
     267| .. note::
     268
     269| The actual output provided may vary due to changes in the dependent packages
     270| or newer package versions.
     271
     272| Install the packages using ``pacman``:
     273
     274| .. code-block:: shell
     275
     276| ~
     277| $ pacman -S python mingw-w64-x86_64-python2 mingw-w64-x86_64-gcc \
     278| bison cvs diffutils git make patch tar texinfo unzip
     279| resolving dependencies...
    280280  looking for conflicting packages...
    281281
Note: See TracChangeset for help on using the changeset viewer.