Changeset ccc473b in rtems-docs


Ignore:
Timestamp:
Apr 28, 2020, 6:25:51 AM (6 months ago)
Author:
Chris Johns <chrisj@…>
Branches:
5, am, master
Children:
2d22d74
Parents:
8bf866b
git-author:
Chris Johns <chrisj@…> (04/28/20 06:25:51)
git-committer:
Chris Johns <chrisj@…> (04/28/20 06:27:15)
Message:

user/rsb: Update the configuration documentation

Closes #3945

File:
1 edited

Legend:

Unmodified
Added
Removed
  • user/rsb/configuration.rst

    r8bf866b rccc473b  
    132132and it unpacks the source code ready to be built.
    133133
    134 If the source URL references the GitHub API server https://api.github.com/ a
    135 tarball of the specified version is download. For example the URL for the
    136 STLINK project on GitHub and version is:
    137 
    138 .. code-block:: spec
    139 
    140     %define stlink_version 3494c11
    141     %source set stlink https://api.github.com/repos/texane/stlink/texane-stlink-%{stlink_version}.tar.gz
     134If the source URL references the GitHub API server a tarball of the specified
     135version is download. For example the URL for a Newlib snapshot GitHub is:
     136
     137.. code-block:: spec
     138
     139    %define newlib_version 08eab6396f678cf5e5968acaed0bae9fd129983b
     140    %define newlib_external 1
     141    %define newlib_expand_name sourceware-mirror-newlib-cygwin-%{newlib_version}
     142    %source set newlib --rsb-file=newlib-%{newlib_version}.tar.gz \
     143       https://codeload.github.com/RTEMS/sourceware-mirror-newlib-cygwin/tar.gz/%{newlib_version}
    142144
    143145GIT
     
    184186used by the RSB to select a git repository can be removed using *none* or
    185187replaced with one of the standard git protocols.
    186 
    187 CVS
    188 ~~~
    189 
    190 A CVS repository can be checked out. CVS is more complex than GIT to handle
    191 because of the modules support. This can effect the paths the source ends up
    192 in. The CVS URL only supports the CVS protocol. You can control the repository
    193 via the URL by appending options and arguments to the CVS path. The options are
    194 delimited by ``?`` and option arguments are delimited from the options with
    195 ``=``. The options are:
    196 
    197 ``module``:
    198   The module to checkout.
    199 
    200 ``src-prefix``:
    201   The path into the source where the module starts.
    202 
    203 ``tag``:
    204   The CVS tag to checkout.
    205 
    206 ``date``:
    207   The CVS date to checkout.
    208 
    209 The following is an example of checking out from a CVS repository:
    210 
    211 .. code-block:: spec
    212 
    213     %source set newlib cvs://pserver:anoncvs@sourceware.org/cvs/src?module=newlib?src-prefix=src
    214188
    215189Macros and Defaults
     
    634608    Version:   %{dtc_version}
    635609    Release:   %{release}
    636     URL:           http://www.jdl.com/software/
     610    URL:       https://www.devicetree.org/
    637611    BuildRoot: %{_tmppath}/%{name}-root-%(%{__id_u} -n)
    638612
     
    640614single source package and it can be downloaded using the HTTP protocol. The RSB
    641615knows this is GZip'ped tar file. If more than one package is needed, add
    642 them increasing the index. The ``gcc-4.8-1.cfg`` configuration contains
     616them increasing the index. The ``gcc-8-1.cfg`` configuration contains
    643617examples of more than one source package as well as conditionally including
    644618source packages based on the outer configuration options:
     
    649623    # Source
    650624    #
    651     %source set dtc http://www.jdl.com/software/dtc-v%{dtc_version}.tgz
     625    %source set dtc https://www.kernel.org/pub/software/utils/dtc/dtc-%{dtc_version}.tar.gz
    652626
    653627The remainder of the script is broken in to the various phases of a build. They
     
    731705and the prefix is typically supplied via the command to the RSB or the
    732706package's default is used. The default can vary depending on the host's
    733 operating system. To install to a path that is not the prefix the ``DESTDIR``
    734 make variable is used. Most packages should honour the ``DISTDIR`` make
     707operating system. To install to a path that is not the prefix the ``DESTDIR``
     708make variable is used. Most packages should honour the ``DESTDIR`` make
    735709variables and you can typically specify it on the command line to make when
    736710invoking the install target. This results in the package being installed to a
     
    774748    config: devel/dtc-1.2.0
    775749    package: dtc-1.2.0-x86_64-freebsd9.1-1
    776     download: http://www.jdl.com/software/dtc-v1.2.0.tgz -> sources/dtc-v1.2.0.tgz
     750    download: https://www.kernel.org/pub/software/utils/dtc/dtc-v1.2.0.tgz -> sources/dtc-v1.2.0.tgz
    777751    building: dtc-1.2.0-x86_64-freebsd9.1-1
    778752    $ ls tar
Note: See TracChangeset for help on using the changeset viewer.