summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGedare Bloom <gedare@rtems.org>2016-08-01 14:43:29 -0400
committerGedare Bloom <gedare@rtems.org>2016-08-01 14:44:42 -0400
commitcac72a2aea711f671816d7c41bb1cfe66d54ee37 (patch)
tree8a99e350265a4c0eb57efc6f867573ee61d27f36
parentdoc: source-builder.txt: Update installtion for ubuntu packages (diff)
downloadrtems-source-builder-cac72a2aea711f671816d7c41bb1cfe66d54ee37.tar.bz2
doc: add example of a local patch
-rw-r--r--doc/source-builder.txt12
1 files changed, 9 insertions, 3 deletions
diff --git a/doc/source-builder.txt b/doc/source-builder.txt
index 70b5d98..3bcc397 100644
--- a/doc/source-builder.txt
+++ b/doc/source-builder.txt
@@ -826,7 +826,7 @@ Packages being built by the RSB need patches from time to time and the RSB
supports patching upstream packages. The patches are held in a seperate
directory called +patches+ relative to the configuration directory you are
building. For example +%{\_topdir}/patches:%{\_sbdir}/patches+. Patches are
-declared in the configuraiton files in a similar manner to the package's source
+declared in the configuration files in a similar manner to the package's source
so please refer to the +%source+ documentation. Patches, like the source, are
to be made publically available for configurations that live in the RSB package
and are downloaded on demand.
@@ -900,8 +900,14 @@ To test a patch simply copy it to your local +patches+ directory. The RSB will
see the patch is present and will not attempt to download it. Once you are
happy with the patch submit it to the project and a core developer will review
it and add it to the RTEMS Tools git repository.
-
-File Checksums
+For example, to test a local patch for newlib, add the following two lines to
+the .cfg file in +rtems/config/tools/+ that is included by the bset you use:
+-------------------------------------------------------------
+%patch add newlib file://0001-this-is-a-newlib-patch.patch <1>
+%hash md5 0001-this-is-a-newlib-patch.diff 77d070878112783292461bd6e7db17fb <2>
+-------------------------------------------------------------
+<1> The diff file prepended with +file://+ to tell RSB this is a local file.
+<2> The output from md5sum on the diff file.
Cross and Canadian Cross Building
---------------------------------