Adding information on prebuilt toolset binaries.

6 files changed, 72 insertions, 34 deletions

diff --git a/doc/started/Makefile b/doc/started/Makefile
index 700ae4301b..fbe2f39ee3 100644
--- a/doc/started/Makefile
+++ b/doc/started/Makefile
@@ -17,7 +17,7 @@ dirs:
 
 COMMON_FILES=../common/cpright.texi ../common/setup.texi
 
-GENERATED_FILES= buildc.texi buildrt.texi gdb.texi intro.texi \
+GENERATED_FILES= binaries.texi buildc.texi buildrt.texi gdb.texi intro.texi \
     nt.texi require.texi sample.texi
 
 FILES= $(PROJECT).texi versions.texi $(GENERATED_FILES)
@@ -55,10 +55,15 @@ intro.texi: intro.t versions.texi
 require.texi: require.t versions.texi
 	$(BMENU) -c -p "EGCS Mailing List" \
 	    -u "Top" \
+	    -n "Prebuilt Toolset Executables" ${*}.t
+
+binaries.texi: binaries.t versions.texi
+	$(BMENU) -c -p "GNU makeinfo Version Requirements" \
+	    -u "Top" \
 	    -n "Building the GNU C/C++ Cross Compiler Toolset" ${*}.t
 
 buildc.texi: buildc.t versions.texi
-	$(BMENU) -c -p "GNU makeinfo Version Requirements" \
+	$(BMENU) -c -p "Removing RPMs" \
 	    -u "Top" \
 	    -n "Building RTEMS" ${*}.t
 
diff --git a/doc/started/binaries.t b/doc/started/binaries.t
index 36a85c0635..d1a09bf465 100644
--- a/doc/started/binaries.t
+++ b/doc/started/binaries.t
@@ -6,7 +6,7 @@
 @c  $Id$
 @c
 
-@chapter Tool Binaries
+@chapter Prebuilt Toolset Executables
 
 Precompiled toolsets are available for Linux and Cygwin.  These are
 packaged using the RedHat Package Manager (RPM).  RPM is the
@@ -34,6 +34,8 @@ RPMs are strictly optional.
 
 @end enumerate
 
+@section Installing RPMs
+
 The following is a sample session illustrating the installation
 of a C/C++ toolset targeting the SPARC architecture.  
 
@@ -46,3 +48,17 @@ rpm -i rtems-base-gdb-4.18-2.i386.rpm
 rpm -i sparc-rtems-gdb-4.18-2.i386.rpm
 @end example
 
+@section Removing RPMs
+
+The following is a sample session illustrating the removal
+of a C/C++ toolset targeting the SPARC architecture.
+
+@example
+rpm -i sparc-rtems-gdb-4.18-2.i386.rpm
+rpm -i rtems-base-gdb-4.18-2.i386.rpm
+rpm -i sparc-rtems-gcc-gcc2.95.2newlib1.8.2-4.i386.rpm
+rpm -i rtems-base-gcc-gcc2.95.2newlib1.8.2-4.i386.rpm
+rpm -i sparc-rtems-binutils-2.9.5.0.24-1.i386.rpm
+rpm -i rtems-base-binutils-2.9.5.0.24-1.i386.rpm
+@end example
+
diff --git a/doc/started/buildc.t b/doc/started/buildc.t
index 138748a73c..0d19efdf7a 100644
--- a/doc/started/buildc.t
+++ b/doc/started/buildc.t
@@ -13,6 +13,10 @@ 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.
+
 @section Create the Archive and Build Directories
 
 Start by making the @code{archive} directory to contain the downloaded 
diff --git a/doc/started/gdb.t b/doc/started/gdb.t
index f29e3d6e0d..ee05ee2958 100644
--- a/doc/started/gdb.t
+++ b/doc/started/gdb.t
@@ -8,7 +8,8 @@
 
 @chapter Building the GNU Debugger
 
-GDB is not currently RTEMS aware. The following configurations have been
+GDB is currently RTEMS aware only if you are using the remote debugging
+support via Ethernet.   The following configurations have been
 successfully used with RTEMS applications:
 
 @itemize @bullet
@@ -20,6 +21,10 @@ successfully used with RTEMS applications:
 Other configurations of gdb have successfully been used by RTEMS users
 but are not documented here.
 
+It is recommended that when toolset binaries are available for
+your particular host, that they be used.  Prebuilt binaries
+are much easier to install.
+
 @section Unarchive the gdb Distribution
 
 Use the following commands to unarchive the gdb distribution:
diff --git a/doc/started/started.texi b/doc/started/started.texi
index 9bd6728fa0..b79d534752 100644
--- a/doc/started/started.texi
+++ b/doc/started/started.texi
@@ -69,6 +69,7 @@ END-INFO-DIR-ENTRY
 
 @include intro.texi
 @include require.texi
+@include binaries.texi
 @include buildc.texi
 @include buildrt.texi
 @include sample.texi
@@ -84,6 +85,7 @@ This is the online version of the Getting Started with RTEMS for C/C++ Users.
 @menu
 * Introduction::
 * Requirements::
+* Prebuilt Toolset Executables::
 * Building the GNU C/C++ Cross Compiler Toolset::
 * Building RTEMS::
 * Building the Sample Application::
diff --git a/doc/started/versions.texi b/doc/started/versions.texi
index 63398ce5a7..5b93d6a3b4 100644
--- a/doc/started/versions.texi
+++ b/doc/started/versions.texi
@@ -21,25 +21,33 @@
 @c  GCC/EGCS Version
 @c
 
-@set GCC-VERSION     egcs 1.1.2
-@set GCC-TAR         egcs-1.1.2.tar.gz
-@set GCC-UNTAR       egcs-1.1.2
-@set GCC-FTPSITE     egcs.cygnus.com
-@set GCC-FTPDIR      /pub/egcs/releases/egcs-1.1.2
-@set GCC-HTTPDIR     /pub/egcs/releases/index.html
-@set GCC-RTEMSPATCH  egcs-1.1.2-rtems-diff-19990331
+@set GCC-VERSION     gcc 2.95.2
+@set GCC-TAR         gcc-2.95.2.tar.gz
+@set GCC-UNTAR       gcc-2.95.2
+@set GCC-FTPSITE     gcc.gnu.org
+@set GCC-FTPDIR      /pub/gcc/gcc-2.95.2
+@set GCC-HTTPDIR     /pub/gcc/releases/index.html
+@set GCC-RTEMSPATCH  gcc-2.95.2-rtems-20000106.diff
 
 @c
 @c  BINUTILS Version
 @c
 
 @c The "official" binutils
-@set BINUTILS-VERSION     binutils 2.9.1
-@set BINUTILS-TAR         binutils-2.9.1.tar.gz
-@set BINUTILS-UNTAR       binutils-2.9.1
-@set BINUTILS-FTPSITE     ftp.gnu.org
-@set BINUTILS-FTPDIR      /pub/gnu
-@set BINUTILS-RTEMSPATCH  binutils-2.9.1-rtems-diff-19981012.gz
+@c @set BINUTILS-VERSION     binutils 2.9.1
+@c @set BINUTILS-TAR         binutils-2.9.1.tar.gz
+@c @set BINUTILS-UNTAR       binutils-2.9.1
+@c @set BINUTILS-FTPSITE     ftp.gnu.org
+@c @set BINUTILS-FTPDIR      /pub/gnu
+@c @set BINUTILS-RTEMSPATCH  binutils-2.9.1-rtems-diff-19981012.gz
+
+@c The "official" Linux binutils
+@set BINUTILS-VERSION     binutils 2.9.5.0.22
+@set BINUTILS-TAR         binutils-2.9.5.0.22.tar.gz
+@set BINUTILS-UNTAR       binutils-2.9.5.0.22
+@set BINUTILS-FTPSITE     ftp.varesearch.com
+@set BINUTILS-FTPDIR      /pub/support/hjl/binutils
+@set BINUTILS-RTEMSPATCH  binutils-2.9.5.0.22-rtems-20000114.diff
 
 @c When forced to use a snapshot
 @c @set BINUTILS-VERSION     gas 980314
@@ -53,34 +61,32 @@
 @c  NEWLIB Version
 @c
 
-@set NEWLIB-VERSION     newlib 1.8.1
-@set NEWLIB-TAR         newlib-1.8.1.tar.gz
-@set NEWLIB-UNTAR       newlib-1.8.1
-@set NEWLIB-FTPSITE     ftp.cygnus.com
+@set NEWLIB-VERSION     newlib 1.8.2
+@set NEWLIB-TAR         newlib-1.8.2.tar.gz
+@set NEWLIB-UNTAR       newlib-1.8.2
+@set NEWLIB-FTPSITE     sourceware.cygnus.com
 @set NEWLIB-FTPDIR      /pub/newlib
-@set NEWLIB-RTEMSPATCH  newlib-1.8.1-rtems-diff-19990302.gz
+@set NEWLIB-RTEMSPATCH  newlib-1.8.2-rtems-20000104.diff
 
 @c
 @c  GDB Version
 @c
 
-@set GDB-VERSION     gdb 4.17
-@set GDB-TAR         gdb-4.17.tar.gz
-@set GDB-UNTAR       gdb-4.17
+@set GDB-VERSION     gdb 4.18
+@set GDB-TAR         gdb-4.18.tar.gz
+@set GDB-UNTAR       gdb-4.18
 @set GDB-FTPSITE     ftp.gnu.org
-@set GDB-FTPDIR      /pub/gnu
-@set GDB-RTEMSPATCH  gdb-4.17-rtems-diff-19990302.gz
-
+@set GDB-FTPDIR      /pub/gnu/gdb
+@set GDB-RTEMSPATCH  gdb-4.18-rtems-20000107.diff
 
 @c
 @c  RTEMS Version
 @c
 
-@set RTEMS-VERSION   RTEMS 19990709
-@set RTEMS-TAR       rtems-19990709.tgz
-@set RTEMS-UNTAR     rtems-19990709
+@set RTEMS-VERSION   RTEMS 4.5.0-beta
+@set RTEMS-TAR       rtems-4.5.0-beta.tgz
+@set RTEMS-UNTAR     rtems-4.5.0-beta
 @set RTEMS-FTPSITE   ftp.OARcorp.com
-@set RTEMS-FTPDIR    /pub/rtems/19990709
-@set BUILDTOOLS-TAR  c_build_scripts-19990709.tgz
-
+@set RTEMS-FTPDIR    /pub/rtems/releases/4.5.0-beta
+@set BUILDTOOLS-TAR  c_build_scripts-20000104.tgz