From 9f9efbca8df3a024607572eb7413d2cacddb73d2 Mon Sep 17 00:00:00 2001 From: Joel Sherrill Date: Tue, 22 Feb 2000 17:48:01 +0000 Subject: Adding information on prebuilt toolset binaries. --- doc/started/Makefile | 9 +++++-- doc/started/binaries.t | 18 ++++++++++++- doc/started/buildc.t | 4 +++ doc/started/gdb.t | 7 ++++- doc/started/started.texi | 2 ++ doc/started/versions.texi | 66 ++++++++++++++++++++++++++--------------------- 6 files changed, 72 insertions(+), 34 deletions(-) (limited to 'doc/started') 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) @@ -54,11 +54,16 @@ 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 -- cgit v1.2.3