Changeset 5df0d1e in rtems-docs


Ignore:
Timestamp:
Oct 30, 2016, 9:49:18 PM (3 years ago)
Author:
Joel Sherrill <joel@…>
Branches:
4.11, master
Children:
68db56b
Parents:
dd43d0b
git-author:
Joel Sherrill <joel@…> (10/30/16 21:49:18)
git-committer:
Joel Sherrill <joel@…> (10/30/16 21:49:43)
Message:

RSB: Clean up formatting and fix code-block mistakes.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • rsb/source-builder.rst

    rdd43d0b r5df0d1e  
    126126in a BASH shell:
    127127
    128 .. code-block: shell
     128.. code-block:: shell
    129129
    130130    $ export PATH=$HOME/development/rtems/4.11/bin:$PATH
     
    150150Setup a development work space:
    151151
    152 .. code-block: shell
     152.. code-block:: shell
    153153
    154154    $ cd
     
    160160from git:
    161161
    162 .. code-block: shell
     162.. code-block:: shell
    163163
    164164    $ git clone git://git.rtems.org/rtems-source-builder.git
     
    171171Builder provides a tool to help:
    172172
    173 .. code-block: shell
     173.. code-block:: shell
    174174
    175175    $ source-builder/sb-check
    176     warning: exe: absolute exe found in path: (__objcopy) /usr/local/bin/objcopy **<1>**
     176    warning: exe: absolute exe found in path: (__objcopy) /usr/local/bin/objcopy <1>
    177177    warning: exe: absolute exe found in path: (__objdump) /usr/local/bin/objdump
    178     error: exe: not found: (_xz) /usr/local/bin/xz **<2>**
     178    error: exe: not found: (_xz) /usr/local/bin/xz <2>
    179179    RTEMS Source Builder environment is not correctly set up
    180180    $ source-builder/sb-check
    181     RTEMS Source Builder environment is ok **<3>**
    182 
    183 
    184 - **<1>** A tool is in the environment path but does not match the
     181    RTEMS Source Builder environment is ok <3>
     182
     183
     184- *<1>* A tool is in the environment path but does not match the
    185185  expected path.
    186186
    187 - **<2>** The executable 'xz' is not found.
    188 
    189 - **<3>** The host's environment is set up correct.
     187- *<2>* The executable 'xz' is not found.
     188
     189- *<3>* The host's environment is set up correct.
    190190
    191191The checking tool will output a list of executable files not found if problems
     
    208208Source Builder package:
    209209
    210 .. code-block: shell
     210.. code-block:: shell
    211211
    212212    $ cd rtems
     
    215215build ask the tool:
    216216
    217 .. code-block: shell
     217.. code-block:: shell
    218218
    219219    $ ../source-builder/sb-set-builder --list-bsets <1>
     
    311311In this quick start I will build a SPARC tool set.
    312312
    313 .. code-block: shell
     313.. code-block:: shell
    314314
    315315    $ ../source-builder/sb-set-builder --log=l-sparc.txt <1> \
     
    382382The installed tools:
    383383
    384 .. code-block: shell
     384.. code-block:: shell
    385385
    386386    $ ls $HOME/development/rtems/4.11
     
    474474only. To install you would:
    475475
    476 .. code-block: shell
     476.. code-block:: shell
    477477
    478478    $ cd
     
    483483``sb-set-builder`` command.
    484484
    485 .. code-block: shell
     485.. code-block:: shell
    486486
    487487    $ ../source-builder/sb-set-builder --log=l-sparc.txt \
     
    524524when building Canadian cross compiled tool sets.
    525525
    526 .. code-block: shell
     526.. code-block:: shell
    527527
    528528    $ ../source-builder/sb-set-builder --log=l-sparc.txt \
     
    560560build set.
    561561
    562 .. code-block: shell
     562.. code-block:: shell
    563563
    564564    $ ../source-builder/sb-set-builder --log=l-sparc.txt \
     
    681681been generated:
    682682
    683 .. code-block: shell
     683.. code-block:: shell
    684684
    685685     ...
     
    772772use 'sparc-elf'.
    773773
    774 .. code-block: shell
     774.. code-block:: shell
    775775
    776776    $ cd rtems-source-builder/bare
     
    837837and install them then build your tool set. The commands are:
    838838
    839 .. code-block: shell
     839.. code-block:: shell
    840840
    841841    $ ../source-builder/sb-set-builder --log=l-4.11-at.txt \
     
    857857CVS:
    858858
    859 .. code-block: shell
     859.. code-block:: shell
    860860
    861861    $ ../source-builder/sb-set-builder --log=l-4.11-sparc.txt \
     
    867867*newlib*, *gdb* and *RTEMS*:
    868868
    869 .. code-block: shell
     869.. code-block:: shell
    870870
    871871    $ ../source-builder/sb-set-builder --log=l-heads-sparc.txt \
     
    917917This examples shows how to declare a patch for gdb in the ``lm32`` architecture:
    918918
    919 .. code-block: shell
     919.. code-block:: shell
    920920
    921921    %patch add <1> gdb <2> %{rtems_gdb_patches}/lm32/gdb-sim-lm32uart.diff <3>
     
    930930used to add a checksum for a patch that is used to verify the patch:
    931931
    932 .. code-block: shell
     932.. code-block:: shell
    933933
    934934    %hash md5 <1> gdb-sim-lm32uart.diff <2> 77d070878112783292461bd6e7db17fb <3>
     
    944944GDB patch above use:
    945945
    946 .. code-block: shell
     946.. code-block:: shell
    947947
    948948    %patch setup <1> gdb <2> -p1 <3>
     
    967967the .cfg file in ``rtems/config/tools/`` that is included by the bset you use:
    968968
    969 .. code-block: shell
     969.. code-block:: shell
    970970
    971971    %patch add newlib file://0001-this-is-a-newlib-patch.patch <1>
     
    997997To build the NTP package for RTEMS you enter the RSB command:
    998998
    999 .. code-block: shell
     999.. code-block:: shell
    10001000
    10011001    $ ../source-builder/sb-set-builder \
     
    10571057if the cross compiler is ``mingw32-gcc``:
    10581058
    1059 .. code-block: shell
     1059.. code-block:: shell
    10601060
    10611061    $ ../source-builder/sb-set-builder --host=mingw32 \
     
    10671067command line is:
    10681068
    1069 .. code-block: shell
     1069.. code-block:: shell
    10701070
    10711071    $ ../source-builder/sb-set-builder --host=i686-w64-mingw32 \
     
    11021102To build Net-SNMP the command is:
    11031103
    1104 .. code-block: shell
     1104.. code-block:: shell
    11051105
    11061106    cd rtems-source-builder/rtems
     
    11611161  port's path name. For example the NTP package is found in the ``net``
    11621162  directory of the FreeBSD ports tree so the NTP configuration path is
    1163   ``$$rtems/config/net/ntp-4.2.6p5-1.cfg$$`` for that specific version. The
     1163  ``rtems/config/net/ntp-4.2.6p5-1.cfg`` for that specific version. The
    11641164  configuration file name typically provides version specific references
    11651165  and the RTEMS build set file references a specific version. This
     
    11761176  existing versions building. The build configuration should be able to build a
    11771177  package for the build host as well as RTEMS as the RSB abstracts the RTEMS
    1178   specific parts. See <<H1,``_Configuration_``>> for more details.
     1178  specific parts. See :ref:`Configuration` for more details.
    11791179
    11801180BSP Support
     
    12021202to support building 3rd party packages and you need to include this
    12031203file in your RTEMS version specific configuration file. For example the
    1204 Net-SNMP configuration file:
    1205 
    1206 .rtems/config/net-mgmt/net-snmp-5.7.2.1-1.cfg
    1207 
    1208 .. code-block: shell
     1204Net-SNMP configuration file (``rtems/config/net-mgmt/net-snmp-5.7.2.1-1.cfg``):
     1205
     1206.. code-block:: shell
    12091207
    12101208    #
     
    12581256.rtems/config/rtems-bsp.cfg
    12591257
    1260 .. code-block: shell
     1258.. code-block:: shell
    12611259
    12621260    %if %{_host} == %{nil} <1>
     
    12921290
    12931291.rtems/config/rtems-bsp.cfg
    1294 .. code-block: shell
     1292.. code-block:: shell
    12951293
    12961294    %{pkgconfig prefix %{_prefix}/lib/pkgconfig} <1>
     
    13221320
    13231321.rtems/config/rtems-bsp.cfg
    1324 .. code-block: shell
     1322.. code-block:: shell
    13251323
    13261324    %define host_cflags  %{rtems_bsp_cflags}
     
    13371335
    13381336.rtems/config/rtems-bsp.cfg
    1339 .. code-block: shell
     1337.. code-block:: shell
    13401338
    13411339    %define rtems_bsp_prefix  %{_prefix}/%{_host}/%{rtems_bsp} <1>
     
    13651363
    13661364.source-builder/config/ntp-4-1.cfg
    1367 .. code-block: shell
     1365.. code-block:: shell
    13681366
    13691367      ../${source_dir_ntp}/configure \ <1>
     
    13931391.. comment [[H1]]
    13941392
     1393.. _Configuration:
     1394
    13951395Configuration
    13961396#############
     
    14151415``%\{_configdir\}``. It's default is defined as:
    14161416
    1417 .. code-block: shell
     1417.. code-block:: shell
    14181418
    14191419    _configdir   : dir  optional<2>  %{_topdir}/config:%{_sbdir}/config <1>
     
    14461446following schemes are provided:
    14471447
    1448 'http':: Remote access using the HTTP protocol.
    1449 'https':: Remote access using the Secure HTTP protocol.
    1450 'ftp':: Remote access using the FTP protocol.
    1451 'git':: Remote access to a GIT repository.
    1452 'cvs':: Remote access to a CVS repository.
    1453 'pm':: Remote access to a patch management repository.
    1454 'file':: Local access to an existing source directory.
     1448- ``http``: Remote access using the HTTP protocol.
     1449
     1450- ``https``: Remote access using the Secure HTTP protocol.
     1451
     1452- ``ftp``: Remote access using the FTP protocol.
     1453
     1454- ``git``: Remote access to a GIT repository.
     1455
     1456- ``cvs``: Remote access to a CVS repository.
     1457
     1458- ``pm``: Remote access to a patch management repository.
     1459
     1460- ``file``: Local access to an existing source directory.
    14551461
    14561462HTTP, HTTPS, and FTP
     
    14681474download the file. The standard GNU GCC compiler source URL is:
    14691475
    1470 .. code-block: shell
     1476.. code-block:: shell
    14711477
    14721478    %source set<1> gcc<2> ftp://ftp.gnu.org/gnu/gcc/gcc-%{gcc_version}/gcc-%{gcc_version}.tar.bz2
     
    14801486supported compression formats are:
    14811487
    1482 'gz':: GNU ZIP
    1483 'bzip2':: BZIP2
    1484 'zip':: ZIP
    1485 'xy':: XY
     1488- ``gz``: GNU ZIP
     1489
     1490- ``bzip2``: BZIP2
     1491
     1492- ``zip``: ZIP
     1493
     1494- ``xy``: XY
    14861495
    14871496The output of the decompression tool is feed to the standard ``tar`` utility if
     
    15031512STLINK project on GitHub and version is:
    15041513
    1505 .. code-block: shell
     1514.. code-block:: shell
    15061515
    15071516    %define stlink_version 3494c11
     
    15211530the options with ``=``. The options are:
    15221531
    1523 - ``protocol``:: Use a specific protocol. The supported values are *ssh*,
     1532- ``protocol``: Use a specific protocol. The supported values are *ssh*,
    15241533  *git*, *http*, *https*, *ftp*, *ftps*, *rsync*, and *none*.
    15251534
    1526 - ``branch``:: Checkout the specified branch.
    1527 
    1528 - ``pull``:: Perform a pull to update the repository.
    1529 
    1530 - ``fetch``:: Perform a fetch to get any remote updates.
    1531 
    1532 - ``reset``:: Reset the repository. Useful to remove any local
     1535- ``branch``: Checkout the specified branch.
     1536
     1537- ``pull``: Perform a pull to update the repository.
     1538
     1539- ``fetch``: Perform a fetch to get any remote updates.
     1540
     1541- ``reset``: Reset the repository. Useful to remove any local
    15331542  changes. You can pass the ``hard`` argument to force a hard reset.
    15341543
    1535 .. code-block: shell
     1544.. code-block:: shell
    15361545
    15371546    %source set gcc git://gcc.gnu.org/git/gcc.git?branch=gcc-4_7-branch?reset=hard
     
    15561565``=``. The options are:
    15571566
    1558 ``module``:: The module to checkout.
    1559 ``src-prefix``:: The path into the source where the module starts.
    1560 ``tag``:: The CVS tag to checkout.
    1561 ``date``:: The CVS date to checkout.
    1562 
    1563 .. code-block: shell
     1567- ``module``: The module to checkout.
     1568
     1569- ``src-prefix``: The path into the source where the module starts.
     1570
     1571- ``tag``: The CVS tag to checkout.
     1572
     1573- ``date``: The CVS date to checkout.
     1574
     1575The following is an example of checking out from a CVS repository:
     1576
     1577.. code-block:: shell
    15641578
    15651579    %source set newlib cvs://pserver:anoncvs@sourceware.org/cvs/src?module=newlib?src-prefix=src
     
    15781592typically a single number at the end of the package name. For example:
    15791593
    1580 .. code-block: shell
     1594.. code-block:: shell
    15811595
    15821596    %define release 1
     
    15851599with:
    15861600
    1587 .. code-block: shell
     1601.. code-block:: shell
    15881602
    15891603    %{release}
     
    15921606the output of this command because of its size.
    15931607
    1594 .. code-block: shell
     1608.. code-block:: shell
    15951609
    15961610    $ ../source-builder/sb-defaults
     
    16121626The format for a macro in macro files is:
    16131627
    1614 .. comment [options="header,compact",width="50%",cols="15%,15%,15%,55%"]
    1615 |=================================
    1616 | Name | Type | Attribute | String
    1617 |=================================
     1628==== ==== ========= ======
     1629Name Type Attribute String
     1630==== ==== ========= ======
    16181631
    16191632where 'Name' is a case insensitive macro name, the 'Type' field is:
    16201633
    1621 [horizontal]
    1622 ``none``:: Nothing, ignore.
    1623 ``dir``:: A directory path.
    1624 ``exe``:: An executable path.
    1625 ``triplet``:: A GNU style architecture, platform, operating system string.
     1634- ``none``: Nothing, ignore.
     1635
     1636- ``dir``: A directory path.
     1637
     1638- ``exe``: An executable path.
     1639
     1640- ``triplet``: A GNU style architecture, platform, operating system string.
    16261641
    16271642the 'Attribute' field is:
    16281643
    1629 [horizontal]
    1630 ``none``:: Nothing, ignore
    1631 ``required``:: The host check must find the executable or path.
    1632 ``optional``:: The host check generates a warning if not found.
    1633 ``override``:: Only valid outside of the ``global`` map to indicate this macro
    1634              overrides the same one in the ``global`` map when the map containing
    1635              it is selected.
    1636 ``undefine``:: Only valid outside of the ``global`` map to undefine the macro if it
    1637              exists in the ``global`` map when the map containing it is
    1638              selected. The ``global`` map's macro is not visible but still
    1639              exists.
     1644- ``none``:: Nothing, ignore
     1645
     1646- ``required``:: The host check must find the executable or path.
     1647
     1648- ``optional``:: The host check generates a warning if not found.
     1649
     1650- ``override``:: Only valid outside of the ``global`` map to indicate
     1651  this macro overrides the same one in the ``global`` map when the map
     1652  containing it is selected.
     1653
     1654- ``undefine``:: Only valid outside of the ``global`` map to undefine
     1655  the macro if it exists in the ``global`` map when the map containing it
     1656  is selected. The ``global`` map's macro is not visible but still exists.
    16401657
    16411658and the 'String' field is a single or tripled multiline quoted string. The
     
    16451662Maps are declared anywhere in the map using the map directive:
    16461663
    1647 .. code-block: shell
     1664.. code-block:: shell
    16481665
    16491666    # Comments
     
    16561673- *<1>* The map is set to ``my-special-map``.
    16571674
    1658 Any macro defintions following a map declaration are placed in that map and the
    1659 default map is ``global`` when loading a file. Maps are selected in configuration
    1660 files by using the ``%select`` directive.
    1661 
    1662 .. code-block: shell
     1675Any macro defintions following a map declaration are placed in that map
     1676and the default map is ``global`` when loading a file. Maps are selected
     1677in configuration files by using the ``%select`` directive.
     1678
     1679.. code-block:: shell
    16631680
    16641681    %select my-special-map
     
    16771694*RTEMS* from version control heads is:
    16781695
    1679 .. code-block: shell
     1696.. code-block:: shell
    16801697
    16811698    # <1>
     
    17151732- SMTP host
    17161733
    1717 .To Mail Address
     1734.. _To Mail Address:
    17181735
    17191736The ``to`` mail address is taken from the macro ``%{_mail_tools_to}`` and the
     
    17211738with a personal or user macro file or via the command line option *--mail-to*.
    17221739
    1723 .From Mail Address
     1740.. _From Mail Address:
    17241741
    17251742The ``from`` mail address is taken from:
     
    17571774Defining macros is performed with the ``%define`` macro:
    17581775
    1759 .. code-block: shell
     1776.. code-block:: shell
    17601777
    17611778    %define _target m32r-rtems4.11
     
    17651782point.
    17661783
    1767 .. code-block: shell
     1784.. code-block:: shell
    17681785
    17691786    %include rtems-4.11-base.bset
     
    17751792on a single line.
    17761793
    1777 .. code-block: shell
     1794.. code-block:: shell
    17781795
    17791796    tools/rtems-binutils-2.22-1
     
    18051822that make up this package:
    18061823
    1807 .. code-block: shell
     1824.. code-block:: shell
    18081825
    18091826    %define gcc_version    4.7.2
     
    18151832The package build options, if there are any are also defined:
    18161833
    1817 .. code-block: shell
     1834.. code-block:: shell
    18181835
    18191836    %define with_threads 1
     
    18251842included:
    18261843
    1827 .. code-block: shell
     1844.. code-block:: shell
    18281845
    18291846    Patch0: gcc-4.7.2-rtems4.11-20121026.diff
     
    18311848Finally including the GCC 4.7 configuration script:
    18321849
    1833 .. code-block: shell
     1850.. code-block:: shell
    18341851
    18351852    %include %{_configdir}/gcc-4.7-1.cfg
     
    18551872To create a private configuration change to a suitable directory:
    18561873
    1857 .. code-block: shell
     1874.. code-block:: shell
    18581875
    18591876    $ cd ~/work
     
    19311948this case if a release is not provided a default of 1 is used.
    19321949
    1933 .. code-block: shell
     1950.. code-block:: shell
    19341951
    19351952    #
     
    19471964information is kept updated and accurate.
    19481965
    1949 .. code-block: shell
     1966.. code-block:: shell
    19501967
    19511968    Name:      dtc-%{dtc_version}-%{_host}-%{release}
     
    19631980packages based on the outer configuration options.
    19641981
    1965 .. code-block: shell
     1982.. code-block:: shell
    19661983
    19671984    #
     
    19982015supply a custom patch for testing using the user macro command line interface.
    19992016
    2000 .. code-block: shell
     2017.. code-block:: shell
    20012018
    20022019    #
     
    20262043make stage. Again the GCC common configuration file provides a detailed example.
    20272044
    2028 .. code-block: shell
     2045.. code-block:: shell
    20292046
    20302047    %build
     
    20672084configurations learning these can take a little time.
    20682085
    2069 .. code-block: shell
     2086.. code-block:: shell
    20702087
    20712088    %install
     
    20872104in the +tar+ directory.
    20882105
    2089 .. code-block: shell
     2106.. code-block:: shell
    20902107
    20912108    $  ../source-builder/sb-builder --prefix=/usr/local \
     
    21082125The DTC build set file is called +dtc.bset+ and contains:
    21092126
    2110 .. code-block: shell
     2127.. code-block:: shell
    21112128
    21122129    #
     
    21202137To build this you can use something similar to:
    21212138
    2122 .. code-block: shell
     2139.. code-block:: shell
    21232140
    21242141    $ ../source-builder/sb-set-builder --prefix=/usr/local --log=log_dtc \
     
    21812198containing:
    21822199
    2183 .. code-block: shell
     2200.. code-block:: shell
    21842201
    21852202    [gcc-4.7-snapshot]
     
    21922209map is selected with:
    21932210
    2194 .. code-block: shell
     2211.. code-block:: shell
    21952212
    21962213    #
     
    23232340mixed with some shell commands to correct any source issues.
    23242341
    2325 .. code-block: shell
     2342.. code-block:: shell
    23262343
    23272344                  <1>                <2>      <3>
     
    23372354example:
    23382355
    2339 .. code-block: shell
     2356.. code-block:: shell
    23402357
    23412358    %source set gdb http://ftp.gnu.org/gnu/gdb/gdb-%{gdb_version}.tar.bz2
     
    23552372the following scripting:
    23562373
    2357 .. code-block: shell
     2374.. code-block:: shell
    23582375
    23592376    %source set gcc ftp://ftp.gnu.org/gnu/gcc/gcc-%{gcc_version}/gcc-code-%{gcc_version}.tar.bz2
     
    23642381uses Newlib, MPFR, MPC, and GMP source packages. You define the source with:
    23652382
    2366 .. code-block: shell
     2383.. code-block:: shell
    23672384
    23682385    %source set gcc ftp://ftp.gnu.org/gnu/gcc/gcc-%{gcc_version}/gcc-%{gcc_version}.tar.bz2
     
    23742391and set up with:
    23752392
    2376 .. code-block: shell
     2393.. code-block:: shell
    23772394
    23782395    %source setup gcc -q -n gcc-%{gcc_version}
     
    23882405before the patch URL. Patches with no options uses the +setup+ default.
    23892406
    2390 .. code-block: shell
     2407.. code-block:: shell
    23912408
    23922409    %patch add gdb %{rtems_gdb_patches}/gdb-sim-arange-inline.diff
     
    23972414To apply these patches:
    23982415
    2399 .. code-block: shell
     2416.. code-block:: shell
    24002417
    24012418    %patch setup gdb -p1 <1>
     
    24152432NOTE: STLink is a JTAG debugging device for the ST ARM family of processors.
    24162433
    2417 .. code-block: shell
     2434.. code-block:: shell
    24182435
    24192436    %build
     
    24832500Looking at the same example as in <<_build, %build>>:
    24842501
    2485 .. code-block: shell
     2502.. code-block:: shell
    24862503
    24872504    %install
     
    25312548builds the package.
    25322549
    2533 .. code-block: shell
     2550.. code-block:: shell
    25342551
    25352552    %include %{_configdir}/gcc-4.7-1.cfg
     
    25422559with Newlib configuration the name is typically:
    25432560
    2544 .. code-block: shell
     2561.. code-block:: shell
    25452562
    25462563    Name: %{_target}-gcc-%{gcc_version}-newlib-%{newlib_version}-%{release}
     
    25532570with Newlib configuration the summary is typically:
    25542571
    2555 .. code-block: shell
     2572.. code-block:: shell
    25562573
    25572574    Summary: GCC v%{gcc_version} and Newlib v%{newlib_version} for target %{_target} on host %{_host}
     
    25642581configuration building the package changes.
    25652582
    2566 .. code-block: shell
     2583.. code-block:: shell
    25672584
    25682585    %define release 1
     
    25772594case the GCC version is used.
    25782595
    2579 .. code-block: shell
     2596.. code-block:: shell
    25802597
    25812598    Version: %{gcc_version}
     
    26102627for specific releases or snapshots.. To set a source file group:
    26112628
    2612 .. code-block: shell
     2629.. code-block:: shell
    26132630
    26142631    %source set gcc <1> ftp://ftp.gnu.org/gnu/gcc/gcc-%{gcc_version}/gcc-%{gcc_version}.tar.bz2
     
    26192636the +add+ command:
    26202637
    2621 .. code-block: shell
     2638.. code-block:: shell
    26222639
    26232640    %source add gcc ftp://ftp.gnu.org/gnu/gcc/gcc-%{gcc_version}/g++-%{gcc_version}.tar.bz2
     
    26262643setup is:
    26272644
    2628 .. code-block: shell
     2645.. code-block:: shell
    26292646
    26302647    %source gcc setup -q -T -D -n %{name}-%{version}
     
    26672684To add a patch:
    26682685
    2669 .. code-block: shell
     2686.. code-block:: shell
    26702687
    26712688    %patch add gcc <1>  gcc-4.7.2-rtems4.11-20121026.diff
     
    26782695Placing +%patch setup+ in the +%prep+ section will apply the groups patches.
    26792696
    2680 .. code-block: shell
     2697.. code-block:: shell
    26812698
    26822699    %patch setup gcc <1>  -p1 <2>
     
    27022719To add a hash:
    27032720
    2704 .. code-block: shell
     2721.. code-block:: shell
    27052722
    27062723    %hash md5 <1> net-snmp-%{net_snmp_version}.tar.gz <2> 7db683faba037249837b226f64d566d4 <3>
     
    27502767The default map is ``global``.
    27512768
    2752 .. code-block: shell
     2769.. code-block:: shell
    27532770
    27542771    %select gcc-4.8-snapshot <1>
     
    27672784is given it is assumed to be 1.
    27682785
    2769 .. code-block: shell
     2786.. code-block:: shell
    27702787
    27712788    %define foo bar
     
    28492866macro is defined:
    28502867
    2851 .. code-block: shell
     2868.. code-block:: shell
    28522869
    28532870    %ifn %{defined foo}
     
    29052922This commands checks your system is set up correctly. Most options are ignored.
    29062923
    2907 .. code-block: shell
     2924.. code-block:: shell
    29082925
    29092926    $ ../source-builder/sb-check --help
     
    29482965arguments. Most options are ignored.
    29492966
    2950 .. code-block: shell
     2967.. code-block:: shell
    29512968
    29522969    $ ../source-builder/sb-defaults --help
     
    29873004This command builds a set.
    29883005
    2989 .. code-block: shell
     3006.. code-block:: shell
    29903007
    29913008    $ ../source-builder/sb-set-builder --help
     
    31503167file. Configuration files have the extension of +.cfg+.
    31513168
    3152 .. code-block: shell
     3169.. code-block:: shell
    31533170
    31543171    $ ./source-builder/sb-builder --help
     
    32073224The following packages are required on a fresh Archlinux 64bit installation:
    32083225
    3209 .. code-block: shell
     3226.. code-block:: shell
    32103227
    32113228    # pacman -S base-devel gdb xz unzip ncurses git zlib
     
    32153232a manual override.
    32163233
    3217 .. code-block: shell
     3234.. code-block:: shell
    32183235
    32193236    # pacman -R texinfo
     
    32283245The following packages are required on a minimal CentOS 6.3 64bit installation:
    32293246
    3230 .. code-block: shell
     3247.. code-block:: shell
    32313248
    32323249    # yum install autoconf automake binutils gcc gcc-c++ gdb make patch \
     
    32443261The RTEMS Source Builder has been tested on Fedora 19 64bit with the following packages.
    32453262
    3246 .. code-block: shell
     3263.. code-block:: shell
    32473264
    32483265    # yum install ncurses-devel python-devel git bison gcc cvs gcc-c++ \
     
    32573274required.
    32583275
    3259 .. code-block: shell
     3276.. code-block:: shell
    32603277
    32613278    $ sudo apt-get install autoconf automake bison flex binutils gcc g++ gdb \
     
    32763293packages installed.
    32773294
    3278 .. code-block: shell
     3295.. code-block:: shell
    32793296
    32803297    $ sudo apt-get build-dep binutils gcc g++ gdb unzip git
     
    32893306than the usual zlib-dev):
    32903307
    3291 .. code-block: shell
     3308.. code-block:: shell
    32923309
    32933310    # sudo apt-get install zlib1g-dev
     
    33093326need to install some ports. They are:
    33103327
    3311 .. code-block: shell
     3328.. code-block:: shell
    33123329
    33133330    # cd /usr/ports
     
    33173334ports:
    33183335
    3319 .. code-block: shell
     3336.. code-block:: shell
    33203337
    33213338    # cd /usr/ports
     
    33373354are:
    33383355
    3339 .. code-block: shell
     3356.. code-block:: shell
    33403357
    33413358    # pkg_add ftp://ftp.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/6.1/devel/gmake-3.82nb7.tgz
     
    34163433To build the tools you need install the following packages using pacman:
    34173434
    3418 .. code-block: shell
     3435.. code-block:: shell
    34193436
    34203437 $ pacman -S git cvs bison make texinfo patch unzip diffutils tar \
     
    34863503output for an RTEMS 4.10 ARM tool set is:
    34873504
    3488 .. code-block: shell
     3505.. code-block:: shell
    34893506
    34903507    chris@cygthing ~/development/rtems/src/rtems-source-builder/rtems
Note: See TracChangeset for help on using the changeset viewer.