<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>change log for rtems (2010-12-16)</title>
</head>
<body text='#000000' bgcolor='#ffffff'>
<a name='cs1'></a>
<table border='0' cellspacing='0' cellpadding='5' width='100%' bgcolor='#eeeeee'>
<tr><td colspan='3' bgcolor='#dddddd'>
<font color='#bb2222'><strong>joel</strong></font>
</td></tr>
<tr><td colspan='3' bgcolor='#dddddd'><pre>2010-12-16 Joel Sherrill <joel.sherrilL@OARcorp.com>
* Makefile.am, configure.ac, develenv/direct.t: Remove Getting Started
with GNAT/RTEMS.
* started_ada/.cvsignore, started_ada/Makefile.am,
started_ada/buildada.t, started_ada/gdb.t, started_ada/intro.t,
started_ada/require.t, started_ada/sample.t,
started_ada/started_ada.texi, started_ada/tversions.texi: Removed.
</pre></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/ChangeLog.diff?r1=text&tr1=1.210.2.25&r2=text&tr2=1.210.2.26&diff_format=h">M</a></td><td width='1%'>1.210.2.26</td><td width='100%'>doc/ChangeLog</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/Makefile.am.diff?r1=text&tr1=1.22&r2=text&tr2=1.22.2.1&diff_format=h">M</a></td><td width='1%'>1.22.2.1</td><td width='100%'>doc/Makefile.am</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/configure.ac.diff?r1=text&tr1=1.30&r2=text&tr2=1.30.2.1&diff_format=h">M</a></td><td width='1%'>1.30.2.1</td><td width='100%'>doc/configure.ac</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/develenv/direct.t.diff?r1=text&tr1=1.7&r2=text&tr2=1.7.2.1&diff_format=h">M</a></td><td width='1%'>1.7.2.1</td><td width='100%'>doc/develenv/direct.t</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/.cvsignore?rev=1.7&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.7</font></td><td width='100%'><font color="#880000">doc/started_ada/.cvsignore</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/Makefile.am?rev=1.13&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.13</font></td><td width='100%'><font color="#880000">doc/started_ada/Makefile.am</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/buildada.t?rev=1.23&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.23</font></td><td width='100%'><font color="#880000">doc/started_ada/buildada.t</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/gdb.t?rev=1.7&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.7</font></td><td width='100%'><font color="#880000">doc/started_ada/gdb.t</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/intro.t?rev=1.9&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.9</font></td><td width='100%'><font color="#880000">doc/started_ada/intro.t</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/require.t?rev=1.9&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.9</font></td><td width='100%'><font color="#880000">doc/started_ada/require.t</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/sample.t?rev=1.6&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.6</font></td><td width='100%'><font color="#880000">doc/started_ada/sample.t</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/started_ada.texi?rev=1.11&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.11</font></td><td width='100%'><font color="#880000">doc/started_ada/started_ada.texi</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/tversions.texi?rev=1.7&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.7</font></td><td width='100%'><font color="#880000">doc/started_ada/tversions.texi</font></td></tr>
</table>
<pre>
<font color='#006600'>diff -u rtems/doc/ChangeLog:1.210.2.25 rtems/doc/ChangeLog:1.210.2.26
--- rtems/doc/ChangeLog:1.210.2.25 Thu Nov 11 08:01:42 2010
+++ rtems/doc/ChangeLog Thu Dec 16 14:42:21 2010
</font><font color='#997700'>@@ -1,3 +1,12 @@
</font><font color='#000088'>+2010-12-16 Joel Sherrill <joel.sherrilL@OARcorp.com>
+
+ * Makefile.am, configure.ac, develenv/direct.t: Remove Getting Started
+ with GNAT/RTEMS.
+ * started_ada/.cvsignore, started_ada/Makefile.am,
+ started_ada/buildada.t, started_ada/gdb.t, started_ada/intro.t,
+ started_ada/require.t, started_ada/sample.t,
+ started_ada/started_ada.texi, started_ada/tversions.texi: Removed.
+
</font> 2010-11-11 Joel Sherrill <joel.sherrilL@OARcorp.com>
PR 1716/doc
<font color='#006600'>diff -u rtems/doc/Makefile.am:1.22 rtems/doc/Makefile.am:1.22.2.1
--- rtems/doc/Makefile.am:1.22 Wed Feb 20 16:55:12 2008
+++ rtems/doc/Makefile.am Thu Dec 16 14:42:22 2010
</font><font color='#997700'>@@ -8,7 +8,7 @@
</font> # + tools, common and images are shared across many documents
SUBDIRS = tools started user bsp_howto porting develenv posix_users \
<font color='#880000'>- posix1003.1 filesystem itron3.0 networking ada_user started_ada \
</font><font color='#000088'>+ posix1003.1 filesystem itron3.0 networking ada_user \
</font> new_chapters relnotes cpu_supplement shell
if USE_HTML
<font color='#006600'>diff -u rtems/doc/configure.ac:1.30 rtems/doc/configure.ac:1.30.2.1
--- rtems/doc/configure.ac:1.30 Wed Feb 20 16:55:13 2008
+++ rtems/doc/configure.ac Thu Dec 16 14:42:22 2010
</font><font color='#997700'>@@ -208,7 +208,6 @@
</font> filesystem/Makefile
itron3.0/Makefile
ada_user/Makefile
<font color='#880000'>-started_ada/Makefile
</font> relnotes/Makefile
new_chapters/Makefile
cpu_supplement/Makefile
<font color='#006600'>diff -u rtems/doc/develenv/direct.t:1.7 rtems/doc/develenv/direct.t:1.7.2.1
--- rtems/doc/develenv/direct.t:1.7 Thu Nov 29 10:02:42 2007
+++ rtems/doc/develenv/direct.t Thu Dec 16 14:42:22 2010
</font><font color='#997700'>@@ -1,5 +1,5 @@
</font> @c
<font color='#880000'>-@c COPYRIGHT (c) 1989-2007.
</font><font color='#000088'>+@c COPYRIGHT (c) 1989-2010.
</font> @c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
<font color='#997700'>@@ -690,10 +690,6 @@
</font> This directory contains the source code for the<span style="background-color: #FF0000"> </span>
@cite{Getting Started with RTEMS for C/C++ Users} manual.
<font color='#880000'>-@item $@{RTEMS_ROOT@}/doc/started_ada/
-This directory contains the source code for the<span style="background-color: #FF0000"> </span>
-@cite{Getting Started with RTEMS for Ada Users} manual.
-
</font> @item $@{RTEMS_ROOT@}/doc/tools/
This directory contains the source code for the tools
used on the development host to assist in producing the
</pre>
<p> </p>
<a name='cs2'></a>
<table border='0' cellspacing='0' cellpadding='5' width='100%' bgcolor='#eeeeee'>
<tr><td colspan='3' bgcolor='#dddddd'>
<font color='#bb2222'><strong>joel</strong></font>
</td></tr>
<tr><td colspan='3' bgcolor='#dddddd'><pre>2010-12-16 Joel Sherrill <joel.sherrilL@OARcorp.com>
* develenv/direct.t: Remove Getting Started with GNAT/RTEMS.
* started_ada/.cvsignore, started_ada/Makefile.am,
started_ada/buildada.t, started_ada/gdb.t, started_ada/intro.t,
started_ada/require.t, started_ada/sample.t, started_ada/stamp-vti,
started_ada/started_ada.texi, started_ada/tversions.texi,
started_ada/version.texi: Removed.
</pre></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/ChangeLog.diff?r1=text&tr1=1.292&r2=text&tr2=1.293&diff_format=h">M</a></td><td width='1%'>1.293</td><td width='100%'>doc/ChangeLog</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/develenv/direct.t.diff?r1=text&tr1=1.8&r2=text&tr2=1.9&diff_format=h">M</a></td><td width='1%'>1.9</td><td width='100%'>doc/develenv/direct.t</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/.cvsignore?rev=1.8&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.8</font></td><td width='100%'><font color="#880000">doc/started_ada/.cvsignore</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/Makefile.am?rev=1.14&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.14</font></td><td width='100%'><font color="#880000">doc/started_ada/Makefile.am</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/buildada.t?rev=1.25&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.25</font></td><td width='100%'><font color="#880000">doc/started_ada/buildada.t</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/gdb.t?rev=1.7&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.7</font></td><td width='100%'><font color="#880000">doc/started_ada/gdb.t</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/intro.t?rev=1.9&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.9</font></td><td width='100%'><font color="#880000">doc/started_ada/intro.t</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/require.t?rev=1.9&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.9</font></td><td width='100%'><font color="#880000">doc/started_ada/require.t</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/sample.t?rev=1.6&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.6</font></td><td width='100%'><font color="#880000">doc/started_ada/sample.t</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/stamp-vti?rev=1.10&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.10</font></td><td width='100%'><font color="#880000">doc/started_ada/stamp-vti</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/started_ada.texi?rev=1.11&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.11</font></td><td width='100%'><font color="#880000">doc/started_ada/started_ada.texi</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/tversions.texi?rev=1.7&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.7</font></td><td width='100%'><font color="#880000">doc/started_ada/tversions.texi</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started_ada/version.texi?rev=1.10&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.10</font></td><td width='100%'><font color="#880000">doc/started_ada/version.texi</font></td></tr>
</table>
<pre>
<font color='#006600'>diff -u rtems/doc/ChangeLog:1.292 rtems/doc/ChangeLog:1.293
--- rtems/doc/ChangeLog:1.292 Tue Dec 14 10:51:16 2010
+++ rtems/doc/ChangeLog Thu Dec 16 14:42:52 2010
</font><font color='#997700'>@@ -1,3 +1,12 @@
</font><font color='#000088'>+2010-12-16 Joel Sherrill <joel.sherrilL@OARcorp.com>
+
+ * develenv/direct.t: Remove Getting Started with GNAT/RTEMS.
+ * started_ada/.cvsignore, started_ada/Makefile.am,
+ started_ada/buildada.t, started_ada/gdb.t, started_ada/intro.t,
+ started_ada/require.t, started_ada/sample.t, started_ada/stamp-vti,
+ started_ada/started_ada.texi, started_ada/tversions.texi,
+ started_ada/version.texi: Removed.
+
</font> 2010-12-14 Joel Sherrill <joel.sherrill@oarcorp.com>
* Makefile.am, configure.ac, common/cpright.texi, common/rtems.texi.in,
<font color='#006600'>diff -u rtems/doc/develenv/direct.t:1.8 rtems/doc/develenv/direct.t:1.9
--- rtems/doc/develenv/direct.t:1.8 Thu Jun 17 13:45:34 2010
+++ rtems/doc/develenv/direct.t Thu Dec 16 14:42:52 2010
</font><font color='#997700'>@@ -1,5 +1,5 @@
</font> @c
<font color='#880000'>-@c COPYRIGHT (c) 1989-2007.
</font><font color='#000088'>+@c COPYRIGHT (c) 1989-2010.
</font> @c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
<font color='#997700'>@@ -674,10 +674,6 @@
</font> This directory contains the source code for the<span style="background-color: #FF0000"> </span>
@cite{Getting Started with RTEMS for C/C++ Users} manual.
<font color='#880000'>-@item $@{RTEMS_ROOT@}/doc/started_ada/
-This directory contains the source code for the<span style="background-color: #FF0000"> </span>
-@cite{Getting Started with RTEMS for Ada Users} manual.
-
</font> @item $@{RTEMS_ROOT@}/doc/tools/
This directory contains the source code for the tools
used on the development host to assist in producing the
</pre>
<p> </p>
<a name='cs3'></a>
<table border='0' cellspacing='0' cellpadding='5' width='100%' bgcolor='#eeeeee'>
<tr><td colspan='3' bgcolor='#dddddd'>
<font color='#bb2222'><strong>joel</strong></font>
</td></tr>
<tr><td colspan='3' bgcolor='#dddddd'><pre>2010-12-16 Joel Sherrill <joel.sherrilL@OARcorp.com>
* Makefile.am, configure.ac, common/cpright.texi, common/rtems.texi.in,
cpu_supplement/.cvsignore, started/Makefile.am, started/binaries.t,
started/buildc.t, started/buildrt.t, started/intro.t,
started/nextstep.t, started/nt.t, started/require.t,
started/sample.t, started/started.texi: Major update which includes
removal of references to specific tool versions and patches.
* started/tversions.texi.in: Removed.
</pre></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/ChangeLog.diff?r1=text&tr1=1.210.2.26&r2=text&tr2=1.210.2.27&diff_format=h">M</a></td><td width='1%'>1.210.2.27</td><td width='100%'>doc/ChangeLog</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/Makefile.am.diff?r1=text&tr1=1.22.2.1&r2=text&tr2=1.22.2.2&diff_format=h">M</a></td><td width='1%'>1.22.2.2</td><td width='100%'>doc/Makefile.am</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/common/cpright.texi.diff?r1=text&tr1=1.13&r2=text&tr2=1.13.2.1&diff_format=h">M</a></td><td width='1%'>1.13.2.1</td><td width='100%'>doc/common/cpright.texi</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/common/rtems.texi.in.diff?r1=text&tr1=1.6&r2=text&tr2=1.6.4.1&diff_format=h">M</a></td><td width='1%'>1.6.4.1</td><td width='100%'>doc/common/rtems.texi.in</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/configure.ac.diff?r1=text&tr1=1.30.2.1&r2=text&tr2=1.30.2.2&diff_format=h">M</a></td><td width='1%'>1.30.2.2</td><td width='100%'>doc/configure.ac</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/cpu_supplement/.cvsignore.diff?r1=text&tr1=1.3.2.1&r2=text&tr2=1.3.2.2&diff_format=h">M</a></td><td width='1%'>1.3.2.2</td><td width='100%'>doc/cpu_supplement/.cvsignore</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started/Makefile.am.diff?r1=text&tr1=1.18&r2=text&tr2=1.18.6.1&diff_format=h">M</a></td><td width='1%'>1.18.6.1</td><td width='100%'>doc/started/Makefile.am</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started/binaries.t.diff?r1=text&tr1=1.14&r2=text&tr2=1.14.4.1&diff_format=h">M</a></td><td width='1%'>1.14.4.1</td><td width='100%'>doc/started/binaries.t</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started/buildc.t.diff?r1=text&tr1=1.47.2.1&r2=text&tr2=1.47.2.2&diff_format=h">M</a></td><td width='1%'>1.47.2.2</td><td width='100%'>doc/started/buildc.t</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started/buildrt.t.diff?r1=text&tr1=1.21&r2=text&tr2=1.21.6.1&diff_format=h">M</a></td><td width='1%'>1.21.6.1</td><td width='100%'>doc/started/buildrt.t</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started/intro.t.diff?r1=text&tr1=1.15&r2=text&tr2=1.15.6.1&diff_format=h">M</a></td><td width='1%'>1.15.6.1</td><td width='100%'>doc/started/intro.t</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started/nextstep.t.diff?r1=text&tr1=1.7&r2=text&tr2=1.7.6.1&diff_format=h">M</a></td><td width='1%'>1.7.6.1</td><td width='100%'>doc/started/nextstep.t</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started/nt.t.diff?r1=text&tr1=1.20&r2=text&tr2=1.20.6.1&diff_format=h">M</a></td><td width='1%'>1.20.6.1</td><td width='100%'>doc/started/nt.t</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started/require.t.diff?r1=text&tr1=1.13&r2=text&tr2=1.13.6.1&diff_format=h">M</a></td><td width='1%'>1.13.6.1</td><td width='100%'>doc/started/require.t</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started/sample.t.diff?r1=text&tr1=1.15&r2=text&tr2=1.15.6.1&diff_format=h">M</a></td><td width='1%'>1.15.6.1</td><td width='100%'>doc/started/sample.t</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started/started.texi.diff?r1=text&tr1=1.20&r2=text&tr2=1.20.4.1&diff_format=h">M</a></td><td width='1%'>1.20.4.1</td><td width='100%'>doc/started/started.texi</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/started/tversions.texi.in?rev=1.4&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.4</font></td><td width='100%'><font color="#880000">doc/started/tversions.texi.in</font></td></tr>
</table>
<pre>
<font color='#006600'>diff -u rtems/doc/ChangeLog:1.210.2.26 rtems/doc/ChangeLog:1.210.2.27
--- rtems/doc/ChangeLog:1.210.2.26 Thu Dec 16 14:42:21 2010
+++ rtems/doc/ChangeLog Thu Dec 16 14:54:32 2010
</font><font color='#997700'>@@ -1,5 +1,15 @@
</font> 2010-12-16 Joel Sherrill <joel.sherrilL@OARcorp.com>
<font color='#000088'>+ * Makefile.am, configure.ac, common/cpright.texi, common/rtems.texi.in,
+ cpu_supplement/.cvsignore, started/Makefile.am, started/binaries.t,
+ started/buildc.t, started/buildrt.t, started/intro.t,
+ started/nextstep.t, started/nt.t, started/require.t,
+ started/sample.t, started/started.texi: Major update which includes
+ removal of references to specific tool versions and patches.
+ * started/tversions.texi.in: Removed.
+
+2010-12-16 Joel Sherrill <joel.sherrilL@OARcorp.com>
+
</font> * Makefile.am, configure.ac, develenv/direct.t: Remove Getting Started
with GNAT/RTEMS.
* started_ada/.cvsignore, started_ada/Makefile.am,
<font color='#006600'>diff -u rtems/doc/Makefile.am:1.22.2.1 rtems/doc/Makefile.am:1.22.2.2
--- rtems/doc/Makefile.am:1.22.2.1 Thu Dec 16 14:42:22 2010
+++ rtems/doc/Makefile.am Thu Dec 16 14:54:33 2010
</font><font color='#997700'>@@ -8,7 +8,7 @@
</font> # + tools, common and images are shared across many documents
SUBDIRS = tools started user bsp_howto porting develenv posix_users \
<font color='#880000'>- posix1003.1 filesystem itron3.0 networking ada_user \
</font><font color='#000088'>+ posix1003.1 filesystem networking ada_user \
</font> new_chapters relnotes cpu_supplement shell
if USE_HTML
<font color='#997700'>@@ -20,7 +20,9 @@
</font> EXTRA_DIST += common/cpright.texi common/setup.texi \
common/treedef.tex common/rtems.texi.in
<font color='#000088'>+if USE_HTML
</font> html_imagesdir = $(htmldir)/images
<font color='#000088'>+endif
</font>
HTML_IMAGES = images/dir-arrow.gif images/dvi.gif images/missing-arrow.gif \
images/next-arrow.gif images/oaronly.jpg images/pdf.gif images/pdf1.gif \
<font color='#006600'>diff -u rtems/doc/common/cpright.texi:1.13 rtems/doc/common/cpright.texi:1.13.2.1
--- rtems/doc/common/cpright.texi:1.13 Fri Jan 25 10:41:07 2008
+++ rtems/doc/common/cpright.texi Thu Dec 16 14:54:33 2010
</font><font color='#997700'>@@ -1,5 +1,5 @@
</font> @c
<font color='#880000'>-@c COPYRIGHT (c) 1988-2008.
</font><font color='#000088'>+@c COPYRIGHT (c) 1988-2010.
</font> @c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
<font color='#997700'>@@ -17,7 +17,7 @@
</font> @end tex
@vskip 0pt plus 1filll
<font color='#880000'>-COPYRIGHT @copyright{} 1988 - 2008.@*
</font><font color='#000088'>+COPYRIGHT @copyright{} 1988 - 2010.@*
</font> On-Line Applications Research Corporation (OAR).@*
The authors have used their best efforts in preparing
<font color='#997700'>@@ -36,5 +36,5 @@
</font> components, its documentation, or any custom services
for RTEMS should be directed to the contacts listed on
that site. A current list of RTEMS Support Providers
<font color='#880000'>-is at @uref{http://www.rtems.com/support.html}.
</font><font color='#000088'>+is at @uref{http://www.rtems.com/oarsupport}.
</font>
<font color='#006600'>diff -u rtems/doc/common/rtems.texi.in:1.6 rtems/doc/common/rtems.texi.in:1.6.4.1
--- rtems/doc/common/rtems.texi.in:1.6 Mon Jan 15 03:14:41 2007
+++ rtems/doc/common/rtems.texi.in Thu Dec 16 14:54:33 2010
</font><font color='#997700'>@@ -11,4 +11,3 @@
</font> @set RTEMSPREFIX @RTEMSPREFIX@
@set RTEMSAPI @RTEMSAPI@
@set RTEMSRPMPREFIX @RTEMSRPMPREFIX@
<font color='#880000'>-@set RTEMSRPMGROUP @RTEMSRPMGROUP@
</font>
<font color='#006600'>diff -u rtems/doc/configure.ac:1.30.2.1 rtems/doc/configure.ac:1.30.2.2
--- rtems/doc/configure.ac:1.30.2.1 Thu Dec 16 14:42:22 2010
+++ rtems/doc/configure.ac Thu Dec 16 14:54:33 2010
</font><font color='#997700'>@@ -137,30 +137,6 @@
</font>
dnl Checks for library functions.
<font color='#880000'>-AC_MSG_CHECKING([for ./setup.def])
-AS_IF([test -f ${srcdir}/setup.def],[
-. ${srcdir}/setup.def
-AC_MSG_RESULT([done])
-],[
-AC_MSG_ERROR([missing])
-])
-
-AS_IF([test -z "$binutils_patch_version"],
-[set_binutils_patch="@clear BINUTILSPATCHVERSION"],
-[set_binutils_patch="@set BINUTILSPATCHVERSION $binutils_patch_version"])
-
-AS_IF([test -z "$newlib_patch_version"],
-[set_newlib_patch="@clear NEWLIBPATCHVERSION"],
-[set_newlib_patch="@set NEWLIBPATCHVERSION $newlib_patch_version"])
-
-AS_IF([test -z "$gcc_patch_version"],
-[set_gcc_patch="@clear GCCPATCHVERSION"],
-[set_gcc_patch="@set GCCPATCHVERSION $gcc_patch_version"])
-
-AS_IF([test -z "$gdb_patch_version"],
-[set_gdb_patch="@clear GDBPATCHVERSION"],
-[set_gdb_patch="@set GDBPATCHVERSION $gdb_patch_version"])
-
</font> AC_CONFIG_SUBDIRS(tools)
AC_CONFIG_FILES([Makefile],[],[
<font color='#997700'>@@ -170,7 +146,6 @@
</font> s/@RTEMSAPI@/RTEMS_API/;t t
s,@RTEMSPREFIX@,$prefix,;t t
s,@RTEMSRPMPREFIX@,$rpmprefix,;t t
<font color='#880000'>-s,@RTEMSRPMGROUP@,RTEMS/]RTEMS_API[,;t t
</font> EOF
_RTEMS_UPDATE_CONDITIONAL([common/rtems.sed],[common/rtems.sed~])
])
<font color='#997700'>@@ -181,33 +156,14 @@
</font> user/Makefile
bsp_howto/Makefile])
<font color='#880000'>-AC_CONFIG_FILES([started/Makefile],[],[
-test -d started || mkdir started
-cat << EOF > started/tversions.sed~
-:t
-s/@GCCVERSION@/$gcc_version/;t t
-s/@BINUTILSVERSION@/$binutils_version/;t t
-s/@NEWLIBVERSION@/$newlib_version/;t t
-s/@GDBVERSION@/$gdb_version/;t t
-s/@SETBINUTILSPATCHVERSION@/$set_binutils_patch/;t t
-s/@SETGCCPATCHVERSION@/$set_gcc_patch/;t t
-s/@SETNEWLIBPATCHVERSION@/$set_newlib_patch/;t t
-s/@SETGDBPATCHVERSION@/$set_gdb_patch/;t t
-s/@GCCRPMRELEASE@/$gccnewlib_rpm_release/;t t
-s/@BINUTILSRPMRELEASE@/$binutils_rpm_release/;t t
-s/@GDBRPMRELEASE@/$gdb_rpm_release/;t t
-EOF
-_RTEMS_UPDATE_CONDITIONAL([started/tversions.sed],[started/tversions.sed~])
-])
-
</font> AC_CONFIG_FILES([
porting/Makefile
networking/Makefile
posix_users/Makefile
posix1003.1/Makefile
filesystem/Makefile
<font color='#880000'>-itron3.0/Makefile
</font> ada_user/Makefile
<font color='#000088'>+started/Makefile
</font> relnotes/Makefile
new_chapters/Makefile
cpu_supplement/Makefile
<font color='#006600'>diff -u rtems/doc/cpu_supplement/.cvsignore:1.3.2.1 rtems/doc/cpu_supplement/.cvsignore:1.3.2.2
--- rtems/doc/cpu_supplement/.cvsignore:1.3.2.1 Wed Sep 10 10:58:58 2008
+++ rtems/doc/cpu_supplement/.cvsignore Thu Dec 16 14:54:33 2010
</font><font color='#997700'>@@ -1,4 +1,5 @@
</font> arm.texi
<font color='#000088'>+avr.texi
</font> bfin.texi
cpu_supplement
cpu_supplement-?
<font color='#997700'>@@ -24,6 +25,7 @@
</font> general.texi
i386.texi
index.html
<font color='#000088'>+lm32.texi
</font> m68k.texi
Makefile
Makefile.in
<font color='#997700'>@@ -35,6 +37,8 @@
</font> rtemspie.pdf
sh.texi
sparc.texi
<font color='#000088'>+sparc64.texi
</font> stamp-vti
states.pdf
<font color='#000088'>+tic4x.texi
</font> version.texi
<font color='#006600'>diff -u rtems/doc/started/Makefile.am:1.18 rtems/doc/started/Makefile.am:1.18.6.1
--- rtems/doc/started/Makefile.am:1.18 Sat Jan 17 09:50:39 2004
+++ rtems/doc/started/Makefile.am Thu Dec 16 14:54:33 2010
</font><font color='#997700'>@@ -1,5 +1,5 @@
</font> #
<font color='#880000'>-# COPYRIGHT (c) 1988-2002.
</font><font color='#000088'>+# COPYRIGHT (c) 1988-2010.
</font> # On-Line Applications Research Corporation (OAR).
# All rights reserved.
#
<font color='#997700'>@@ -7,7 +7,6 @@
</font> #
PROJECT = started
<font color='#880000'>-EDITION = 1
</font>
include $(top_srcdir)/project.am
include $(top_srcdir)/main.am
<font color='#997700'>@@ -22,42 +21,43 @@
</font> info_TEXINFOS = started.texi
started_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES)
<font color='#880000'>-intro.texi: intro.t tversions.texi
</font><font color='#000088'>+intro.texi: intro.t
</font> $(BMENU2) -c -p "Top" \
-u "Top" \
-n "Requirements" < $< > $@
<font color='#880000'>-require.texi: require.t tversions.texi
</font><font color='#000088'>+require.texi: require.t
</font> $(BMENU2) -c -p "GCC Mailing Lists" \
-u "Top" \
-n "Prebuilt Toolset Executables" < $< > $@
<font color='#880000'>-binaries.texi: binaries.t tversions.texi
- $(BMENU2) -c -p "Archive and Build Directory Format" \
</font><font color='#000088'>+binaries.texi: binaries.t
+ $(BMENU2) -c \
+ -p "GNU/Linux Distrobutions using Debian Packaging Format" \
</font> -u "Top" \
-n "Building the GNU Cross Compiler Toolset" < $< > $@
<font color='#880000'>-buildc.texi: buildc.t tversions.texi
</font><font color='#000088'>+buildc.texi: buildc.t
</font> $(BMENU2) -c -p "Removing Zipped Tar Files" \
-u "Top" \
-n "Building RTEMS" < $< > $@
<font color='#880000'>-buildrt.texi: buildrt.t tversions.texi
</font><font color='#000088'>+buildrt.texi: buildrt.t
</font> $(BMENU2) -c -p "Error Messages Indicating Configuration Problems" \
-u "Top" \
-n "Building the Sample Applications" < $< > $@
<font color='#880000'>-sample.texi: sample.t tversions.texi
</font><font color='#000088'>+sample.texi: sample.t
</font> $(BMENU2) -c -p "Using the RTEMS configure Script Directly" \
-u "Top" \
-n "Where To Go From Here" < $< > $@
<font color='#880000'>-nextstep.texi: nextstep.t tversions.texi
</font><font color='#000088'>+nextstep.texi: nextstep.t
</font> $(BMENU2) -c -p "More Information on RTEMS Application Makefiles" \
-u "Top" \
-n "Using MS-Windows as a Development Host" < $< > $@
<font color='#880000'>-nt.texi: nt.t tversions.texi
</font><font color='#000088'>+nt.texi: nt.t
</font> $(BMENU2) -c -p "Writing an Application" \
-u "Top" \
-n "" < $< > $@
<font color='#997700'>@@ -83,11 +83,4 @@
</font>
EXTRA_DIST += $(PICTURES)
<font color='#880000'>-tversions.texi: tversions.texi.in tversions.sed
- sed -f tversions.sed $(srcdir)/tversions.texi.in > tversions.texi
-CLEANFILES += tversions.texi
-
-EXTRA_DIST += tversions.texi.in
-DISTCLEANFILES = tversions.sed
-
</font> CLEANFILES += started.info started.info-?
<font color='#006600'>diff -u rtems/doc/started/binaries.t:1.14 rtems/doc/started/binaries.t:1.14.4.1
--- rtems/doc/started/binaries.t:1.14 Mon Jan 15 02:24:37 2007
+++ rtems/doc/started/binaries.t Thu Dec 16 14:54:33 2010
</font><font color='#997700'>@@ -1,5 +1,5 @@
</font> @c
<font color='#880000'>-@c COPYRIGHT (c) 1988-2002.
</font><font color='#000088'>+@c COPYRIGHT (c) 1988-2010.
</font> @c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
<font color='#997700'>@@ -8,18 +8,22 @@
</font>
@chapter Prebuilt Toolset Executables
<font color='#880000'>-Precompiled toolsets are available for Linux, Cygwin, FreeBSD,
-and Solaris. These are packaged in the following formats:
</font><font color='#000088'>+Precompiled toolsets are available for GNU/Linux and MS-Windows.<span style="background-color: #FF0000"> </span>
+Other hosts will need to build from source. Packaged binaries are
+in the following formats:
</font>
@itemize @bullet
<font color='#880000'>-@item Linux - RPM
</font><font color='#000088'>+@item GNU/Linux - RPM
</font> @item Cygwin - tar.bz2
<font color='#880000'>-@item Solaris - tar.bz2
</font><font color='#000088'>+@item Mingw - tar.bz2
</font> @end itemize
<font color='#880000'>-RPM is an acronym for the RPM Package Manager. RPM is the
-native package installer for many Linux distributions including
-RedHat, SuSE, and Fedora.
</font><font color='#000088'>+RPM is an acronym for the RPM Package Manager. RPM is the native package
+installer for many GNU/Linux distributions including RedHat Enterprise
+Linux, Centos, SuSE, and Fedora.
+
+The RTEMS Project maintains a Yum Repository which makes it quite simple
+to install and update RTEMS toolsets.
</font>
The prebuilt binaries are intended to be easy to install and
the instructions are similar regardless of the host environment.<span style="background-color: #FF0000"> </span>
<font color='#997700'>@@ -27,18 +31,27 @@
</font> Cross Toolset binaries that you need to be aware of.
@enumerate
<font color='#880000'>-@item There are dependencies between the various packages.
-This requires that certain packages be installed before others may be.
-Some packaging formats enforce this dependency.
</font><font color='#000088'>+@item There are dependencies between the various packages. This requires
+that certain packages be installed before others may be. Some packaging
+formats enforce this dependency.
</font>
@item Some packages are target CPU family independent and shared
across all target architectures. These are referred to as<span style="background-color: #FF0000"> </span>
"base" packages.
<font color='#880000'>-@item Depending upon the version of GCC as well as the development
-host and target CPU combination, pre-built supplemental packages may<span style="background-color: #FF0000"> </span>
-be provided for Ada (gnat), Chill, Java (gcj), Fortran (g77), and
-Objective-C (objc). These binaries are strictly optional.
</font><font color='#000088'>+@item Pre-built GNU Binary Utilities (binutils) packages are available
+for all RTEMS targets. These include tools such as the assembler and
+linker and must be installed.
+
+@item Pre-built C language packages are available which include a C
+compiler as well as the Standard C libraries for the embedded RTEMS
+targets. These must be installed.
+
+@item Pre-built C++ language packages are available for most target
+architectures which includes a C++ compiler as well as the Standard C++
+libraries for the embedded RTEMS targets. These are not part of the
+minimum installation and need only be installed if the application is
+using C++.
</font>
@end enumerate
<font color='#997700'>@@ -50,63 +63,237 @@
</font>
This section provides information on installing and removing RPMs.
<font color='#880000'>-@subsection Installing RPMs
</font><font color='#000088'>+Note that RTEMS tools for multiple major versions of RTEMS can be
+installed in parallel since they are installed into different host
+directories. The tools also include the RTEMS Release Series in their
+name.
+
+@subsection Locating the RPMs for your GNU/Linux Distribution
+
+The RTEMS Project maintains a Yum Repository of RPMs for its
+toolsets. Whether you use Yum to install the RPMs or download and install
+them via another procedure, you will need to locate the appropriate
+set of RPMs on the RTEMS Yum Repository. The following instructions
+are generalized.
</font>
<font color='#880000'>-The following is a sample session illustrating the installation
-of a C/C++ toolset targeting the SPARC architecture.<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+If your host operating system uses Yum and RPMs, then you will only have
+to download and install two RPMs by hand
+
+@enumerate
+@item Point your browser at
+@uref{http://www.rtems.org/ftp/pub/rtems/linux,
+http://www.rtems.org/ftp/pub/rtems/linux}. In this directory, you
+will see a list of RTEMS major versions such as 4.11, 4.10, 4.9, etc..
+Descend into the appropriate directory for the version of RTEMS you
+are using.
+
+@item Now that you are in the directory for a specific RTEMS major
+version, you will be presented with a list of GNU/Linux distributions.
+This will include options like redhat, centos, fedora, and suse.
+Select the appropriate distribution.
+
+@item Now that you are in the directory for your selected distribution,
+you will be presented with a list of distribution versions for which
+RTEMS pre-built RPMs are available. Select the appropriate distribution
+version.
+
+@item Now that you are in the directory for the proper version of
+your selected distribution, you will be presented with a choice of
+host architecture versions such as i386, i686, and x86_64. Select the
+appropriate version for your development computer.
+
+@item At this point, you will have a long list of RPMs to select from.
+@end enumerate
+
+The RTEMS Projects supports a wide variety of host OS and target
+combinations. In addition, these toolsets are specific to a particular
+RTEMS Release Series. Given the large number of possible combinations,
+the instructions use variables to indicate where versions go in the real
+package names you will use. These variable are used in the examples of
+RPM version names:
+
+@itemize @bullet
+@item @code{<VERSION>} is the tool version will be found at this location
+in the RPM name. This will be a release number such as @code{2.20}
+or @code{4.4.5}.
+
+@item @code{<DIST>} indicates the GNU/Linux distribution version.
+This will be a string such as @code{fc14} or @code{el6}.
+
+@item @code{<ARCH>} indicates the architecture used for RPMs on your
+GNU/Linux installation. This will be a string such as @code{i386}
+or @code{x86_64}.
+
+@item @code{<RPM>} indicates the RPM revision level. This will be a
+single integer.
+@end itemize
+
+The tool VERSION and RPM release may vary within the set of current RPMs for a particular RTEMS Release series based upon the target architecture.<span style="background-color: #FF0000"> </span>
+
+If you are using Yum, please continue to the next section. If you are
+downloading the RPMs to install by hand, then go to the @ref{Installing
+RPMs Without Yum} section.
+
+@subsection Managing RPMs Using Yum
+
+This section describes how to install and remove RTEMS Toolsets using Yum.
+
+@subsubsection Installing RPMs Using Yum
+
+If you are on a host operating system that uses Yum, you are fortunate because this is the one of the simplest ways to install the tools. After locating the appropriate directory on the RTEMS Yum Repository using the instructions in @ref{Locating the RPMs for your GNU/Linux Distribution}, you will need to install the following RPMs:
+
+@itemize @bullet
+@item @value{RTEMSRPMPREFIX}-release-<VERSION>-<RPM>.<DIST>.noarch.rpm
+@item @value{RTEMSRPMPREFIX}-yum-conf-<VERSION>-<RPM>.<DIST>.noarch.rpm
+@end itemize
+
+You can use the search within page feature of your browser to locate
+the RPMs with "release" or "yum" in their names.
+
+You will need to download the RPMs above or RPM can be given the URLs for
+them and it will fetch them for you. Either way, the commands similar
+to the following will install the common or base RPMs required.
</font>
@example
<font color='#880000'>-rpm -U @value{RTEMSRPMPREFIX}binutils-common-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.i386.rpm
-rpm -U @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-binutils-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.i386.rpm
-rpm -U @value{RTEMSRPMPREFIX}gcc-common-@value{GCCVERSION}-@value{GCCRPMRELEASE}.i386.rpm
-rpm -U @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-newlib-@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.i386.rpm
-rpm -U @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gcc-@value{GCCVERSION}-@value{GCCRPMRELEASE}.i386.rpm
-rpm -U @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gcc-c++-@value{GCCVERSION}-@value{GCCRPMRELEASE}.i386.rpm
-rpm -U @value{RTEMSRPMPREFIX}gdb-common-@value{GDBVERSION}-@value{GDBRPMRELEASE}.i386.rpm
-rpm -U @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gdb-@value{GDBVERSION}-@value{GDBRPMRELEASE}.i386.rpm
</font><font color='#000088'>+rpm -U @value{RTEMSRPMPREFIX}-release-<VERSION>-<RPM>.<DIST>.noarch.rpm \
+ @value{RTEMSRPMPREFIX}-yum-conf-<VERSION>-<RPM>.<DIST>.noarch.rpm
</font> @end example
<font color='#880000'>-Upon successful completion of the above command sequence, a<span style="background-color: #FF0000"> </span>
-C/C++ cross development toolset targeting the SPARC is
-installed in @code{@value{RTEMSPREFIX}}. In order to use this toolset,
-the directory @code{@value{RTEMSPREFIX}/bin} must be included in your
-PATH.
</font><font color='#000088'>+Once these are installed, Yum knows about the RTEMS Yum repository
+for @value{RTEMSPREFIX}. This means that you can install and upgrade
+RTEMS Toolsets just like the packages provided by your distribution.
+To install complete C and C++ toolset targeting the SPARC architecture
+for the RTEMS @value{RTEMSAPI} Release series, commands similar to the
+following will be used.
</font>
<font color='#880000'>-Once you have successfully installed the RPMs for BINUTILS, GCC,
-NEWLIB, and GDB, then you may proceed directly to @ref{Building RTEMS}.<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+@example
+yum install @value{RTEMSPREFIX}-auto*
+yum install @value{RTEMSPREFIX}-sparc-*
+@end example
</font>
<font color='#880000'>-@subsection Determining Which RTEMS RPMs are Installed
</font><font color='#000088'>+The first command installs GNU autoconf and automake which are used
+by all RTEMS targets. The second command installs the complete
+sparc-@value{RTEMSPREFIX} toolset including all dependencies.
</font>
<font color='#880000'>-The following command will report which RTEMS RPMs are currently
-installed:
</font><font color='#000088'>+@subsubsection Removing RPMs Using Yum
+
+The following is a sample session illustrating the removal of a C/C++
+toolset targeting the SPARC architecture.
+
+@example
+yum erase @value{RTEMSRPMPREFIX}-sparc-*
+@end example
+
+If this is the last target architecture for which tools are installed, then you can remove the RTEMS GNU autotools and common packages as follows:
</font>
@example
<font color='#880000'>-rpm -q -g @value{RTEMSRPMGROUP}
</font><font color='#000088'>+yum erase @value{RTEMSRPMPREFIX}-auto*
+yum erase @value{RTEMSRPMPREFIX}-*common*
</font> @end example
<font color='#880000'>-@subsection Removing RPMs
</font><font color='#000088'>+NOTE: If you have installed any RTEMS BSPs, then it is likely that RPM
+will complain about not being able to remove everything. These will
+have to be removed by hand.
</font>
<font color='#880000'>-The following is a sample session illustrating the removal
-of a C/C++ toolset targeting the SPARC architecture.
</font><font color='#000088'>+@subsection Managing RPMs Without Using Yum
+
+This section describes how to install and remove RTEMS Toolsets without
+using Yum. This is NOT expected to be the norm for RPM users.
+
+@subsubsection Installing RPMs Without Yum
+
+The following is a sample session illustrating the installation of the
+complete C and C++ toolset targeting the SPARC architecture for the
+RTEMS @value{RTEMSAPI} Release series.
+
+Since you are not using Yum, you will need to download all of the RPMs
+you will install. Alternatively, RPM can be given a URL for an RPM file
+and it will fetch it for you. Either way, the commands similar to the
+following will install the common or base RPMs required.
+
+@example
+rpm -U @value{RTEMSRPMPREFIX}binutils-common-<VERSION>-<RPM>.<DIST>.noarch.rpm \
+ @value{RTEMSRPMPREFIX}gcc-common-<VERSION>-<RPM>.<DIST>.noarch.rpm \
+ @value{RTEMSRPMPREFIX}newlib-common-<VERSION>-<RPM>.<DIST>.noarch.rpm \
+ @value{RTEMSRPMPREFIX}gdb-common-<VERSION>-<RPM>.<DIST>.noarch.rpm
+@end example
+
+The above RPMs are shared across all RTEMS targets and include common
+files such as the documentation. The following illustrates how to install
+the GNU Autoconf and Automake RPMs that match your RTEMS installation.
+RTEMS uses the GNU Autotools for its configure and build infrastructure
+and you will need these if you modify the build infrastructure or check
+out RTEMS from CVS and have to bootstrap the source tree.
+
+@example
+rpm -U @value{RTEMSRPMPREFIX}autoconf-<VERSION>-<RPM>.<DIST>.noarch.rpm \
+ @value{RTEMSRPMPREFIX}automake-<VERSION>-<RPM>.<DIST>.noarch.rpm
+@end example
+
+Now that you have installed all of the RPMs that are independent of the
+target architecture you can install the C toolset for a specific target.
+The following command will install the target architecture specific set
+of the RPMs for a C toolset including GDB.
</font>
@example
<font color='#880000'>-rpm -e @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gdb
-rpm -e @value{RTEMSRPMPREFIX}gdb-common
-rpm -e @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gcc-c++
-rpm -e @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gcc
-rpm -e @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-newlib
-rpm -e @value{RTEMSRPMPREFIX}gcc-common
-rpm -e @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-binutils
-rpm -e @value{RTEMSRPMPREFIX}binutils-common
</font><font color='#000088'>+rpm -U @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-binutils-<VERSION>-<RPM>.<ARCH>.rpm \
+ @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gcc-<VERSION>-<RPM>.<ARCH>.rpm \
+ @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-newlib-<VERSION>-<RPM>.<ARCH>.rpm \
+ @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-libgcc-<VERSION>-<RPM>.<ARCH>.rpm \
+ @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gdb-<VERSION>-<RPM>.<ARCH>.rpm
</font> @end example
<font color='#880000'>-NOTE: If you have installed any RTEMS BSPs, then it is likely that
-RPM will complain about not being able to remove everything.
</font><font color='#000088'>+The following command illustrates how to install the C++ specific portion of the RPMs.
+
+@example
+rpm -U @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gcc-c++-<VERSION>-<RPM>.<ARCH>.rpm \
+ @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-libstd++-<VERSION>-<RPM>.<ARCH>.rpm
+@end example
+
+Upon successful completion of the above command sequence, a C/C++
+cross development toolset targeting the SPARC is installed in
+@code{@value{RTEMSPREFIX}}. In order to use this toolset, the directory
+@code{@value{RTEMSPREFIX}/bin} should be at the start of your PATH.
+At this point, the tools are installed for a specific target architecture
+adn you may proceed directly to @ref{Building RTEMS}.
+
+If you want to build RTEMS for multiple target architectures, you will
+need to install the target specific portion of the RPMs for each target.
+
+@subsubsection Removing RPMs Without Using Yum
+
+The following is a sample session illustrating the removal of a C/C++
+toolset targeting the SPARC architecture.
+
+@example
+rpm -e `rpm -qa | grep @value{RTEMSRPMPREFIX}-sparc-`
+@end example
+
+If this is the last target architecture for which tools are installed, then you can remove the RTEMS GNU autotools and common packages as follows:
+
+@example
+rpm -e `rpm -qa | grep @value{RTEMSRPMPREFIX}-auto`
+rpm -e `rpm -qa | grep @value{RTEMSRPMPREFIX} | grep common`
+@end example
+
+NOTE: If you have installed any RTEMS BSPs, then it is likely that RPM
+will complain about not being able to remove everything. These will
+have to be removed by hand.
+
+@subsection Determining Which RTEMS RPMs are Installed
+
+The following command will report which RTEMS RPMs are currently
+installed:
+
+@example
+rpm -qa | grep @value{RTEMSAPI}
+@end example
</font>
@section Zipped Tar Files
<font color='#880000'>-This section provides information on installing and removing
-Zipped Tar Files (e.g .tar.gz or .tar.bz2).
</font><font color='#000088'>+The tool binaries for some hosts are provided as compressed tar files.
+This section provides information on installing and removing Zipped Tar
+Files (e.g .tar.gz or .tar.bz2).
</font>
@subsection Installing Zipped Tar Files
<font color='#997700'>@@ -117,13 +304,13 @@
</font>
@example
cd /
<font color='#880000'>-tar xzf @value{RTEMSRPMPREFIX}binutils-common-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.tar.gz
-tar xzf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-binutils-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.tar.gz
-tar xzf @value{RTEMSRPMPREFIX}gcc-common-@value{GCCVERSION}-@value{GCCRPMRELEASE}.tar.gz
-tar xzf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gcc-@value{GCCVERSION}-@value{GCCRPMRELEASE}.tar.gz
-tar xzf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-newlib-@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.tar.gz
-tar xzf @value{RTEMSRPMPREFIX}gdb-common-@value{GDBVERSION}-@value{GDBRPMRELEASE}.tar.gz
-tar xzf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gdb-@value{GDBVERSION}-@value{GDBRPMRELEASE}.tar.gz
</font><font color='#000088'>+tar xzf @value{RTEMSRPMPREFIX}binutils-common-<VERSION>-<RPM>.tar.gz
+tar xzf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-binutils-<VERSION>-<RPM>.tar.gz
+tar xzf @value{RTEMSRPMPREFIX}gcc-common-<VERSION>-<RPM>.tar.gz
+tar xzf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gcc-<VERSION>-<RPM>.tar.gz
+tar xzf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-newlib-<VERSION>-<RPM>.tar.gz
+tar xzf @value{RTEMSRPMPREFIX}gdb-common-<VERSION>-<RPM>.tar.gz
+tar xzf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gdb-<VERSION>-<RPM>.tar.gz
</font> @end example
The following command set is the equivalent command sequence
<font color='#997700'>@@ -132,13 +319,13 @@
</font>
@example
cd /
<font color='#880000'>-tar xjf @value{RTEMSRPMPREFIX}binutils-common-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.tar.bz2
-tar xjf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-binutils-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.tar.bz2
-tar xjf @value{RTEMSRPMPREFIX}gcc-common-@value{GCCVERSION}-@value{GCCRPMRELEASE}.tar.bz2
-tar xjf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-newlib-@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.tar.bz2
-tar xjf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gcc-@value{GCCVERSION}-@value{GCCRPMRELEASE}.tar.bz2
-tar xjf @value{RTEMSRPMPREFIX}gdb-common-@value{GDBVERSION}-@value{GDBRPMRELEASE}.tar.bz2
-tar xjf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gdb-@value{GDBVERSION}-@value{GDBRPMRELEASE}.tar.bz2
</font><font color='#000088'>+tar xjf @value{RTEMSRPMPREFIX}binutils-common-<VERSION>-<RPM>.tar.bz2
+tar xjf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-binutils-<VERSION>-<RPM>.tar.bz2
+tar xjf @value{RTEMSRPMPREFIX}gcc-common-<VERSION>-<RPM>.tar.bz2
+tar xjf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-newlib-<VERSION>-<RPM>.tar.bz2
+tar xjf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gcc-<VERSION>-<RPM>.tar.bz2
+tar xjf @value{RTEMSRPMPREFIX}gdb-common-<VERSION>-<RPM>.tar.bz2
+tar xjf @value{RTEMSRPMPREFIX}sparc-rtems@value{RTEMSAPI}-gdb-<VERSION>-<RPM>.tar.bz2
</font> @end example
Upon successful completion of the above command sequence, a
<font color='#006600'>diff -u rtems/doc/started/buildc.t:1.47.2.1 rtems/doc/started/buildc.t:1.47.2.2
--- rtems/doc/started/buildc.t:1.47.2.1 Thu Sep 25 16:50:33 2008
+++ rtems/doc/started/buildc.t Thu Dec 16 14:54:33 2010
</font><font color='#997700'>@@ -1,5 +1,5 @@
</font> @c
<font color='#880000'>-@c COPYRIGHT (c) 1988-2002.
</font><font color='#000088'>+@c COPYRIGHT (c) 1988-2010.
</font> @c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
<font color='#997700'>@@ -8,293 +8,240 @@
</font>
@chapter Building the GNU Cross Compiler Toolset
<font color='#880000'>-NOTE: This chapter does @b{NOT} apply if you installed
-prebuilt toolset executables for BINUTILS, GCC, NEWLIB,
-and GDB. If you installed prebuilt executables for all
-of those, proceed to @ref{Building RTEMS}. If you require
-a GDB with a special configuration to connect to your
-target board, then proceed to @ref{Building the GNU Debugger GDB}
</font><font color='#000088'>+NOTE: This chapter does @b{NOT} apply if you installed prebuilt toolset
+executables for BINUTILS, GCC, NEWLIB, and GDB. If you installed
+prebuilt executables for all of those, proceed to @ref{Building RTEMS}.
+If you require a GDB with a special configuration to connect to your
+target board, then proceed to @ref{Installing GDB Without RPM}
</font> for some advice.
<font color='#880000'>-This chapter describes the steps required to acquire the
-source code for a GNU cross compiler toolset, apply<span style="background-color: #FF0000"> </span>
-any required RTEMS specific patches, compile that<span style="background-color: #FF0000"> </span>
-toolset and install it.
</font><font color='#000088'>+This chapter describes the steps required to acquire the source code for
+a GNU cross compiler toolset, apply any required RTEMS specific patches,
+compile that toolset and install it.
+
+It is recommended that when toolset binaries are available for your
+particular host, that they be used. Prebuilt binaries are much easier
+to install. They are also much easier for the RTEMS Project to support.
+
+@c
+@c Preparation
+@c
+@section Preparation
+
+Before you can build an RTEMS toolset from source, there are some
+preparatory steps which must be performed. You will need to determine
+the various tool versions and patches required and download them You
+will also have to unarchive the source and apply any patches.
+
+@c
+@c Determining Tool Version and Patch Revision
+@c
+@subsection Determining Tool Version and Patch Revision
+
+The tool versions and patch revisions change on a fairly frequent basis.
+In addition, these may vary based upon the target architecture. In some
+cases, the RTEMS Project may have to stick with a particular version
+of a tool to provide a working version for a specific architecture.
+Because of this, it is impossible to provide this information in a
+complete and accurate manner in this manual. You will need to refer
+to the configuration files used by the RTEMS RPM specification files to
+determine the current versions and, if a patch is required, what version.
+This section describes how to locate the appropriate tool versions and
+patches for a particular target architecture.
+
+All patches and RPM specification files are kept in CVS. They are
+not included in release tarballs. You will have to access the
+CVS branch for RTEMS @value{RTEMSAPI}. For details on this,
+visit @uref{http://www.rtems.org, http://www.rtems.org} and look for
+instructions on accessing the RTEMS Source Code Repository in read-only
+mode.
+
+In the checked out source code, you will need to look in the subdirectory
+@code{contrib/crossrpms/autotools} to determine the versions of AUTOCONF
+and AUTOMAKE as well as any patches required. In this directory are
+a few files you will need to look at. The first is @code{Makefile.am}
+which defines the versions of AUTOCONF and AUTOMAKE required for this
+RTEMS Release Series. Make a note of the version numbers required for
+AUTOCONF and AUTOMAKE. Then examine the following files to determine
+the master location for the source tarballs and to determine if a patch
+is required for each tool version cited in the @code{Makefile.am}.
+
+@example
+autoconf-sources.add
+automake-sources.add
+@end example
+
+If any patches are required, they will be in the
+@code{contrib/crossrpms/patches} subdirectory of your checked out RTEMS
+source tree.
+
+In the checked out source code, you will need to look in the subdirectory
+@code{contrib/crossrpms/rtems@value{RTEMSAPI}} to determine the target
+specific tool versions and patches required. In this directory, you
+will find a number of subdirectories with many named after target
+architectures supported by RTEMS. Descend into the directory for the
+architecture you plan to build tools for. Again, the @code{Makefile.am}
+defines the tool versions for this architecture and RTEMS Release Series.
+Make a note of the version numbers required for BINUTILS, GCC, NEWLIB,
+and GDB. Then examine the following files to determine the master
+location for the source tarballs and to determine if a patch is required
+for each tool version cited in the @code{Makefile.am}.
+
+@itemize
+binutils-sources.add
+gcc-sources.add
+gdb-sources.add
+@end itemize
</font>
<font color='#880000'>-It is recommended that when toolset binaries are available for
-your particular host, that they be used. Prebuilt binaries
-are much easier to install.
</font><font color='#000088'>+If any patches are required, they will be in the
+@code{contrib/crossrpms/patches} subdirectory of your checked out RTEMS
+source tree.
</font>
<font color='#880000'>-@c
-@c Building BINUTILS GCC and NEWLIB
-@c
-@section Building BINUTILS GCC and NEWLIB
</font><font color='#000088'>+This is the entire set of source tarballs and patches required for a
+toolset targeting the selected architecture. In many cases, this will be
+the same versions required by other targets on this RTEMS Release Series.
</font>
<font color='#880000'>-NOTE: This step is NOT required if prebuilt executables for
-BINUTILS, GCC, and NEWLIB were installed.
-
-This section describes the process of building BINUTILS, GCC, and
-NEWLIB using a variety of methods. Included is information on
-obtaining the source code and patches, applying patches, and
-building and installing the tools using multiple methods.
-
-@c
-@c Obtain Source and Patches for BINUTILS GCC and NEWLIB
-@c
-
-@subsection Obtain Source and Patches for BINUTILS GCC and NEWLIB
-
-NOTE: This step is required for all methods of building BINUTILS,
-GCC, and NEWLIB.
-
-This section lists the components required to build BINUTILS, GCC,
-and NEWLIB from source to target RTEMS. These files should be
-placed in your @code{archive} directory. Included are the locations
-of each component as well as any required RTEMS specific patches.
-
-@need 1000
-@subheading @value{GCCUNTAR}
-@example
- FTP Site: @value{GCCFTPSITE}
- Directory: @value{GCCFTPDIR}
- File: @value{GCCTAR}
-@c @ifset use-html
- URL: @uref{ftp://@value{GCCFTPSITE}@value{GCCFTPDIR}/@value{GCCTAR},,ftp://@value{GCCFTPSITE}@value{GCCFTPDIR}/@value{GCCTAR}}
-@c URL: ftp://@value{GCCFTPSITE}@value{GCCFTPDIR}
-@c @end ifset
-@end example
-
-@need 1000
-@subheading @value{BINUTILSUNTAR}
-@example
- FTP Site: @value{BINUTILSFTPSITE}
- Directory: @value{BINUTILSFTPDIR}
- File: @value{BINUTILSTAR}
-@c @ifset use-html
- URL: @uref{ftp://@value{BINUTILSFTPSITE}@value{BINUTILSFTPDIR}/@value{BINUTILSTAR},,ftp://@value{BINUTILSFTPSITE}@value{BINUTILSFTPDIR}/@value{BINUTILSTAR}}
-@c URL: ftp://@value{BINUTILSFTPSITE}@value{BINUTILSFTPDIR}/@value{BINUTILSTAR}
-@c @end ifset
-@end example
-
-@need 1000
-@subheading @value{NEWLIBUNTAR}
-@example
- FTP Site: @value{NEWLIBFTPSITE}
- Directory: @value{NEWLIBFTPDIR}
- File: @value{NEWLIBTAR}
-@c @ifset use-html
- URL: @uref{ftp://@value{NEWLIBFTPSITE}@value{NEWLIBFTPDIR}/@value{NEWLIBTAR},,ftp://@value{NEWLIBFTPSITE}@value{NEWLIBFTPDIR}/@value{NEWLIBTAR}}
-@c URL: ftp://@value{NEWLIBFTPSITE}@value{NEWLIBFTPDIR}/@value{NEWLIBTAR}
-@c @end ifset
-@end example
-
-@need 1000
-@subheading RTEMS Specific Tool Patches and Scripts
-@example
- FTP Site: @value{RTEMSFTPSITE}
- Directory: @value{RTEMSFTPDIR}/SOURCES/@value{RTEMSAPI}
-@ifset BINUTILSPATCHVERSION
- File: @value{BINUTILSRTEMSPATCH}
-@end ifset
-@ifset NEWLIBPATCHVERSION
- File: @value{NEWLIBRTEMSPATCH}
-@end ifset
-@ifset GCCPATCHVERSION
- File: @value{GCCRTEMSPATCH}
-@end ifset
-@ifset use-html
- URL: @uref{ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/SOURCES/@value{RTEMSAPI},,ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/SOURCES/@value{RTEMSAPI}}
-@c URL: ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/SOURCES/@value{RTEMSAPI}
-@end ifset
-@end example
-
-The individual components in the RTEMS Development Toolset are
-updated independently of one another by their respective
-maintainers. In addition, the patches which the RTEMS Project
-has determined are necessary are subject to change as users
-report issues on individual host and target platforms. As
-a result, it is possible that the versions listed in this
-document are @b{NOT} the latest ones available. The latest
-patches for each tool are always available from RTEMS CVS
-on the respective branch and should always be mirrored on the
-RTEMS ftp site. It is recommended that before building a
-toolset from source, you verify you are using the
-latest patches.
</font><font color='#000088'>+Depending on the build method chosen, you may have to download source
+and patches or only patches. Also the destination directory for the
+downloaded source is dependent on the build method followed. But the
+versions required are the same. Specific information on what to download
+and where to place it is in subsequent sections.
</font>
@c
<font color='#880000'>-@c Unarchiving the Tools
</font><font color='#000088'>+@c Obtain Source and Patches
</font> @c
<font color='#880000'>-@subsection Unarchiving the Tools
-
-NOTE: This step is required if building BINUTILS, GCC, and NEWLIB
-using the procedure described in @ref{Using configure and make}.
-It is @b{NOT} required if using the procedure
-described in @ref{Using RPM to Build BINUTILS GCC and NEWLIB}.
</font><font color='#000088'>+@subsection Obtain Source and Patches
</font>
<font color='#880000'>-GNU source distributions are archived using @code{tar} and
-compressed using either @code{gzip} or @code{bzip}.<span style="background-color: #FF0000"> </span>
-If compressed with @code{gzip}, the extension @code{.gz} is used.
-If compressed with @code{bzip}, the extension @code{.bz2} is used.
-
-While in the @code{tools} directory, unpack the compressed
-tar files for BINUTILS, GCC, and NEWLIB using the appropriate
-command based upon the compression program used.
-
-@example
-cd tools
-tar xzf ../archive/TOOLNAME.tar.gz # for gzip'ed tools
-tar xjf ../archive/TOOLNAME.tar.bz2 # for bzip'ed tools
-@end example
</font><font color='#000088'>+You will need to download the sources for the various packages from
+their master locations as identified in the previous section.
</font>
<font color='#880000'>-After the compressed tar files have been unpacked using
-the appropriate commands, the following
-directories will have been created under tools.<span style="background-color: #FF0000"> </span>
-
-@itemize @bullet
-@item @value{BINUTILSUNTAR}
-@item @value{GCCUNTAR}
-@item @value{NEWLIBUNTAR}
-@end itemize
-
-The tree should look something like the following figure:
-
-@example
-@group
-/whatever/prefix/you/choose/
- archive/
- @value{GCCTAR}
- @value{BINUTILSTAR}
- @value{NEWLIBTAR}
-@ifset GCCPATCHVERSION
- @value{GCCRTEMSPATCH}
-@end ifset
-@ifset BINUTILSPATCHVERSION
- @value{BINUTILSRTEMSPATCH}
-@end ifset
-@ifset NEWLIBPATCHVERSION
- @value{NEWLIBRTEMSPATCH}
-@end ifset
- tools/
- @value{BINUTILSUNTAR}/
- @value{GCCUNTAR}/
- @value{NEWLIBUNTAR}/
-@end group
-@end example
</font><font color='#000088'>+Any patches needed should be in the @code{contrib/crossrpms/patches}
+directory of your RTEMS source.
</font>
@c
<font color='#880000'>-@c Applying RTEMS Patches
</font><font color='#000088'>+@c Installing the Tools Without RPM
</font> @c
<font color='#000088'>+@section Installing the Tools Without RPM
</font>
<font color='#880000'>-@subsection Applying RTEMS Patches
-
-NOTE: This step is required if building BINUTILS, GCC, and NEWLIB
-using the procedures described in @ref{Using configure and make}.
-It is @b{NOT} required if using the procedure
-described in @ref{Using RPM to Build BINUTILS GCC and NEWLIB}.
</font><font color='#000088'>+This section describes the procedure for building and installing an RTEMS
+cross toolset from source code without using the RPM build infrastructure.
</font>
<font color='#880000'>-This section describes the process of applying the RTEMS patches
-to GCC, NEWLIB, and BINUTILS.
</font><font color='#000088'>+Direct invocation of @code{configure} and @code{make} provides more control
+and easier recovery from problems when building.
</font>
@c
<font color='#880000'>-@c GCC patches
</font><font color='#000088'>+@c Archive and Build Directory Format
</font> @c
<font color='#000088'>+@subsection Archive and Build Directory Format
</font>
<font color='#880000'>-@subheading Apply RTEMS Patch to GCC
-
-@ifclear GCCPATCHVERSION
-No RTEMS specific patches are required for @value{GCCUNTAR} to
-support @value{RTEMSVERSION}.
-@end ifclear
-
-@ifset GCCPATCHVERSION
</font><font color='#000088'>+When no packaging format requirements are present, the root directory for
+the storage of source archives and patches as well as for building the
+tools is up to the user. The only concern is that there be enough
+disk space to complete the build. In this document, the following
+organization will be used.
</font>
<font color='#880000'>-Apply the patch using the following command sequence:
</font><font color='#000088'>+Make an @code{archive} directory to contain the downloaded source code
+and pataches. Additionally, a @code{tools} directory to be used as a
+build directory. The command sequence to do this is shown below:
</font>
@example
<font color='#880000'>-cd tools/@value{GCCUNTAR}
-cat ../../archive/@value{GCCRTEMSPATCH} | \
- patch -p1
</font><font color='#000088'>+mkdir archive
+mkdir tools
</font> @end example
<font color='#880000'>-If the patch was compressed with the @code{gzip} program, it will
-have a suffix of @code{.gz} and you should use @code{zcat} instead
-of @code{cat} as shown above. If the patch was compressed with
-the @code{gzip} program, it will have a suffix of @code{.bz2} and
-you should use @code{bzcat} instead of @code{cat} as shown above.
-
-Check to see if any of these patches have been rejected using the following
-sequence:
</font><font color='#000088'>+This will result in an initial directory structure similar to the
+one shown in the following figure:
</font>
@example
<font color='#880000'>-cd tools/@value{GCCUNTAR}
-find . -name "*.rej" -print
-@end example
</font><font color='#000088'>+@group
+/whatever/prefix/you/choose/
+ archive/
+ tools/
</font>
<font color='#880000'>-If any files are found with the .rej extension, a patch has been rejected.
-This should not happen with a good patch file which is properly applied.
</font><font color='#000088'>+@end group
+@end example
</font>
<font color='#880000'>-@end ifset
</font><font color='#000088'>+The RTEMS Project tries to submit all of our patches upstream to the
+parent projects. In the event there are patches, the master copy of them
+is located in the appropriate branch of the RTEMS source module in CVS.
+Patches are in the @code{contrib/crossrpms/patches}.
</font>
@c
<font color='#880000'>-@c BINUTILS patches
</font><font color='#000088'>+@c Unarchiving the Tools
</font> @c
<font color='#000088'>+@subsection Unarchiving the Tools
</font>
<font color='#880000'>-@subheading Apply RTEMS Patch to binutils
</font><font color='#000088'>+NOTE: This step is required if building any of the tools without using RPM.
+It is @b{NOT} required if using the procedure described in @ref{Using RPM
+to Build Tools}. This section describes the process of unarchiving the
+tools that comprise an RTEMS toolset.
</font>
<font color='#880000'>-@ifclear BINUTILSPATCHVERSION
-No RTEMS specific patches are required for @value{BINUTILSUNTAR} to
-support @value{RTEMSVERSION}.
-@end ifclear
</font><font color='#000088'>+GNU source distributions are archived using @code{tar} and
+compressed using either @code{gzip} or @code{bzip}.<span style="background-color: #FF0000"> </span>
+If compressed with @code{gzip}, the extension @code{.gz} is used.
+If compressed with @code{bzip}, the extension @code{.bz2} is used.
</font>
<font color='#880000'>-@ifset BINUTILSPATCHVERSION
-Apply the patch using the following command sequence:
</font><font color='#000088'>+While in the @code{tools} directory, unpack the compressed tar files
+using the appropriate command based upon the compression program used.
</font>
@example
<font color='#880000'>-cd tools/@value{BINUTILSUNTAR}
-cat ../../archive/@value{BINUTILSRTEMSPATCH} | \
- patch -p1
</font><font color='#000088'>+cd tools
+tar xzf ../archive/TOOLNAME.tar.gz # for gzip'ed tools
+tar xjf ../archive/TOOLNAME.tar.bz2 # for bzip'ed tools
</font> @end example
<font color='#880000'>-If the patch was compressed with the @code{gzip} program, it will
-have a suffix of @code{.gz} and you should use @code{zcat} instead
-of @code{cat} as shown above. If the patch was compressed with
-the @code{gzip} program, it will have a suffix of @code{.bz2} and
-you should use @code{bzcat} instead of @code{cat} as shown above.
</font><font color='#000088'>+Assuming you are building a complete toolset, after all of the the
+compressed tar files have been unpacked using the appropriate commands,
+the following directories will have been created under @code{tools}.
</font>
<font color='#880000'>-Check to see if any of these patches have been rejected using the following
-sequence:<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+@itemize @bullet
+@item autoconf-<VERSION>
+@item automake-<VERSION>
+@item binutils-<VERSION>
+@item gcc-<VERSION>
+@item binutils-<VERSION>
+@item gdb-<VERSION>
+@end itemize
+
+The tree should look something like the following figure:
</font>
@example
<font color='#880000'>-cd tools/@value{BINUTILSUNTAR}
-find . -name "*.rej" -print
</font><font color='#000088'>+@group
+/whatever/prefix/you/choose/
+ archive/
+ variable tarballs
+ variable patches
+ tools/
+ various tool source trees
+@end group
</font> @end example
<font color='#880000'>-If any files are found with the .rej extension, a patch has been rejected.
-This should not happen with a good patch file which is properly applied.<span style="background-color: #FF0000"> </span>
-
-@end ifset
-
</font> @c
<font color='#880000'>-@c Newlib patches
</font><font color='#000088'>+@c Applying RTEMS Project Tool Patches
</font> @c
<font color='#880000'>-@subheading Apply RTEMS Patch to newlib
-
-@ifclear NEWLIBPATCHVERSION
-No RTEMS specific patches are required for @value{NEWLIBUNTAR} to
-support @value{RTEMSVERSION}.
-@end ifclear
</font><font color='#000088'>+@subsection Applying RTEMS Project Tool Patches
</font>
<font color='#880000'>-@ifset NEWLIBPATCHVERSION
</font><font color='#000088'>+NOTE: This step is required if building any of the tools IF they have a
+patch currently required and you are building the tools without using RPM.
+is @b{NOT} required if using the procedure described in @ref{Using RPM
+to Build Tools}. This section describes the process of applying the
+RTEMS patches to any of the tools.
</font>
<font color='#880000'>-Apply the patch using the following command sequence:
</font><font color='#000088'>+If a patch is required for a particular tool source tree, then you will
+perform a command similar to the following to apply the patch. In this
+example, <TOOL> should be replaced by the appropriate tool directory
+and <TOOL_PATCH> with the appropriate patch file.
</font>
@example
<font color='#880000'>-cd tools/@value{NEWLIBUNTAR}
-cat ../../archive/@value{NEWLIBRTEMSPATCH} | \
- patch -p1
</font><font color='#000088'>+cd tools/<TOOL>
+cat ../../archive/<TOOL_PATCH> | patch -p1
</font> @end example
<font color='#000088'>+NOTE: If you add the @code{--dry-run} option to the @code{patch} command
+in the above commands, it will attempt to apply the patch and report
+any issues without actually modifying any files.
+
</font> If the patch was compressed with the @code{gzip} program, it will
have a suffix of @code{.gz} and you should use @code{zcat} instead
of @code{cat} as shown above. If the patch was compressed with
<font color='#997700'>@@ -302,210 +249,93 @@
</font> you should use @code{bzcat} instead of @code{cat} as shown above.
Check to see if any of these patches have been rejected using the following
<font color='#880000'>-sequence:<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+sequence:
</font>
@example
<font color='#880000'>-cd tools/@value{NEWLIBUNTAR}
</font><font color='#000088'>+cd tools/<TOOL>
</font> find . -name "*.rej" -print
@end example
If any files are found with the .rej extension, a patch has been rejected.
<font color='#880000'>-This should not happen with a good patch file which is properly applied.<span style="background-color: #FF0000"> </span>
-
-@end ifset
-
-
-@c
-@c Compiling and Installing BINUTILS GCC and NEWLIB
-@c
-
-@subsection Compiling and Installing BINUTILS GCC and NEWLIB
-
-There are two supported methods to compile and install BINUTILS, GCC,
-and NEWLIB:
-
-@itemize @bullet
-@item RPM
-@item direct invocation of @code{configure} and @code{make}
-@end itemize
-
-Direct invocation of @code{configure} and @code{make} provides more control
-and easier recovery from problems when building.
-
-@c
-@c Using RPM to Build BINUTILS GCC and NEWLIB
-@c
-
-@subsubsection Using RPM to Build BINUTILS GCC and NEWLIB
-
-NOTE: The procedures described in the following sections must
-be completed before this step:
-
-@itemize @bullet
-@item @ref{Obtain Source and Patches for BINUTILS GCC and NEWLIB}
-@end itemize
-
-RPM automatically unarchives the source and applies any needed
-patches so you do @b{NOT} have to manually perform the procedures
-described @ref{Unarchiving the Tools} and<span style="background-color: #FF0000"> </span>
-@ref{Applying RTEMS Patches}.
-
-This section describes the process of building binutils, gcc, and
-newlib using RPM. RPM is a packaging format which can be used to
-distribute binary files as well as to capture the procedure and
-source code used to produce those binary files. Before
-attempting to build any RPM from source, it is necessary to
-ensure that all required source and patches are in the @code{SOURCES}
-directory under the RPM root (probably @code{/usr/src/redhat} or
-@code{/usr/local/src/redhat}) on your machine. This procedure
-starts by installing the source RPMs as shown in the following<span style="background-color: #FF0000"> </span>
-example:
-
-@example<span style="background-color: #FF0000"> </span>
-rpm -U @value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-binutils-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.src.rpm
-rpm -U @value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-gcc-@value{GCCVERSION}-@value{GCCRPMRELEASE}.src.rpm
-@end example
-
-The RTEMS tool source RPMS are called "nosrc" to indicate that one or
-more source files required to produce the RPMs are not present.<span style="background-color: #FF0000"> </span>
-The RTEMS source RPMs typically include all required patches, but do not<span style="background-color: #FF0000"> </span>
-include the large @code{.tar.gz} or @code{.tgz} files for
-each component such as BINUTILS, GCC, or NEWLIB. These are shared
-by all RTEMS RPMs regardless of target CPU and there was no reason
-to duplicate them. You will have to get the required source
-archive files by hand and place them in the @code{SOURCES} directory
-before attempting to build. If you forget to do this, RPM is
-smart -- it will tell you what is missing. To determine what is
-included or referenced by a particular RPM, use a command like the
-following:
-
-@example
-@c Don't use @value{GCC*} below. This is an example
-$ rpm -q -l -p @value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-gcc-3.2.3-1.src.rpm
-gcc-3.2.3-rtems@value{RTEMSAPI}-20030507a.diff
-@value{RTEMSRPMPREFIX}i386-rtems4.7-gcc.spec
-newlib-1.11.0-rtems@value{RTEMSAPI}-20030507.diff
-@end example
-
-Notice that there are patch files (the @code{.diff} files) and a file<span style="background-color: #FF0000"> </span>
-describing the build procedure and files produced (the @code{.spec} file),
-but no source archives (the @code{*tar.*} files).
-When installing this source RPM<span style="background-color: #FF0000"> </span>
-(@code{rpm -U @value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-gcc-newlib-gcc3.2.3newlib1.11.0-1.src.rpm}),
-the @code{.spec} file is placed in the @code{SPECS} directory under the RPM root
-directory, while the @code{*.diff} files are placed into the @code{SOURCES}
-directory.
</font><font color='#000088'>+This should not happen with a good patch file which is properly applied.
</font>
@c
<font color='#880000'>-@c Configuring and Building BINUTILS using RPM
</font><font color='#000088'>+@c Installing AUTOCONF Without RPM
</font> @c
<font color='#880000'>-@subheading Configuring and Building BINUTILS using RPM
</font><font color='#000088'>+@subsection Installing AUTOCONF Without RPM
</font>
<font color='#880000'>-The following example illustrates the invocation of RPM to build a new,
-locally compiled, binutils binary RPM that matches the installed source<span style="background-color: #FF0000"> </span>
-RPM. This example assumes that all of the required source is installed.
</font><font color='#000088'>+The following example illustrates the invocation of @code{configure}
+and @code{make} to build and install autoconf-<version>. This tool is<span style="background-color: #FF0000"> </span>
+installed as a native utility and is independent of any RTEMS target.
</font>
@example
<font color='#880000'>-cd <RPM_ROOT_DIRECTORY>/SPECS
-rpm -bb i386-rtems@value{RTEMSAPI}-binutils-@value{BINUTILSVERSION}.spec
</font><font color='#000088'>+mkdir b-autoconf
+cd b-autoconf
+../autoconf-<VERSION>/configure --prefix=@value{RTEMSPREFIX}
+make all
+make info
+make install
</font> @end example
<font color='#880000'>-If the build completes successfully, RPMS like the following will
-be generated in a build-host architecture specific subdirectory
-of the RPMS directory under the RPM root directory.
-
-@example
-@value{RTEMSRPMPREFIX}binutils-common-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.i386.rpm
-@value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-binutils-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.i386.rpm
-@end example
</font><font color='#000088'>+After autoconf-<VERSION> is built and installed the build directory
+@code{b-autoconf} may be removed.
</font>
<font color='#880000'>-NOTE: It may be necessary to remove the build tree in the
-@code{BUILD} directory under the RPM root directory.
</font><font color='#000088'>+For more information on the invocation of @code{configure}, please
+refer to the documentation for autoconf-<VERSION> or invoke the
+autoconf-VERSION> @code{configure} command with the @code{--help} option.
</font>
@c
<font color='#880000'>-@c Configuring and Building GCC and NEWLIB using RPM
</font><font color='#000088'>+@c Installing AUTOMAKE Without RPM
</font> @c
<font color='#880000'>-@subheading Configuring and Building GCC and NEWLIB using RPM
-
-The following example illustrates the invocation of RPM to build a new,
-locally compiled, set of GCC and NEWLIB binary RPMs that match the
-installed source RPM. It is also necessary to install the BINUTILS
-RPMs and place them in your PATH. This example assumes that all of
-the required source is installed.
-
-@example
-cd <RPM_ROOT_DIRECTORY>/RPMS/i386
-rpm -U @value{RTEMSRPMPREFIX}binutils-common-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.i386.rpm
-rpm -U @value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-binutils-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.i386.rpm
-export PATH=@value{RTEMSPREFIX}/bin:$PATH
-cd <RPM_ROOT_DIRECTORY>/SPECS
-rpm -bb i386-rtems@value{RTEMSAPI}-gcc-@value{GCCVERSION}-newlib-@value{NEWLIBVERSION}.spec
-@end example
</font><font color='#000088'>+@subsection Installing AUTOMAKE Without RPM
</font>
<font color='#880000'>-If the build completes successfully, a set of RPMS like the following will
-be generated in a build-host architecture specific subdirectory
-of the RPMS directory under the RPM root directory.
</font><font color='#000088'>+The following example illustrates the invocation of @code{configure}
+and @code{make} to build and install automake-<version>. This tool is<span style="background-color: #FF0000"> </span>
+installed as a native utility and is independent of any RTEMS target.
</font>
@example
<font color='#880000'>-@value{RTEMSRPMPREFIX}gcc-common-@value{GCCVERSION}-@value{GCCRPMRELEASE}.i386.rpm
-@value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-newlib-@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.i386.rpm
-@value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-gcc-@value{GCCVERSION}-@value{GCCRPMRELEASE}.i386.rpm
-@value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-gcc-c++-@value{GCCVERSION}-@value{GCCRPMRELEASE}.i386.rpm
</font><font color='#000088'>+mkdir b-automake
+cd b-automake
+../automake-<VERSION>/configure --prefix=@value{RTEMSPREFIX}
+make all
+make info
+make install
</font> @end example
<font color='#880000'>-NOTE: Some targets do not support building all languages.
-
-NOTE: It may be necessary to remove the build tree in the
-@code{BUILD} directory under the RPM root directory.
-
-@c
-@c Using configure and make
-@c
-
-@subsubsection Using configure and make
</font><font color='#000088'>+After automake-<VERSION> is built and installed the build directory
+@code{b-automake} may be removed.
</font>
<font color='#880000'>-NOTE: The procedures described in the following sections must
-be completed before this step:
-
-@itemize @bullet
-@item @ref{Obtain Source and Patches for BINUTILS GCC and NEWLIB}
-@item @ref{Unarchiving the Tools}
-@item @ref{Applying RTEMS Patches}
-@end itemize
-
-This section describes the process of building binutils, gcc, and
-newlib manually using @code{configure} and @code{make} directly.
</font><font color='#000088'>+For more information on the invocation of @code{configure}, please
+refer to the documentation for automake-<VERSION> or invoke the
+automake-VERSION> @code{configure} command with the @code{--help} option.
</font>
@c
<font color='#880000'>-@c Configuring and Building BINUTILS
</font><font color='#000088'>+@c Installing BINUTILS Without RPM
</font> @c
<font color='#000088'>+@subsection Installing BINUTILS Without RPM
</font>
<font color='#880000'>-@subheading Configuring and Building BINUTILS
-
-The following example illustrates the invocation of
-@code{configure} and @code{make}
-to build and install @value{BINUTILSUNTAR} for the
</font><font color='#000088'>+The following example illustrates the invocation of @code{configure}
+and @code{make} to build and install binutils-<version>
</font> sparc-rtems@value{RTEMSAPI} target:
@example
mkdir b-binutils
cd b-binutils
<font color='#880000'>-../@value{BINUTILSUNTAR}/configure --target=sparc-rtems@value{RTEMSAPI} \
</font><font color='#000088'>+../binutils-<VERSION>/configure --target=sparc-rtems@value{RTEMSAPI} \
</font> --prefix=@value{RTEMSPREFIX}
make all
make info
make install
@end example
<font color='#880000'>-After @value{BINUTILSUNTAR} is built and installed the<span style="background-color: #FF0000"> </span>
-build directory @code{b-binutils} may be removed.
</font><font color='#000088'>+After binutils-<VERSION> is built and installed the build directory
+@code{b-binutils} may be removed.
</font>
For more information on the invocation of @code{configure}, please
<font color='#880000'>-refer to the documentation for @value{BINUTILSUNTAR} or<span style="background-color: #FF0000"> </span>
-invoke the @value{BINUTILSUNTAR} @code{configure} command with the
-@code{--help} option.
</font><font color='#000088'>+refer to the documentation for binutils-<VERSION> or invoke the
+binutils-VERSION> @code{configure} command with the @code{--help} option.
</font>
NOTE: The shell PATH variable needs to be updated to include the path
the binutils user executables have been installed in. The directory
<font color='#997700'>@@ -524,35 +354,34 @@
</font> @end example
@c
<font color='#880000'>-@c Configuring and Building GCC and NEWLIB
</font><font color='#000088'>+@c Installing GCC and NEWLIB Without RPM
</font> @c
<font color='#000088'>+@subsection Installing GCC and NEWLIB Without RPM
</font>
<font color='#880000'>-@subheading Configuring and Building GCC and NEWLIB
-
-Before building @value{GCCUNTAR} and @value{NEWLIBUNTAR},<span style="background-color: #FF0000"> </span>
-@value{BINUTILSUNTAR} must be installed and the directory
</font><font color='#000088'>+Before building gcc-<VERSION> and newlib-<VERSION>,<span style="background-color: #FF0000"> </span>
+binutils-<VERSION> must be installed and the directory
</font> containing those executables must be in your PATH.
The C Library is built as a subordinate component of<span style="background-color: #FF0000"> </span>
<font color='#880000'>-@value{GCCUNTAR}. Because of this, the @value{NEWLIBUNTAR}
-directory source must be available inside the @value{GCCUNTAR}
</font><font color='#000088'>+gcc-<VERSION>. Because of this, the newlib-<VERSION>
+directory source must be available inside the gcc-<VERSION>
</font> source tree. This is normally accomplished using a symbolic
link as shown in this example:
@example
<font color='#880000'>-cd @value{GCCUNTAR}
-ln -s ../@value{NEWLIBUNTAR}/newlib .
</font><font color='#000088'>+cd gcc-<VERSION>
+ln -s ../newlib-<VERSION>/newlib .
</font> @end example
The following example illustrates the invocation of
@code{configure} and @code{make}
<font color='#880000'>-to build and install @value{GCCUNTAR} with only
</font><font color='#000088'>+to build and install gcc-<VERSION> with only
</font> C and C++ support for the sparc-rtems@value{RTEMSAPI} target:
@example
mkdir b-gcc
cd b-gcc
<font color='#880000'>-../@value{GCCUNTAR}/configure --target=sparc-rtems@value{RTEMSAPI} \
</font><font color='#000088'>+../gcc-<VERSION>/configure --target=sparc-rtems@value{RTEMSAPI} \
</font> --with-gnu-as --with-gnu-ld --with-newlib --verbose \
--enable-threads --enable-languages="c,c++" \
--prefix=@value{RTEMSPREFIX}
<font color='#997700'>@@ -561,18 +390,18 @@
</font> make install
@end example
<font color='#880000'>-After @value{GCCUNTAR} is built and installed the<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+After gcc-<VERSION> is built and installed the<span style="background-color: #FF0000"> </span>
</font> build directory @code{b-gcc} may be removed.
For more information on the invocation of @code{configure}, please
<font color='#880000'>-refer to the documentation for @value{GCCUNTAR} or
-invoke the @value{GCCUNTAR} @code{configure} command with the
</font><font color='#000088'>+refer to the documentation for gcc-<VERSION> or
+invoke the gcc-<VERSION> @code{configure} command with the
</font> @code{--help} option.
@c
@c Building GCC with Ada Support
@c
<font color='#880000'>-@subheading Building GCC with Ada Support
</font><font color='#000088'>+@subsection Building GCC with Ada Support
</font>
If you want a GCC toolset that includes support for Ada
(e.g. GNAT), there are some additional requirements on
<font color='#997700'>@@ -582,63 +411,75 @@
</font> and when building a GNAT cross-compiler, it should be<span style="background-color: #FF0000"> </span>
the same version of GNAT itself.<span style="background-color: #FF0000"> </span>
<font color='#880000'>-The build procedure is the same until the configure step.<span style="background-color: #FF0000"> </span>
-A GCC toolset with GNAT enabled requires that @code{ada}
-be included in the set of enabled languages.
-The following example illustrates the invocation of
-@code{configure} and @code{make}
-to build and install @value{GCCUNTAR} with only
-C, C++, and Ada support for the sparc-rtems@value{RTEMSAPI} target:
</font><font color='#000088'>+It is also important to verify whether there is an RTEMS specific
+Ada patch required for GCC. These can be found in<span style="background-color: #FF0000"> </span>
+@uref{http://www.rtems.org/ftp/pub/rtems/people/joel/ada,
+http://www.rtems.org/ftp/pub/rtems/people/joel/ada}. The patch is
+often a minor version or two behind GCC but will usually apply cleanly.
+This patch must be applied.
+
+After this, it is critical to perform these steps in the correct order.
+GNAT requires that the C Library and RTEMS itself be installed before
+the language run-time can be built.
+
+@itemize @bullet
+@item install native GCC with GNAT
+@item place new native GNAT at head of PATH
+@item install BINUTILS
+@item place RTEMS prefix at head of PATH
+@item install C toolset (C++ is optional)
+@item install RTEMS built multilib
+@item install RTEMS built for your BSP
+@end itemize
+
+The build procedure is the same until the Ada configure step. A GCC
+toolset with GNAT enabled requires that @code{ada} be included in the set
+of enabled languages. The following example illustrates the invocation of
+@code{configure} and @code{make} to build and install gcc-<VERSION> with
+only C, C++, and Ada support for the sparc-rtems@value{RTEMSAPI} target:
</font>
@example
mkdir b-gcc
<font color='#880000'>-cd @value{GCCUNTAR}/gcc/ada
-touch treeprs.ads [es]info.h nmake.ad[bs]
-cd ../../../b-gcc
-../@value{GCCUNTAR}/configure --target=sparc-rtems@value{RTEMSAPI} \
</font><font color='#000088'>+cd b-gcc
+../gcc-<VERSION>/configure --target=sparc-rtems@value{RTEMSAPI} \
</font> --with-gnu-as --with-gnu-ld --with-newlib --verbose \
--enable-threads --enable-languages="c,c++,ada" \
--prefix=@value{RTEMSPREFIX}
make all
make info
<font color='#880000'>-make -C gcc cross-gnattools
-make -C gcc ada.all.cross
-make -C gcc GNATLIBCFLAGS="USER_SELECTED_CPU_CFLAGS" gnatlib
</font> make install
@end example
<font color='#880000'>-After @value{GCCUNTAR} is built and installed the<span style="background-color: #FF0000"> </span>
-build directory @code{b-gcc} may be removed.
</font><font color='#000088'>+After gcc-<VERSION> is built and installed the build directory
+@code{b-gcc} may be removed.
</font>
@c
<font color='#880000'>-@c Building the GNU Debugger GDB
</font><font color='#000088'>+@c Installing GDB Without RPM
</font> @c
<font color='#000088'>+@subsection Installing GDB Without RPM
</font>
<font color='#880000'>-@section Building the GNU Debugger GDB
-
-NOTE: This step is NOT required if prebuilt executables for
-the GNU Debugger GDB were installed.
</font><font color='#000088'>+NOTE: This step is NOT required if prebuilt executables for the
+GDB were installed and they meet your target interface
+requirements.
</font>
<font color='#880000'>-The GNU Debugger GDB supports many configurations but requires some
-means of communicating between the host computer and target board.
-This communication can be via a serial port, Ethernet, BDM, or ROM emulator.
-The communication protocol can be the GDB remote protocol or GDB
-can talk directly to a ROM monitor. This setup is target board<span style="background-color: #FF0000"> </span>
-specific. The following configurations have been
-successfully used with RTEMS applications:
</font><font color='#000088'>+GDB supports many configurations but requires some means of communicating
+between the host computer and target board. This communication can be via
+a serial port, Ethernet, BDM, or ROM emulator. The communication protocol
+can be the GDB remote protocol or GDB can talk directly to a ROM monitor.
+This setup is target board specific. Some of the configurations that have
+been successfully used with RTEMS applications are:
</font>
@itemize @bullet
@item BDM with ColdFire, 683xx, MPC860 CPUs
@item Motorola Mxxxbug found on M68xxx VME boards
@item Motorola PPCbug found on PowerPC VME, CompactPCI, and MTX boards
<font color='#880000'>-@item ARM based Cogent EDP7312
</font><font color='#000088'>+@item ARM based Cogent EDB7312
</font> @item PC's using various Intel and AMD CPUs including i386,
i486, Pentium and above, and Athlon
@item PowerPC Instruction Simulator in GDB (PSIM)
@item MIPS Instruction Simulator in GDB (JMR3904)
@item Sparc Instruction Simulator in GDB (SIS)
@item Sparc Instruction Simulator (TSIM)
<font color='#880000'>-@item DINK32 on various PowerPC boards
</font> @end itemize
GDB is currently RTEMS thread/task aware only if you are using the
<font color='#997700'>@@ -650,224 +491,241 @@
</font> are much easier to install but in the case of gdb may or may
not include support for your particular target board.
<font color='#880000'>-@c
-@c Obtain Source and Patches for GDB
-@c
</font><font color='#000088'>+The following example illustrates the invocation of @code{configure}
+and @code{make} to build and install gdb-<VERSION> for the
+m68k-rtems@value{RTEMSAPI} target:
+
+@example
+mkdir b-gdb
+cd b-gdb
+../gdb-<VERSION>/configure --target=m68k-rtems@value{RTEMSAPI} \
+ --prefix=@value{RTEMSPREFIX}
+make all
+make info
+make install
+@end example
</font>
<font color='#880000'>-@subsection Obtain Source and Patches for GDB
</font><font color='#000088'>+For some configurations, it is necessary to specify extra options
+to @code{configure} to enable and configure option components
+such as a processor simulator. The following is a list of
+configurations for which there are extra options:
</font>
<font color='#880000'>-NOTE: This step is required for all methods of building GDB.
</font><font color='#000088'>+@table @b
+@item powerpc-rtems@value{RTEMSAPI}
+@code{--enable-sim --enable-sim-powerpc --enable-sim-timebase --enable-sim-hardware}
</font>
<font color='#880000'>-This section lists the components required to build GDB
-from source to target RTEMS. These files should be
-placed in your @code{archive} directory. Included are the locations
-of each component as well as any required RTEMS specific patches.
</font><font color='#000088'>+@item sparc-rtems@value{RTEMSAPI}
+@code{--enable-sim}
</font>
<font color='#880000'>-@need 1000
-@subheading @value{GDBUNTAR}
-@example
- FTP Site: @value{GDBFTPSITE}
- Directory: @value{GDBFTPDIR}
- File: @value{GDBTAR}
- URL: @uref{@value{GDBFTPURL},,@value{GDBFTPURL}}
-@end example
</font><font color='#000088'>+@end table
+
+After gdb-<VERSION> is built and installed the
+build directory @code{b-gdb} may be removed.
+
+For more information on the invocation of @code{configure}, please
+refer to the documentation for gdb-<VERSION> or
+invoke the gdb-<VERSION> @code{configure} command with the
+@code{--help} option.
</font>
<font color='#880000'>-@need 1000
-@subheading RTEMS Specific Tool Patches and Scripts
-@example
- FTP Site: @value{RTEMSFTPSITE}
- Directory: @value{RTEMSFTPDIR}/SOURCES/@value{RTEMSAPI}
-@ifset GDBPATCHVERSION
- File: @value{GDBRTEMSPATCH}
- URL: @uref{ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/SOURCES/@value{GDBRTEMSPATCH},,ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/SOURCES/@value{GDBRTEMSPATCH}}
-@end ifset
-@end example
</font>
@c
<font color='#880000'>-@c Unarchiving the GDB Distribution
</font><font color='#000088'>+@c Using RPM to Build Tools
</font> @c
<font color='#880000'>-@subsection Unarchiving the GDB Distribution
</font>
<font color='#880000'>-Use the following commands to unarchive the GDB distribution:
</font><font color='#000088'>+@section Using RPM to Build Tools
+
+RPM is a packaging format which can be used to distribute binary files as
+well as to capture the procedure and source code used to produce those
+binary files. For RPM, it is assumed that the following subdirectories
+are under a root directory such as @code{/usr/src/redhat} or
+@code{/usr/local/src/redhat}) on your machine.<span style="background-color: #FF0000"> </span>
</font>
@example
<font color='#880000'>-cd tools
-tar xzf ../archive/@value{GDBTAR}
</font><font color='#000088'>+BUILD
+RPMS
+SOURCES
+SPECS
+SRPMS
</font> @end example
<font color='#880000'>-The directory @value{GDBUNTAR} is created under the tools directory.
</font><font color='#000088'>+For the purposes of this document, the RPM @code{SOURCES} directory is the
+directory into which all tool source and patches are assumed to reside.
+The @code{BUILD} directory is where the actual build is performed when
+building binaries from a source RPM.<span style="background-color: #FF0000"> </span>
</font>
<font color='#880000'>-@c
-@c Applying RTEMS Patch to GDB
-@c
</font><font color='#000088'>+RPM automatically unarchives the source and applies any needed patches
+so you do @b{NOT} have to manually perform the procedures described
+@ref{Unarchiving the Tools} and @ref{Applying RTEMS Project Tool Patches}.
+But you are responsible for placing all source tarballs
+and patches in the @code{SOURCES} directory per the instructions in
+@ref{Obtain Source and Patches}
</font>
<font color='#880000'>-@subsection Applying RTEMS Patch to GDB
</font><font color='#000088'>+This procedure starts by installing the source (e.g. @code{.src.rpm}
+extension) RPMs. The RTEMS tool source RPMS are called "nosrc" to
+indicate that one or more source files required to produce the RPMs
+are not present. The RTEMS source RPMs typically include all required
+patches, but do not include the large @code{.tar.gz} or @code{.tgz} files
+for each component such as BINUTILS, GCC, or NEWLIB. These are shared
+by all RTEMS RPMs regardless of target CPU and there was no reason to
+duplicate them. You will have to get the required source archive files
+by hand and place them in the @code{SOURCES} directory before attempting
+to build. If you forget to do this, RPM is smart -- it will tell you
+what is missing. You can fetch any missing files and try again.
</font>
<font color='#880000'>-@ifclear GDBPATCHVERSION
-No RTEMS specific patches are required for @value{GDBVERSION} to
-support @value{RTEMSVERSION}.
-@end ifclear
</font><font color='#000088'>+@c
+@c Building AUTOCONF using RPM
+@c
+@subsection Building AUTOCONF using RPM
</font>
<font color='#880000'>-@ifset GDBPATCHVERSION
</font><font color='#000088'>+This section illustrates the invocation of RPM to build a new, locally
+compiled, AUTOCONF binary RPM that matches the installed source RPM.
+This example assumes that all of the required source is installed.
</font>
<font color='#880000'>-Apply the patch using the following command sequence:
</font><font color='#000088'>+@example<span style="background-color: #FF0000"> </span>
+rpm -U @value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-autoconf-<VERSION>-<RPM_RELEASE>.src.rpm
+@end example
</font>
@example
<font color='#880000'>-cd tools/@value{GDBUNTAR}
-cat archive/@value{GDBRTEMSPATCH} | \
- patch -p1
</font><font color='#000088'>+cd <RPM_ROOT_DIRECTORY>/SPECS
+rpm -bb i386-rtems@value{RTEMSAPI}-autoconf-<VERSION>.spec
</font> @end example
<font color='#880000'>-If the patch was compressed with the @code{gzip} program, it will
-have a suffix of @code{.gz} and you should use @code{zcat} instead
-of @code{cat} as shown above. If the patch was compressed with
-the @code{gzip} program, it will have a suffix of @code{.bz2} and
-you should use @code{bzcat} instead of @code{cat} as shown above.
-
-Check to see if any of these patches have been rejected using the following
-sequence:
</font><font color='#000088'>+If the build completes successfully, RPMS like the following will be
+generated in a build-host architecture specific subdirectory of the RPMs
+directory under the RPM root directory.
</font>
@example
<font color='#880000'>-cd tools/@value{GDBUNTAR}
-find . -name "*.rej" -print
</font><font color='#000088'>+@value{RTEMSRPMPREFIX}rtems@value{RTEMSAPI}-autoconf-<VERSION>-<RPM_RELEASE>.<ARCH>.rpm
</font> @end example
<font color='#880000'>-If any files are found with the .rej extension, a patch has been rejected.
-This should not happen with a good patch file.
-
-@end ifset
</font><font color='#000088'>+NOTE: It may be necessary to remove the build tree in the @code{BUILD}
+directory under the RPM root directory.
</font>
@c
<font color='#880000'>-@c Compiling and Installing the GNU Debugger GDB
</font><font color='#000088'>+@c Building AUTOMAKE using RPM
</font> @c
<font color='#000088'>+@subsection Building AUTOMAKE using RPM
</font>
<font color='#880000'>-@subsection Compiling and Installing the GNU Debugger GDB
</font><font color='#000088'>+This section illustrates the invocation of RPM to build a new, locally
+compiled, AUTOMAKE binary RPM that matches the installed source RPM.
+This example assumes that all of the required source is installed.
</font>
<font color='#880000'>-There are three methods of building the GNU Debugger:
</font><font color='#000088'>+@example<span style="background-color: #FF0000"> </span>
+rpm -U @value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-automake-<VERSION>-<RPM_RELEASE>.src.rpm
+@end example
</font>
<font color='#880000'>-@itemize @bullet
-@item RPM
-@item direct invocation of @code{configure} and @code{make}
-@end itemize
</font><font color='#000088'>+@example
+cd <RPM_ROOT_DIRECTORY>/SPECS
+rpm -bb i386-rtems@value{RTEMSAPI}-automake-<VERSION>.spec
+@end example
+
+If the build completes successfully, RPMS like the following will be
+generated in a build-host architecture specific subdirectory of the RPMs
+directory under the RPM root directory.
+
+@example
+@value{RTEMSRPMPREFIX}rtems@value{RTEMSAPI}-automake-<VERSION>-<RPM_RELEASE>.<ARCH>.rpm
+@end example
+
+NOTE: It may be necessary to remove the build tree in the @code{BUILD}
+directory under the RPM root directory.
</font>
<font color='#880000'>-Direct invocation of @code{configure} and @code{make} provides more control
-and easier recovery from problems when building.
</font>
@c
<font color='#880000'>-@c Using RPM to Build GDB
</font><font color='#000088'>+@c Building BINUTILS using RPM
</font> @c
<font color='#000088'>+@subsection Building BINUTILS using RPM
</font>
<font color='#880000'>-@subsubsection Using RPM to Build GDB
</font><font color='#000088'>+This section illustrates the invocation of RPM to build a new, locally
+compiled, binutils binary RPM that matches the installed source RPM.
+This example assumes that all of the required source is installed.
</font>
<font color='#880000'>-This section describes the process of building binutils, gcc, and
-newlib using RPM. RPM is a packaging format which can be used to
-distribute binary files as well as to capture the procedure and
-source code used to produce those binary files. Before
-attempting to build any RPM from source, it is necessary to
-ensure that all required source and patches are in the @code{SOURCES}
-directory under the RPM root (probably @code{/usr/src/redhat} or
-@code{/usr/local/src/redhat}) on your machine. This procedure
-starts by installing the source RPMs as shown in the following
-example:
</font><font color='#000088'>+@example<span style="background-color: #FF0000"> </span>
+rpm -U @value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-binutils-<VERSION>-<RPM_RELEASE>.src.rpm
+@end example
</font>
@example
<font color='#880000'>-rpm -U @value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-gdb-@value{GDBVERSION}-@value{GDBRPMRELEASE}.src.rpm
</font><font color='#000088'>+cd <RPM_ROOT_DIRECTORY>/SPECS
+rpm -bb i386-rtems@value{RTEMSAPI}-binutils-<VERSION>.spec
</font> @end example
<font color='#880000'>-Because RTEMS tool RPMS are called "nosrc" to indicate that one or
-more source files required to produce the RPMs are not present.
-The RTEMS source GDB RPM does not include the large @code{.tar.gz} or
-@code{.tgz} files for GDB. This is shared by all RTEMS RPMs
-regardless of target CPU and there was no reason
-to duplicate them. You will have to get the required source
-archive files by hand and place them in the @code{SOURCES} directory
-before attempting to build. If you forget to do this, RPM is
-smart -- it will tell you what is missing. To determine what is
-included or referenced by a particular RPM, use a command like the
-following:
</font><font color='#000088'>+If the build completes successfully, RPMS like the following will be
+generated in a build-host architecture specific subdirectory of the RPMS
+directory under the RPM root directory.
</font>
@example
<font color='#880000'>-$ rpm -q -l -p @value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-gdb-@value{GDBVERSION}-@value{GDBRPMRELEASE}.src.rpm
-gdb-@value{GDBVERSION}-rtems@value{RTEMSAPI}-@value{GDBPATCHVERSION}.diff
-gdb-@value{GDBVERSION}.tar.gz
-i386-rtems@value{RTEMSAPI}-gdb-@value{GDBVERSION}.spec
</font><font color='#000088'>+@value{RTEMSRPMPREFIX}binutils-common-<VERSION>-<RPM_RELEASE>.<ARCH>.rpm
+@value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-binutils-<VERSION>-<RPM_RELEASE>.<ARCH>.rpm
</font> @end example
<font color='#880000'>-Notice that there is a patch file (the @code{.diff} file), a source archive
-file (the @code{.tar.gz}), and a file describing the build procedure and
-files produced (the @code{.spec} file). The @code{.spec} file is placed
-in the @code{SPECS} directory under the RPM root directory.
</font><font color='#000088'>+NOTE: It may be necessary to remove the build tree in the @code{BUILD}
+directory under the RPM root directory.
</font>
@c
<font color='#880000'>-@c Configuring and Building GDB using RPM
</font><font color='#000088'>+@c Building GCC and NEWLIB using RPM
</font> @c
<font color='#000088'>+@subsection Building GCC and NEWLIB using RPM
</font>
<font color='#880000'>-@subheading Configuring and Building GDB using RPM
-
-The following example illustrates the invocation of RPM to build a new,
-locally compiled, binutils binary RPM that matches the installed source
-RPM. This example assumes that all of the required source is installed.
</font><font color='#000088'>+This section illustrates the invocation of RPM to build a new,
+locally compiled, set of GCC and NEWLIB binary RPMs that match the
+installed source RPM. It is also necessary to install the BINUTILS
+RPMs and place them in your PATH. This example assumes that all of
+the required source is installed.
</font>
@example
cd <RPM_ROOT_DIRECTORY>/SPECS
<font color='#880000'>-rpm -bb i386-rtems@value{RTEMSAPI}-gdb-@value{GDBVERSION}.spec
</font><font color='#000088'>+rpm -bb i386-rtems@value{RTEMSAPI}-gcc-<VERSION>.spec
</font> @end example
<font color='#880000'>-If the build completes successfully, RPMS like the following will
</font><font color='#000088'>+If the build completes successfully, a set of RPMS like the following will
</font> be generated in a build-host architecture specific subdirectory
of the RPMS directory under the RPM root directory.
@example
<font color='#880000'>-@value{RTEMSRPMPREFIX}gdb-common-@value{GDBVERSION}-@value{GDBRPMRELEASE}.i386.rpm
-@value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-gdb-@value{GDBVERSION}-@value{GDBRPMRELEASE}.i386.rpm
</font><font color='#000088'>+@value{RTEMSRPMPREFIX}gcc-common-<VERSION>-<RPM>.<DIST>.noarch.rpm \
+@value{RTEMSRPMPREFIX}newlib-common-<VERSION>-<RPM>.<DIST>.noarch.rpm \
+@value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-gcc-<VERSION>-<RPM>.<ARCH>.rpm \
+@value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-newlib-<VERSION>-<RPM>.<ARCH>.rpm \
+@value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-libgcc-<VERSION>-<RPM>.<ARCH>.rpm \
+@value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-gcc-c++-<VERSION>-<RPM>.<ARCH>.rpm \
+@value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-libstd++-<VERSION>-<RPM>.<ARCH>.rpm
</font> @end example
<font color='#000088'>+NOTE: Some targets do not support building all languages.
+
</font> NOTE: It may be necessary to remove the build tree in the
@code{BUILD} directory under the RPM root directory.
@c
<font color='#880000'>-@c Using the GDB configure Script Directly
-@c<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+@c Building the GDB using RPM
+@c
+@subsection Building the GDB using RPM
</font>
<font color='#880000'>-@subsubsection Using the GDB configure Script Directly
</font><font color='#000088'>+The following example illustrates the invocation of RPM to build a new,
+locally compiled, binutils binary RPM that matches the installed source
+RPM. This example assumes that all of the required source is installed.
</font>
<font color='#880000'>-This section describes how to configure the GNU debugger for
-RTEMS targets using @code{configure} and @code{make} directly.
-The following example illustrates the invocation of @code{configure}
-and @code{make} to build and install @value{GDBUNTAR} for the
-m68k-rtems@value{RTEMSAPI} target:
</font>
@example
<font color='#880000'>-mkdir b-gdb
-cd b-gdb
-../@value{GDBUNTAR}/configure --target=m68k-rtems@value{RTEMSAPI} \
- --prefix=@value{RTEMSPREFIX}
-make all
-make info
-make install
</font><font color='#000088'>+rpm -U @value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-gdb-<VERSION>-<RPM_RELEASE>.src.rpm
</font> @end example
<font color='#880000'>-For some configurations, it is necessary to specify extra options
-to @code{configure} to enable and configure option components
-such as a processor simulator. The following is a list of
-configurations for which there are extra options:
-
-@table @b
-@item powerpc-rtems@value{RTEMSAPI}
-@code{--enable-sim --enable-sim-powerpc --enable-sim-timebase --enable-sim-hardware}
-
-@item sparc-rtems@value{RTEMSAPI}
-@code{--enable-sim}
</font><font color='#000088'>+@example
+cd <RPM_ROOT_DIRECTORY>/SPECS
+rpm -bb i386-rtems@value{RTEMSAPI}-gdb-<VERSION>.spec
+@end example
</font>
<font color='#880000'>-@end table
</font><font color='#000088'>+If the build completes successfully, RPMS like the following will
+be generated in a build-host architecture specific subdirectory
+of the RPMS directory under the RPM root directory.
</font>
<font color='#880000'>-After @value{GDBUNTAR} is built and installed the
-build directory @code{b-gdb} may be removed.
</font><font color='#000088'>+@example
+@value{RTEMSRPMPREFIX}gdb-common-<VERSION>-<RPM_RELEASE>.<ARCH>.rpm
+@value{RTEMSRPMPREFIX}i386-rtems@value{RTEMSAPI}-gdb-<VERSION>-<RPM_RELEASE>.<ARCH>.rpm
+@end example
</font>
<font color='#880000'>-For more information on the invocation of @code{configure}, please
-refer to the documentation for @value{GDBUNTAR} or
-invoke the @value{GDBUNTAR} @code{configure} command with the
-@code{--help} option.
</font><font color='#000088'>+NOTE: It may be necessary to remove the build tree in the
+@code{BUILD} directory under the RPM root directory.
</font>
@c
@c Common Problems
<font color='#997700'>@@ -932,7 +790,7 @@
</font> does this for the binutils source:
@example
<font color='#880000'>-find @value{BINUTILSUNTAR} -name config.status -print
</font><font color='#000088'>+find binutils-<VERSION> -name config.status -print
</font> @end example
The solution for this is to execute the command<span style="background-color: #FF0000"> </span>
<font color='#997700'>@@ -949,7 +807,7 @@
</font> this:
@example
<font color='#880000'>--I../../@value{BINUTILSUNTAR}/gcc -I/@value{BINUTILSUNTAR}/gcc/include -I.
</font><font color='#000088'>+-I../../binutils-<VERSION>/gcc -I/binutils-<VERSION>/gcc/include -I.
</font> @end example
Note that the tool source directory is searched before the<span style="background-color: #FF0000"> </span>
<font color='#006600'>diff -u rtems/doc/started/buildrt.t:1.21 rtems/doc/started/buildrt.t:1.21.6.1
--- rtems/doc/started/buildrt.t:1.21 Fri Sep 2 11:25:51 2005
+++ rtems/doc/started/buildrt.t Thu Dec 16 14:54:34 2010
</font><font color='#997700'>@@ -1,6 +1,5 @@
</font> @c
<font color='#880000'>-@c
-@c COPYRIGHT (c) 1988-2002.
</font><font color='#000088'>+@c COPYRIGHT (c) 1988-2010.
</font> @c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
<font color='#997700'>@@ -11,25 +10,23 @@
</font>
@section Obtain the RTEMS Source Code
<font color='#880000'>-This section provides pointers to the RTEMS source code and
-Hello World example program. These files should be
-placed in your @code{archive} directory.<span style="background-color: #FF0000"> </span>
-
-@subheading @value{RTEMSVERSION}
-@example
- FTP Site: @value{RTEMSFTPSITE}
- Directory: @value{RTEMSFTPDIR}/@value{VERSION}
- File: @value{RTEMSTAR}
- URL: @uref{ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/@value{VERSION}/@value{RTEMSTAR},,ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/@value{VERSION}/@value{RTEMSTAR}}
-@end example
</font><font color='#000088'>+This section provides pointers to the RTEMS source code and example
+programs. These files should be placed in your @code{archive} directory.
+The set of tarballs which comprise an RTEMS release is placed in a
+directory whose name if the release on the ftp site. The RTEMS ftp site
+is accessible via both the ftp and http protocols at the following URLs:
+<span style="background-color: #FF0000"> </span>
+@itemize @bullet
+@item @uref{http://www.rtems.org/ftp/pub/rtems,http://www.rtems.org/ftp/pub/rtems}
+@item @uref{ftp://www.rtems.org/pub/rtems,ftp://www.rtems.org/pub/rtems}
+@end itemize
</font>
<font color='#880000'>-@subheading RTEMS Examples including Hello World
-@example
- FTP Site: @value{RTEMSFTPSITE}
- Directory: @value{RTEMSFTPDIR}/@value{VERSION}
- File: examples-@value{VERSION}.tar.bz2
- URL: @uref{ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/@value{VERSION}/examples-@value{VERSION}.tar.bz2,,ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/@value{VERSION}/examples-@value{VERSION}.tar.bz2}
-@end example
</font><font color='#000088'>+Associated with each RTEMS Release is a set of example programs.
+Prior to the 4.10 Release Series, these examples were in a "Class
+Examples" and an "Examples" collection. Beginning with the 4.10 Release
+Series, these examples collections were merged and other examples added.
+This new collection is called "Examples V2". It is contained in the file
+@code{examples-v2-<VERSION>.tar.bz2>} within the RTEMS release directory.
</font>
@c
@c Unarchive the RTEMS Source
<font color='#997700'>@@ -42,28 +39,29 @@
</font>
@example
cd tools
<font color='#880000'>-tar xjf ../archive/@value{RTEMSTAR}
</font><font color='#000088'>+tar xjf ../archive/rtems-@value{RTEMSAPI}.<VERSION>.tar.bz2
</font> @end example
<font color='#880000'>-This creates the directory @value{RTEMSUNTAR}.
-
</font><font color='#000088'>+This creates the directory rtems-@value{RTEMSAPI}.<VERSION>
</font>
@section Add <INSTALL_POINT>/bin to Executable PATH
In order to compile RTEMS, you must have the cross compilation toolset
in your search path. It is important to have the RTEMS toolset first
in your path to ensure that you are using the intended version of all
<font color='#880000'>-tools. The following command prepends the directory
-where the tools were installed in a previous step:
</font><font color='#000088'>+tools. The following command prepends the directory where
+the tools were installed in a previous step. If you are using
+binaries provided by the RTEMS Project, the <INSTALL_POINT> will be
+@code{/opt/rtems-@value{RTEMSAPI}}
</font>
@example
export PATH=<INSTALL_POINT>/bin:$@{PATH@}
@end example
<font color='#880000'>-NOTE: The above command is in Bourne shell (@code{sh}) syntax and
-should work with the Korn (@code{ksh}) and GNU Bourne Again Shell
-(@code{bash}). It will not work with the C Shell (@code{csh}) or
-derivatives of the C Shell.
</font><font color='#000088'>+@b{NOTE:} The above command is in Bourne shell (@code{sh}) syntax and should
+work with the Korn (@code{ksh}) and GNU Bourne Again Shell (@code{bash}).
+It will not work with the C Shell (@code{csh}) or derivatives of the
+C Shell.
</font>
@section Verifying the Operation of the Cross Toolset
<font color='#997700'>@@ -83,14 +81,14 @@
</font> Then assemble the file using a command similar to the following:
@example
<font color='#880000'>-m68k-rtems-gcc -v -S f.c
</font><font color='#000088'>+m68k-rtems@value{RTEMSAPI}-gcc -v -S f.c
</font> @end example
<font color='#880000'>-Where @code{m68k-rtems-gcc} should be changed to match the installed
-name of your cross compiler. The result of this command will be
-a sequence of output showing where the cross-compiler searched for
-and found its subcomponents. Verify that these paths correspond
-to your <INSTALL_POINT>.
</font><font color='#000088'>+Where @code{m68k} should be changed to match the target architecture
+of your cross compiler. The result of this command will be a sequence
+of output showing where the cross-compiler searched for and found
+its subcomponents. Verify that these paths correspond to your
+<INSTALL_POINT>.
</font>
Look at the created file @code{f.s} and verify that it is in fact
for your target processor.
<font color='#997700'>@@ -99,17 +97,16 @@
</font> using a command like the following:
@example
<font color='#880000'>-m68k-rtems-gcc -v -c f.c
</font><font color='#000088'>+m68k-rtems@code{RTEMSAPI}-gcc -v -c f.c
</font> @end example
<font color='#880000'>-If this produces messages that indicate the assembly code is
-not valid, then it is likely that you have fallen victim to<span style="background-color: #FF0000"> </span>
-one of the problems described in
-@ref{Error Message Indicates Invalid Option to Assembler}
-Don't feel bad about this, one of the most common installation errors
-is for the cross-compiler not to be able to find the cross assembler
-and default to using the native @code{as}. This can result in very confusing
-error messages.
</font><font color='#000088'>+If this produces messages that indicate the assembly code is not valid,
+then it is likely that you have fallen victim to one of the problems
+described in @ref{Error Message Indicates Invalid Option to Assembler}
+Please do not feel bad about this and do not give up, one of the most
+common installation errors is for the cross-compiler not to be able
+to find the cross assembler and default to using the native @code{as}.
+This can result in very confusing error messages.
</font>
@section Building RTEMS for a Specific Target and BSP
<font color='#997700'>@@ -130,19 +127,20 @@
</font> @subsection Using the RTEMS configure Script Directly
Make a build directory under tools and build the RTEMS product in this
<font color='#880000'>-directory. The @code{../@value{RTEMSUNTAR}/configure}
-command has numerous command line
-arguments. These arguments are discussed in detail in documentation that
-comes with the RTEMS distribution. A full list of these arguments can be
-obtained by running @code{../@value{RTEMSUNTAR}/configure --help}
-If you followed the procedure
-described in the section @ref{Unarchive the RTEMS Source}, these
-configuration options can be found in the file
-tools/@value{RTEMSUNTAR}/README.configure.
</font><font color='#000088'>+directory. The @code{../rtems-@value{RTEMSAPI}.<VERSION>/configure}
+command has numerous command line arguments. These arguments are
+discussed in detail in documentation that comes with the RTEMS
+distribution. A full list of these arguments can be obtained by running
+@code{../rtems-@value{RTEMSAPI}.<VERSION>/configure --help} If you
+followed the procedure described in the section @ref{Unarchive the
+RTEMS Source}, these configuration options can be found in the file
+tools/rtems-@value{RTEMSAPI}.<VERSION>/README.configure.
</font>
@b{NOTE}: The GNAT/RTEMS run-time implementation is based on the POSIX
<font color='#880000'>-API. Thus the RTEMS configuration for a GNAT/RTEMS environment MUST
-include the @code{--enable-posix} flag.
</font><font color='#000088'>+API and the GNAT/RTEMS run-time cannot be compiled with networking
+disabled. Your application does not have to use networking but it must
+be enabled. Thus the RTEMS configuration for a GNAT/RTEMS environment
+MUST include the @code{--enable-posix --enable-networking} flag.
</font>
The following shows the command sequence required to configure,
compile, and install RTEMS with the POSIX API, FreeBSD TCP/IP,
<font color='#997700'>@@ -152,26 +150,26 @@
</font> @example
mkdir build-rtems
cd build-rtems
<font color='#880000'>-../@value{RTEMSUNTAR}/configure --target=<TARGET_CONFIGURATION> \
</font><font color='#000088'>+../rtems-@value{RTEMSAPI}.VERSION/configure --target=<TARGET_CONFIGURATION> \
</font> --disable-posix --disable-networking --disable-cxx \
<font color='#880000'>- --enable-rtemsbsp=<BOARD_SUPPORT_PACKAGE>\
</font><font color='#000088'>+ --enable-rtemsbsp=<BSP>\
</font> --prefix=<INSTALL_POINT>
make all install
@end example
<font color='#880000'>-Where the list of currently supported <TARGET_CONFIGURATION>'s and
-<BOARD_SUPPORT_PACKAGE>'s can be found in
-tools/@value{RTEMSUNTAR}/README.configure.
-
-<INSTALL_POINT> is typically the installation point for the<span style="background-color: #FF0000"> </span>
-tools and defaults to @code{@value{RTEMSPREFIX}}.
-
-BSP is a supported BSP for the selected CPU family. The list of
-supported BSPs may be found in the file
-tools/@value{RTEMSUNTAR}/README.configure
-in the RTEMS source tree. If the BSP parameter is not specified,
-then all supported BSPs for the selected CPU family will be built.
</font><font color='#000088'>+<TARGET> is of the form <CPU>-rtems@value{RTEMSAPI} and the list of
+currently supported <TARGET> configuration's and <BSP>'s can be found in
+@code{tools/RTEMS-@value{RTEMSAPI}.<VERSION>/README.configure}.
+
+<INSTALL_POINT> is typically the installation point for the tools and
+defaults to @code{/opt/rtems-@value{RTEMSAPI}}.
+
+BSP is a supported BSP for the selected CPU family.
+The list of supported BSPs may be found in the file
+@code{tools/rtems-@value{RTEMSAPI}.<VERSION>/README.configure} in the
+RTEMS source tree. If the BSP parameter is not specified, then all
+supported BSPs for the selected CPU family will be built.
</font>
<font color='#880000'>-@b{NOTE:} The POSIX API must be enabled to use GNAT/RTEMS.
</font><font color='#000088'>+@b{NOTE:} The POSIX API and networking must be enabled to use GNAT/RTEMS.
</font>
@b{NOTE:} The @code{make} utility used should be GNU make.
<font color='#006600'>diff -u rtems/doc/started/intro.t:1.15 rtems/doc/started/intro.t:1.15.6.1
--- rtems/doc/started/intro.t:1.15 Tue Feb 3 18:34:09 2004
+++ rtems/doc/started/intro.t Thu Dec 16 14:54:34 2010
</font><font color='#997700'>@@ -1,5 +1,5 @@
</font> @c
<font color='#880000'>-@c COPYRIGHT (c) 1988-2002.
</font><font color='#000088'>+@c COPYRIGHT (c) 1988-2010.
</font> @c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
<font color='#997700'>@@ -18,7 +18,7 @@
</font> @itemize @bullet
@item GNU Cross Compilation Tools for RTEMS on your build-host system
@item RTEMS OS for the target
<font color='#880000'>-@item GDB Debugger
</font><font color='#000088'>+@item GNU Debugger (GDB)
</font> @end itemize
The remainder of this chapter provides background information on real-time
<font color='#997700'>@@ -159,31 +159,17 @@
</font>
@uref{mailto:@value{RTEMSUSERS},@value{RTEMSUSERS}}
<font color='#880000'>-This mailing list is dedicated to the discussion of issues related
-to RTEMS, including GNAT/RTEMS. If you have questions about RTEMS,
-wish to make suggestions, or just want to pick up hints, this is a<span style="background-color: #FF0000"> </span>
-good list to monitor. Subscribe by sending an empty mail message to<span style="background-color: #FF0000"> </span>
-@uref{mailto:@value{RTEMSUSERSSUBSCRIBE},@value{RTEMSUSERSSUBSCRIBE}}.<span style="background-color: #FF0000"> </span>
-Messages sent to @uref{mailto:@value{RTEMSUSERS},@value{RTEMSUSERS}}
-are posted to the list.
-
-@subsection CrossGCC Mailing List
-
-@uref{mailto:crossgcc@@sources.redhat.com,crossgcc@@sources.redhat.com}
-
-This mailing list is dedicated to the use of the GNU tools in
-cross development environments. Most of the discussions
-focus on embedded issues. Information on subscribing
-to this mailing list is included in the<span style="background-color: #FF0000"> </span>
-@uref{http://www.objsw.com/CrossGCC/,CrossGCC FAQ}.
-
-The CrossGCC FAQ and Wiki are are available
-at @uref{http://www.billgatliff.com,http://www.billgatliff.com}.
</font><font color='#000088'>+This is the primary mailing list for the discussion of issues
+related to RTEMS, including GNAT/RTEMS. If you have questions
+about RTEMS, wish to make suggestions, track development efforts,
+or just want to pick up hints, this is a good list to monitor.
+If you would like to browse the thousands of messages in the fifteen
+year archive of the mailing list or subscribe to it, please visit
+@uref{http://www.rtems.org/mailman,http://www.rtems.org/mailman} for
+more information,
</font>
@subsection GCC Mailing Lists
<font color='#880000'>-
</font> The GCC Project is hosted at @uref{http://gcc.gnu.org,http://gcc.gnu.org}.
They maintain multiple mailing lists that are described at the web site
along with subscription information.
<font color='#880000'>-
</font>
<font color='#006600'>diff -u rtems/doc/started/nextstep.t:1.7 rtems/doc/started/nextstep.t:1.7.6.1
--- rtems/doc/started/nextstep.t:1.7 Thu Oct 2 13:01:48 2003
+++ rtems/doc/started/nextstep.t Thu Dec 16 14:54:34 2010
</font><font color='#997700'>@@ -1,6 +1,5 @@
</font> @c
<font color='#880000'>-@c
-@c COPYRIGHT (c) 1988-2002.
</font><font color='#000088'>+@c COPYRIGHT (c) 1988-2010.
</font> @c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
<font color='#997700'>@@ -9,77 +8,70 @@
</font>
@chapter Where To Go From Here
<font color='#880000'>-At this point, you should have successfully installed a
-GNU Cross Compilation Tools for RTEMS on your host system
-as well as the RTEMS OS for the target host. You should
-have successfully linked the "hello world" program. You
-may even have downloaded the executable to that target
-and run it. What do you do next?
-
-The answer is that it depends. You may be interested in
-writing an application that uses one of the multiple
-APIs supported by RTEMS. You may need to investigate the
-network or filesystem support in RTEMS. The common
-thread is that you are largely finished with this
-manual and ready to move on to others.
-
-Whether or not you decide to dive in now and write
-application code or read some documentation first,
-this chapter is for you. The first section provides
-a quick roadmap of some of the RTEMS documentation.
-The next section provides a brief overview of the
-RTEMS application structure.
</font><font color='#000088'>+At this point, you should have successfully installed a GNU Cross
+Compilation Tools for RTEMS on your host system as well as the RTEMS OS
+for the target host. You should have successfully linked the "hello
+world" program. You may even have downloaded the executable to that
+target and run it. What do you do next?
+
+The answer is that it depends. You may be interested in writing an
+application that uses one of the multiple APIs supported by RTEMS.
+You may need to investigate the network or filesystem support in RTEMS.
+The common thread is that you are largely finished with this manual and
+ready to move on to others.
+
+Whether or not you decide to dive in now and write application code or
+read some documentation first, this chapter is for you. The first section
+provides a quick roadmap of some of the RTEMS documentation. The next
+section provides a brief overview of the RTEMS application structure.
</font>
@section Documentation Overview
<font color='#880000'>-When writing RTEMS applications, you should find the
-following manuals useful because they define the
-calling interface to many of the services provided
-by RTEMS:
</font><font color='#000088'>+When writing RTEMS applications, you should find the following manuals
+useful because they define the calling interface to many of the services
+provided by RTEMS:
</font>
@itemize @bullet
@item @b{RTEMS Applications C User's Guide} describes the
Classic RTEMS API based on the RTEID specification.
<font color='#880000'>-@item @b{RTEMS POSIX API User's Guide} describes the<span style="background-color: #FF0000"> </span>
-RTEMS POSIX API that is based on the POSIX 1003.1b API.
-
-@item @b{RTEMS ITRON 3.0 API User's Guide} describes
-the RTEMS implementation of the ITRON 3.0 API.
-
-@item @b{RTEMS Network Supplement} provides information
-on the network services provided by RTEMS.
</font><font color='#000088'>+@item @b{RTEMS POSIX API User's Guide} describes the RTEMS POSIX API
+that is based on the POSIX 1003.1b API. If there is any place where
+this manual is thin or unclear, please refer to the OpenGroup Single
+UNIX Specification. RETEMS tracks that specification for future POSIX
+revisions.
+
+@item @b{RTEMS Network Supplement} provides information on the network
+services provided by RTEMS. RTEMS provides a BSD sockets programming
+interface so any network programming book should be helpful.
</font>
@end itemize
<font color='#880000'>-In addition, the following manuals from the GNU Cross
-Compilation Toolset include information on run-time services
-available.
</font><font color='#000088'>+In addition, the following manuals from the GNU Cross Compilation Toolset
+include information on run-time services available.
</font>
@itemize @bullet
<font color='#880000'>-@item @b{Cygnus C Support Library} describes the Standard
-C Library functionality provided by Newlib's libc.
</font><font color='#000088'>+@item @b{Cygnus C Support Library} describes the Standard C Library
+functionality provided by Newlib's libc.
</font>
<font color='#880000'>-@item @b{Cygnus C Math Library} describes the Standard
-C Math Library functionality provided by Newlib's libm.
</font><font color='#000088'>+@item @b{Cygnus C Math Library} describes the Standard C Math Library
+functionality provided by Newlib's libm.
</font>
@end itemize
<font color='#880000'>-Finally, the RTEMS FAQ and mailing list archives are available<span style="background-color: #FF0000"> </span>
-at @uref{@value{RTEMSHTTPURL}}.
</font><font color='#000088'>+Finally, the RTEMS FAQ, Wiki, and mailing list archives are available<span style="background-color: #FF0000"> </span>
+at @uref{http://www.rtems.org, http://www.rtems.org}.
</font>
<font color='#880000'>-There is a wealth of documentation available for RTEMS and
-the GNU tools supporting it. If you run into something
-that is not clear or missing, bring it to our attention.
-
-Also, some of the RTEMS documentation is still under
-construction. If you would like to contribute to this
-effort, please contact the RTEMS Team at
-@uref{mailto:@value{RTEMSUSERS}, @value{RTEMSUSERS}}.
-If you are interested in sponsoring the development of a new
-feature, BSP, device driver, port of an existing library, etc.,
-please contact one of the RTEMS Service Providers listed
-at @uref{@value{RTEMSHTTPURL}/support.html,@value{RTEMSHTTPURL}/support.html}.
</font><font color='#000088'>+There is a wealth of documentation available for RTEMS and the GNU tools
+supporting it. If you run into something that is not clear or missing,
+bring it to our attention.
+
+Also, some of the RTEMS documentation is still under construction.
+If you would like to contribute to this effort, please contact the
+RTEMS Team at @uref{mailto:@value{RTEMSUSERS}, @value{RTEMSUSERS}}.
+If you are interested in sponsoring the development of a new feature,
+BSP, device driver, port of an existing library, etc., please contact
+@uref{mailto:sales@@oarcorp.com, sales@@oarcorp.com}.
</font>
@section Writing an Application
<font color='#997700'>@@ -89,36 +81,30 @@
</font> environment. However there are two important things that are
different from a standard UNIX hosted program.
<font color='#880000'>-First, the application developer must provide configuration
-information for RTEMS. This configuration information
-includes limits on the maximum number of various OS resources
-available and networking configuration among other things.
-See the @b{Configuring a System} in the
-@b{RTEMS Applications C User's Guide} for more details.
-
-Second, RTEMS applications may or may not start at
-@code{main()}. Applications begin execution at
-one or more user configurable application
-initialization tasks or threads. It is possible
-to configure an application to start with a<span style="background-color: #FF0000"> </span>
-single thread that whose entry point is @code{main()}.
-
-Each API supported by RTEMS (Classic, POSIX, and ITRON)
-allows the user to configure a set of one or more tasks
-that are created and started automatically
-during RTEMS initialization. The RTEMS Automatic
-Configuration Generation (@code{confdefs.h}) scheme can be
-used to easily generate the configuration information for
-an application that starts with a single initialization task.<span style="background-color: #FF0000"> </span>
-By convention, unless overridden, the default name of the
-initialization task varies based up API.
</font><font color='#000088'>+First, the application developer must provide configuration information
+for RTEMS. This configuration information includes limits on the maximum
+number of various OS resources available and networking configuration
+among other things. See the @b{Configuring a System} in the @b{RTEMS
+Applications C User's Guide} for more details.
+
+Second, RTEMS applications may or may not start at @code{main()}.
+Applications begin execution at one or more user configurable application
+initialization tasks or threads. It is possible to configure an
+application to start with a single thread that whose entry point is
+@code{main()}.
+
+Each API supported by RTEMS (Internal, Classic, and POSIX) allows
+the user to configure a set of one or more tasks that are created and
+started automatically during RTEMS initialization. The RTEMS Automatic
+Configuration Generation (@code{confdefs.h}) scheme can be used to easily
+generate the configuration information for an application that starts
+with a single initialization task. By convention, unless overridden,
+the default name of the initialization task varies based up API.
</font>
@itemize @bullet
@item @code{Init} - single Classic API Initialization Task
@item @code{POSIX_Init} - single POSIX API Initialization Thread
<font color='#880000'>-
-@item @code{ITRON_Init} - single ITRON API Initialization Task
</font> @end itemize
Regardless of the API used, when the initialization task executes,
<font color='#997700'>@@ -134,17 +120,15 @@
</font> not required, in most of the examples, the initialization task
completes by deleting itself.
<font color='#880000'>-As you begin to write RTEMS application code, you may be confused
-by the range of alternatives. Supporting multiple tasking
-APIs can make the choices confusing. Many application groups
-writing new code choose one of the APIs as their primary API
-and only use services from the others if nothing comparable
-is in their preferred one. However, the support for multiple
-APIs is a powerful feature when integrating code from multiple
-sources. You can write new code using POSIX services and
-still use services written in terms of the other APIs.
-Moreover, by adding support for yet another API, one could
-provide the infrastructure required to migrate from a
-legacy RTOS with a non-standard API to an API like POSIX.
</font><font color='#000088'>+As you begin to write RTEMS application code, you may be confused by the
+range of alternatives. Supporting multiple tasking APIs can make the
+choices confusing. Many application groups writing new code choose one
+of the APIs as their primary API and only use services from the others if
+nothing comparable is in their preferred one. However, the support for
+multiple APIs is a powerful feature when integrating code from multiple
+sources. You can write new code using POSIX services and still use
+services written in terms of the other APIs. Moreover, by adding support
+for yet another API, one could provide the infrastructure required to
+migrate from a legacy RTOS with a non-standard API to an API like POSIX.
</font>
<font color='#006600'>diff -u rtems/doc/started/nt.t:1.20 rtems/doc/started/nt.t:1.20.6.1
--- rtems/doc/started/nt.t:1.20 Fri Sep 26 16:19:52 2003
+++ rtems/doc/started/nt.t Thu Dec 16 14:54:34 2010
</font><font color='#997700'>@@ -1,5 +1,5 @@
</font> @c
<font color='#880000'>-@c COPYRIGHT (c) 1988-2002.
</font><font color='#000088'>+@c COPYRIGHT (c) 1988-2010.
</font> @c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
<font color='#997700'>@@ -15,31 +15,24 @@
</font> @uref{mailto:g_montel@@yahoo.com, Geoffroy Montel <g_montel@@yahoo.com>}<span style="background-color: #FF0000"> </span>
with input from<span style="background-color: #FF0000"> </span>
@uref{mailto:<D.J@@fiddes.surfaid.org>, David Fiddes <D.J@@fiddes.surfaid.org>}.
<font color='#880000'>-It was based upon his successful but unnecessarily
-painful efforts with Cygwin beta versions.
-Cygwin and this chapter have been updated multiple times since
-those early days although their pioneering efforts
-and input is still greatly appreciated.
</font><font color='#000088'>+It was based upon his successful but unnecessarily painful efforts with
+Cygwin beta versions. Cygwin and this chapter have been updated multiple
+times since those early days although their pioneering efforts and input
+is still greatly appreciated.
</font>
@section Microsoft Windows Version Requirements
<font color='#880000'>-RTEMS users report fewer problems when using Microsoft
-Windows NT, 2000, or XP. Although, the open source tools
-that are used in RTEMS development do execute on Windows 95,
-98, or ME, they tend to be more stable when used with
-the modern Windows variants.
</font><font color='#000088'>+RTEMS users report fewer problems when using Microsoft Windows XP or newer.
</font>
@section Cygwin<span style="background-color: #FF0000"> </span>
<font color='#880000'>-For RTEMS development, the recommended approach is to use
-Cygwin 1.0 or later. Cygwin is available from
-@uref{http://sources.redhat.com/cygwin, http://sources.redhat.com/cygwin}<span style="background-color: #FF0000"> </span>
-Recent versions of Cygwin are vastly improved over the beta
-versions. Most of the oddities, instabilities, and performance
-problems have been resolved. The installation procedure
-is much simpler. However, there are a handful of issues
-that remain to successfully use Cygwin as an RTEMS development
-environment.
</font><font color='#000088'>+For RTEMS development, the recommended approach is to use Cygwin. Cygwin
+is available from @uref{http://www.cygwin.com, http://www.cygwin.com} .
+The primary issues reported by users of Cygwin is that it is slower
+on the same hardware than a native GNU/Linux installation and strange
+issues over carriage return/line feed inconsistencies between UNIX and
+Windows environments. However, there are a handful of other issues that
+may turn up when using Cygwin as an RTEMS development environment.
</font>
@itemize @bullet
<font color='#997700'>@@ -79,18 +72,17 @@
</font> filesystem (e.g. mounted with the @code{-b} option). Otherwise,
many confusing errors will result.<span style="background-color: #FF0000"> </span>
<font color='#880000'>-@item A user has reported that they needed<span style="background-color: #FF0000"> </span>
-to set CYGWIN=ntsec for chmod to work correctly, but had to set<span style="background-color: #FF0000"> </span>
-CYGWIN=nontsec for compile to work properly (otherwise there were
-complaints about permissions on a temporary file).
</font><font color='#000088'>+@item A user has reported that they needed to set @code{CYGWIN=ntsec}
+for chmod to work correctly, but had to set @code{CYGWIN=nontsec}
+for compile to work properly (otherwise there were complaints about
+permissions on a temporary file).
</font>
@item If you want to build the tools from source, you have the<span style="background-color: #FF0000"> </span>
same options as UNIX users.
<font color='#880000'>-@item You may have to uncompress archives during this
-process. You must @b{NOT} use @code{WinZip} or
-@code{PKZip}. Instead the un-archiving process uses
-the GNU @code{zip} and @code{tar} programs as shown below:
</font><font color='#000088'>+@item You may have to uncompress archives during this process. You must
+@b{NOT} use @code{WinZip} or @code{PKZip}. Instead the un-archiving
+process uses the GNU @code{zip} and @code{tar} programs as shown below:
</font>
@example
tar -xzvf archive.tgz<span style="background-color: #FF0000"> </span>
<font color='#997700'>@@ -102,20 +94,18 @@
</font>
@section Text Editor
<font color='#880000'>-You absolutely have to use a text editor which can<span style="background-color: #FF0000"> </span>
-save files with Unix format. So do @b{NOT} use Notepad<span style="background-color: #FF0000"> </span>
-or Wordpad! There are a number of editors
-freely available that can be used.<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+You absolutely have to use a text editor which can save files with Unix
+format. So do @b{NOT} use Notepad or Wordpad! There are a number of
+editors freely available that can be used.
</font>
@itemize @bullet
@item @b{VIM} (@b{Vi IMproved}) is available from
<font color='#880000'>-@uref{http://www.vim.org/,http://www.vim.org/}.<span style="background-color: #FF0000"> </span>
-This editor has the very handy ability to easily
-read and write files in either DOS or UNIX style.
</font><font color='#000088'>+@uref{http://www.vim.org/,http://www.vim.org/}. This editor has the very
+handy ability to easily read and write files in either DOS or UNIX style.
</font>
@item @b{GNU Emacs} is available for many platforms
<font color='#880000'>-including MS-Windows. The official homepage<span style="background-color: #FF0000"> </span>
-is @uref{http://www.gnu.org/software/emacs/emacs.html,
</font><font color='#000088'>+including MS-Windows. The official homepage is
+@uref{http://www.gnu.org/software/emacs/emacs.html,
</font> http://www.gnu.org/software/emacs/emacs.html}.
The GNU Emacs on Windows NT and Windows 95/98 FAQ is at
@uref{http://www.gnu.org/software/emacs/windows/ntemacs.html,
<font color='#997700'>@@ -123,11 +113,10 @@
</font>
@end itemize
<font color='#880000'>-If you do accidentally end up with files<span style="background-color: #FF0000"> </span>
-having MS-DOS style line termination, then you
-may have to convert them to Unix format for some
-Cygwin programs to operate on them properly. The<span style="background-color: #FF0000"> </span>
-program @code{dos2unix} can be used to put them
</font><font color='#000088'>+If you do accidentally end up with files having MS-DOS style line
+termination, then you may have to convert them to Unix format for some
+Cygwin programs to operate on them properly. The program @code{dos2unix}
+can be used to put them
</font> back into Unix format as shown below:
@example
<font color='#997700'>@@ -137,22 +126,16 @@
</font>
@section System Requirements
<font color='#880000'>-Although the finished cross-compiler is fairly easy on resources,
-building it can take a significant amount of processing power and<span style="background-color: #FF0000"> </span>
-disk space.<span style="background-color: #FF0000"> </span>
-
-@itemize @bullet
-
-@item The faster the CPU, the better. The tools and Cygwin can be
-@b{very} CPU hungry.
-
-@item The more RAM, the better. Reports are that when building GCC
-and GDB, peak memory usage can exceed 256 megabytes.
-
-@item The more disk space, the better. You need more if you are building
-the GNU tools and the amount of disk space for binaries is obviously
-directly dependent upon the number of CPUs you have cross toolsets
-installed for.
-
-@end itemize
-
</font><font color='#000088'>+Although the finished cross-compiler is fairly easy on resources, building
+it can take a significant amount of processing power and disk space.
+Luckily, desktop computers have progressed very far since this guide
+was originally written so it is unlikely you will have any problems.
+Just do not use an old cast-off machine with < 1 GB RAM and a 1 Ghz CPU.
+Unless, of course, you enjoy waiting for things to complete.
+
+The more disk space, the better. You need more if you are building the
+GNU tools and the amount of disk space for binaries is obviously directly
+dependent upon the number of CPUs you have cross toolsets installed for.
+In addition to the disk space requirements documented earlier for tool
+building, you will also have to have enough space to install the Cygwin
+environment.
</font>
<font color='#006600'>diff -u rtems/doc/started/require.t:1.13 rtems/doc/started/require.t:1.13.6.1
--- rtems/doc/started/require.t:1.13 Tue Feb 3 18:34:09 2004
+++ rtems/doc/started/require.t Thu Dec 16 14:54:34 2010
</font><font color='#997700'>@@ -1,5 +1,5 @@
</font> @c
<font color='#880000'>-@c COPYRIGHT (c) 1988-2002.
</font><font color='#000088'>+@c COPYRIGHT (c) 1988-2010.
</font> @c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
<font color='#997700'>@@ -21,19 +21,18 @@
</font> +------------------------------------+--------------------------+
| Component | Disk Space Required |
+------------------------------------+--------------------------+
<font color='#880000'>-| archive directory | 55 Mbytes |
-| tools src unarchived | 350 Mbytes |
-| each individual build directory | up to 750 Mbytes |
-| each installation directory | 20-200 Mbytes |
</font><font color='#000088'>+| archive directory | 120 Mbytes |
+| tools src unarchived | 1400 Mbytes |
+| each individual build directory | up to 2500 Mbytes |
+| each installation directory | 900 Mbytes |
</font> +------------------------------------+--------------------------+
@end example
<font color='#880000'>-It is important to understand that the above requirements only address
-the GNU C/C++ Cross Compiler Tools themselves. Adding additional
-languages such as Fortran or Objective-C can increase the size
-of the build and installation directories. Also, the unarchived
-source and build directories can be removed after the tools are
-installed.
</font><font color='#000088'>+It is important to understand that the above requirements only address the
+GNU C/C++ Cross Compiler Tools themselves. Adding additional languages
+such as Ada or Go can increase the size of the build and installation
+directories. Also, the unarchived source and build directories can be
+removed after the tools are installed.
</font>
After the tools themselves are installed, RTEMS must be built
and installed for each Board Support Package that you wish
<font color='#997700'>@@ -46,8 +45,11 @@
</font> There are a number of factors which must be taken into
account in order to estimate the amount of disk space required
to build RTEMS itself. Attempting to build multiple BSPs in
<font color='#880000'>-a single step increases the disk space requirements. Similarly
-enabling optional features increases the build and install
</font><font color='#000088'>+a single step increases the disk space requirements. One some
+target architectures, this can lead to disk usage during the build
+of over one gigabyte.
+
+Similarly enabling optional features increases the build and install
</font> space requirements. In particular, enabling and building
the RTEMS tests results in a significant increase in build
space requirements but since the tests are not installed has,
<font color='#997700'>@@ -56,8 +58,9 @@
</font> @section General Host Software Requirements
The instructions in this manual should work on any computer running
<font color='#880000'>-a UNIX variant. Some native GNU tools are used by this procedure
-including:
</font><font color='#000088'>+a POSIX environment including GNU/Linux and Cygwin. Mingw users may
+encounter additional issues due to the limited POSIX compatibility.
+Some native GNU tools are used by this procedure including:
</font>
@itemize @bullet
@item GCC
<font color='#997700'>@@ -65,8 +68,10 @@
</font> @item GNU makeinfo
@end itemize
<font color='#880000'>-In addition, some native utilities may be deficient for building<span style="background-color: #FF0000"> </span>
-the GNU tools.
</font><font color='#000088'>+In addition, some native utilities may be deficient for building the
+GNU tools. On hosts which have m4 but it is not GNU m4, it is not
+uncommon to have to install GNU m4. Similarly, some shells are not
+capable of fully supporting the RTEMS configure scripts.
</font>
@subsection GCC
<font color='#997700'>@@ -129,9 +134,10 @@
</font>
@end itemize
<font color='#880000'>-@subsection Linux
</font><font color='#000088'>+@subsection Distribution Independent Potential GNU/Linux Issues
</font>
<font color='#880000'>-The following problems have been reported by Linux users:
</font><font color='#000088'>+The following problems have been reported by users of various GNU/Linux
+distributions:
</font>
@itemize @bullet
<font color='#997700'>@@ -149,71 +155,10 @@
</font>
@end itemize
<font color='#880000'>-@section Archive and Build Directories
-
-If you are using RPM or another packaging format that supports
-building a package from source, then there is probably a directory
-structure assumed by that packaging format. Otherwise, you
-are free to use whatever organization you like. However, this
-document will use the directory organization described
-in @ref{Archive and Build Directory Format}.
-
-@subsection RPM Archive and Build Directory Format
-
-For RPM, it is assumed that the following subdirectories
-are under a root directory such as @code{/usr/src/redhat}:
-
-@example
-BUILD
-RPMS
-SOURCES
-SPECS
-SRPMS
-@end example
-
-For the purposes of this document, the RPM @code{SOURCES} directory
-is the directory into which all tool source and patches are
-assumed to reside. The @code{BUILD} directory is where the actual
-build is performed when building binaries from a source RPM.
-The @code{SOURCES} and @code{BUILD} are logically equivalent to
-the @code{archive} and @code{tools} directory discussed in the<span style="background-color: #FF0000"> </span>
-next section.
-
-@subsection Archive and Build Directory Format
-
-When no packaging format requirements are present, the root directory for
-the storage of source archives and patches as well as for building the
-tools is up to the user. The only concern is that there be enough
-disk space to complete the build. In this document, the following
-organization will be used.
-
-Make an @code{archive} directory to contain the downloaded
-source code and a @code{tools} directory to be used as a build
-directory. The command sequence to do this is shown
-below:
-
-@example
-mkdir archive
-mkdir tools
-@end example
-
-This will result in an initial directory structure similar to the
-one shown in the following figure:
-
-@example
-@group
-/whatever/prefix/you/choose/
- archive/
- tools/
-
-@end group
-@end example
</font><font color='#000088'>+@subsection GNU/Linux Distrobutions using Debian Packaging Format<span style="background-color: #FF0000"> </span>
</font>
<font color='#880000'>-@c @ifset use-html
-@c @html
-@c <IMG SRC="sfile12c.jpg" WIDTH=417 HEIGHT=178
-@c ALT="Starting Directory Organization">
-@c @end html
-@c @end ifset
</font><font color='#000088'>+The RTEMS Project does not currently provide prebuilt toolsets in the Debian packaging format used by the Debian and Ubuntu distributions. If you are using a distribution using this packaging format, then you have two options for installing the RTEMS toolset.
</font>
<font color='#000088'>+The first option is to build the toolset from source following the instructions in the @ref{Building the GNU Cross Compiler Toolset}. This is an approach taken by many users.
</font>
<font color='#000088'>+Alternatively, it is often possible to extract the contents of the RPM files which contain the portions of the toolset you require. In this case, you will follow the instructions in @ref{Locating the RPMs for your GNU/Linux Distribution} but assume your distribution is the RedHat Enterprise Linux version which is closest to yours from a shared library perspective. As of December 2010, this is usually RedHat Enterprise Linux version 5. As time passes, it is expected that version 6 will be appropriate in more cases. You will extract the contents of these RPM files using either @code{rpm2cpio} and install them or you may be able to use the @code{alien} tool to convert them to Debian packaging.
</font>
<font color='#006600'>diff -u rtems/doc/started/sample.t:1.15 rtems/doc/started/sample.t:1.15.6.1
--- rtems/doc/started/sample.t:1.15 Mon Sep 27 17:28:16 2004
+++ rtems/doc/started/sample.t Thu Dec 16 14:54:34 2010
</font><font color='#997700'>@@ -1,5 +1,5 @@
</font> @c
<font color='#880000'>-@c COPYRIGHT (c) 1988-2002.
</font><font color='#000088'>+@c COPYRIGHT (c) 1988-2010.
</font> @c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
<font color='#997700'>@@ -52,7 +52,7 @@
</font> on the board you are using. The following is a list of
commonly used BSPs classified by their RTEMS CPU family and pointers
to instructions on how to use them. [NOTE: All file names should be
<font color='#880000'>-prepended with @value{RTEMSUNTAR}/c/src/lib/libbsp.]
</font><font color='#000088'>+prepended with @code{rtems-@value{RTEMSAPI}.<VERSION>/c/src/lib/libbsp}.]
</font>
@need 1000
@table @b
<font color='#997700'>@@ -147,31 +147,11 @@
</font>
@example
cd tools
<font color='#880000'>-tar xjf ../archive/examples-VERSION.tgz
</font><font color='#000088'>+tar xjf ../archive/examples-v2-@value{RTEMSAPI}.<VERSION>.tgz
</font> @end example
<font color='#880000'>-The sample applications most likely to be of interest to you are:
-
-@itemize @bullet
-@item hello_world_c - C Hello World application with a simple
-RTEMS configuration and an entry point not called @code{main()}.
-
-@item simple_main - Very simple program starting at @code{main()}
-and shutting down RTEMS via @code{exit()} without any other operations.
-It uses the default configuration inside RTEMS which is only
-intended to satisfy @code{autoconf} probes and extremely simple
-console-based applications.
-
-@item libcpp - Simple C++ library for RTEMS showing how to build an
-application library written in C++.
-
-@item psx_sched_report - POSIX Scheduler Reporter is a program
-that prints out some scheduler attributes of the RTEMS POSIX API.
-
-@end itemize
-
-Each tests is found in a separate subdirectory and built using the
-same command sequence. The @code{hello_world_c} sample will be used
</font><font color='#000088'>+Each tests is found in a separate subdirectory and built using the same
+command sequence. The @code{hello/hello_world_c} sample will be used
</font> as an example.
@c
<font color='#997700'>@@ -192,25 +172,24 @@
</font> executable is placed in the following directory:<span style="background-color: #FF0000"> </span>
@example
<font color='#880000'>-hello_world_c/o-optimize/<filename>.exe
</font><font color='#000088'>+hello_world_c/o-optimize/<filename>.ralf
</font> @end example
<font color='#880000'>-The other C/C++ sample applications are built using a similar procedure.
</font><font color='#000088'>+The other sample applications are built using a similar procedure.
</font>
@c
@c Ada Sample Applications
@c
@section Ada Sample Applications
<font color='#880000'>-The Ada sample application set primarily includes a
-a simple Hello World Ada program which can be used
-as a starting point for GNAT/RTEMS applications.
-Use the following command to unarchive the Ada sample
</font><font color='#000088'>+The Ada sample application set primarily includes a a simple Hello
+World Ada program which can be used as a starting point for GNAT/RTEMS
+applications. Use the following command to unarchive the Ada sample
</font> applications:
@example
cd tools
<font color='#880000'>-tar xjf ../archive/ada-examples-@value{VERSION}.tar.bz2
</font><font color='#000088'>+tar xjf ../archive/ada-examples-@value{RTEMSAPI}.<VERSION>.tgz
</font> @end example
@subheading Create a BSP Specific Makefile
<font color='#997700'>@@ -219,11 +198,7 @@
</font> is a bit more difficult than a C or C++ application. This is certainly
an opportunity for a volunteer project.
<font color='#880000'>-At this time, there is a<span style="background-color: #FF0000"> </span>
-
-Provided are example Makefiles for multiple BSPs. Copy one of these to
-the file Makefile.<BOARD_SUPPORT_PACKAGE> and edit it as appropriate for
-your local configuration.
</font><font color='#000088'>+If your BSP requires special arguments when linking, you may have to augment the file @code{ada-examples-@value{RTEMSAPI}.<VERSION>/Makefile.shared}. Most RTEMS BSPs do not require special linking arguments so this should not be frequently needed.
</font>
Use the <INSTALLATION_POINT> and <BOARD_SUPPORT_PACKAGE> specified when
configuring and installing RTEMS.
<font color='#997700'>@@ -233,18 +208,13 @@
</font> Use the following command to start the build of the sample application:<span style="background-color: #FF0000"> </span>
@example
<font color='#880000'>-cd tools/hello_world_ada
-make -f Makefile.<BOARD_SUPPORT_PACKAGE>
</font><font color='#000088'>+cd tools/ada-examples-@value{RTEMSAPI}.<VERSION>/ada-examples/hello_world_ada
</font> @end example
<font color='#880000'>-NOTE: GNU make is the preferred @code{make} utility. Other @code{make}
-implementations may work but all testing is done with GNU make.
-
-If the BSP specific modifications to the Makefile were correct and
-no errors are detected during the sample application build, it is
</font><font color='#000088'>+If no errors are detected during the sample application build, it is
</font> reasonable to assume that the build of the GNAT/RTEMS Cross Compiler Tools
<font color='#880000'>-for RTEMS and RTEMS itself for the selected host and target
-combination was done properly.<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+for RTEMS and RTEMS itself for the selected host and target combination
+was done properly.
</font>
@section Application Executable<span style="background-color: #FF0000"> </span>
<font color='#997700'>@@ -252,7 +222,7 @@
</font> executable is placed in the following directory:<span style="background-color: #FF0000"> </span>
@example
<font color='#880000'>-tools/hello_world_ada/o-optimize/<filename>.exe
</font><font color='#000088'>+tools/@code{ada-examples-@value{RTEMSAPI}.<VERSION>}/hello_world_ada/o-optimize/<filename>.exe
</font> @end example
How this executable is downloaded to the target board is very dependent
<font color='#997700'>@@ -263,12 +233,14 @@
</font> @c
@section More Information on RTEMS Application Makefiles
<font color='#880000'>-These sample applications are examples of simple
-RTEMS applications that use the RTEMS Application Makefile<span style="background-color: #FF0000"> </span>
-system. This Makefile system simplifies building
-RTEMS applications by providing Makefile templates and
-capturing the configuration information used to build
-RTEMS specific to your BSP. Building an RTEMS application
-for different BSPs is as simple as switching the
-setting of @code{RTEMS_MAKEFILE_PATH}. This Makefile
</font><font color='#000088'>+These sample applications are examples of simple RTEMS applications
+that use the RTEMS Application Makefile system. This Makefile system
+simplifies building RTEMS applications by providing Makefile templates and
+capturing the configuration information used to build RTEMS specific to
+your BSP. Building an RTEMS application for different BSPs is as simple
+as switching the setting of @code{RTEMS_MAKEFILE_PATH}. This Makefile
</font> system is described in the file @code{make/README}.
<font color='#000088'>+
+It is very likely in the future that the RTEMS examples built using an
+installed RTEMS will be converted to autoconf.
+
</font>
<font color='#006600'>diff -u rtems/doc/started/started.texi:1.20 rtems/doc/started/started.texi:1.20.4.1
--- rtems/doc/started/started.texi:1.20 Thu Jun 21 13:53:00 2007
+++ rtems/doc/started/started.texi Thu Dec 16 14:54:34 2010
</font><font color='#997700'>@@ -8,7 +8,7 @@
</font> @c %**end of header
@c
<font color='#880000'>-@c COPYRIGHT (c) 1988-2002.
</font><font color='#000088'>+@c COPYRIGHT (c) 1988-2010.
</font> @c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
<font color='#997700'>@@ -23,11 +23,6 @@
</font> @include common/setup.texi
@include common/rtems.texi
<font color='#880000'>-@c
-@c Now set all the tool version dependent information
-@c
-@include tversions.texi
-
</font> @ifset use-ascii
@dircategory RTEMS On-Line Manual
@direntry
</pre>
<p> </p>
<p>--<br />
<small>Generated by <a href="http://www.codewiz.org/projects/index.html#loginfo">Deluxe Loginfo</a> 2.122 by Bernardo Innocenti <bernie@develer.com></small></p>
</body>
</html>