Changeset 624954b in rtems-source-builder for doc/source-builder.txt


Ignore:
Timestamp:
Apr 26, 2013, 2:05:53 AM (6 years ago)
Author:
Chris Johns <chrisj@…>
Branches:
4.10, 4.11, 4.9, master
Children:
dbede73
Parents:
8f30997
Message:

Add macro include support. Use it for building from head.

This change provides a simple way to build all parts of the tools from
version control.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/source-builder.txt

    r8f30997 r624954b  
    780780currently detected and will cause the tool to lock up.
    781781
    782 Maps are declared anywhere in the map using:
     782Maps are declared anywhere in the map using the map directive:
    783783
    784784-------------------------------------------------------------
    785785# Comments
    786 [my-special-map]
     786[my-special-map] <1>
    787787_host:  none, override, 'abc-xyz'
    788788multiline: none, override, '''First line,
     
    790790and finally the last line'''
    791791-------------------------------------------------------------
     792<1> The map is set to `my-special-map`.
    792793
    793794Any macro defintions following a map declaration are placed in that map and the
     
    804805please make sure you use the `override` attibute.
    805806
    806 The macro files are looked for in the `_configdir` paths. See
    807 <<X1,+_configdir+>> variable for details.
     807The macro files specificed on the command line are looked for in the
     808`_configdir` paths. See <<X1,+_configdir+>> variable for details. Included
     809files need to add the `%{_configdir}` macro to the start of the file.
     810
     811Macro map files can include other macro map files using the `%include`
     812directive. The macro map to build _binutils_, _gcc_, _newlib_, _gdb_ and
     813_RTEMS_ from version control heads is:
     814
     815-------------------------------------------------------------
     816# <1>
     817# Build all tool parts from version control head.
     818#
     819%include %{_configdir}/snapshots/binutils-head.mc
     820%include %{_configdir}/snapshots/gcc-head.mc
     821%include %{_configdir}/snapshots/newlib-head.mc
     822%include %{_configdir}/snapshots/gdb-head.mc
     823-------------------------------------------------------------
     824<1> The file is `config/snapshots/binutils-gcc-newlib-gdb-head.mc`.
     825
     826The macro map defaults to `global` at the start of each included file and the
     827map setting of the macro file including the other macro files does not change.
    808828
    809829Build Set Files
     
    16391659To build snapshots for testing purposes you use the available macro maps
    16401660passing them on the command line using the `--macros` option. For RTEMS these
    1641 are held in `config/snapshots` directory. The following build _newlib_ from
     1661are held in `config/snapshots` directory. The following builds _newlib_ from
    16421662CVS:
    16431663
    16441664-------------------------------------------------------------
    16451665$ ../source-builder/sb-set-builder --log=l-4.11-sparc.txt \
    1646    --prefix=$HOME/development/rtems/4.11 --macros=snapshots/newlib-head.mc
     1666   --prefix=$HOME/development/rtems/4.11 \
     1667   --macros=snapshots/newlib-head.mc \
     1668   4.11/rtems-sparc
     1669-------------------------------------------------------------
     1670
     1671and the following uses the version control heads for _binutils_, _gcc_,
     1672_newlib_, _gdb_ and _RTEMS_:
     1673
     1674-------------------------------------------------------------
     1675$ ../source-builder/sb-set-builder --log=l-heads-sparc.txt \
     1676   --prefix=$HOME/development/rtems/4.11-head \
     1677   --macros=snapshots/binutils-gcc-newlib-gdb-head.mc \
    16471678   4.11/rtems-sparc
    16481679-------------------------------------------------------------
Note: See TracChangeset for help on using the changeset viewer.