From 48cd0b8e254d7fedc447d672f932d565f47d7b59 Mon Sep 17 00:00:00 2001
From: Joel Sherrill <joel.sherrill@OARcorp.com>
Date: Thu, 2 Oct 2003 18:01:48 +0000
Subject: 2003-10-02	Joel Sherrill <joel@OARcorp.com>

	* Makefile.am, binaries.t, buildc.t, intro.t, nextstep.t, require.t,
	sample.t, started.texi: General improvements and merge enough Ada
	information to justify dropping the Ada specific manual. There is
	likely still Ada specific information to merge though.
---
 doc/started/buildc.t | 65 ++++++++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 56 insertions(+), 9 deletions(-)

(limited to 'doc/started/buildc.t')

diff --git a/doc/started/buildc.t b/doc/started/buildc.t
index 08d2ce152f..cea0fb62aa 100644
--- a/doc/started/buildc.t
+++ b/doc/started/buildc.t
@@ -6,7 +6,7 @@
 @c  $Id$
 @c
 
-@chapter Building the GNU C/C++ Cross Compiler Toolset
+@chapter Building the GNU Cross Compiler Toolset
 
 NOTE:  This chapter does @b{NOT} apply if you installed
 prebuilt toolset executables for BINUTILS, GCC, NEWLIB,
@@ -537,15 +537,16 @@ ln -s ../@value{NEWLIBUNTAR}/newlib .
 
 The following example illustrates the invocation of
 @code{configure} and @code{make}
-to build and install @value{BINUTILSUNTAR} for the
-sparc-rtems target:
+to build and install @value{GCCUNTAR} with only
+C and C++ support for the sparc-rtems target:
 
 @example
 mkdir b-gcc
 cd b-gcc
 ../@value{GCCUNTAR}/configure --target=sparc-rtems \
    --with-gnu-as --with-gnu-ld --with-newlib --verbose \
-   --enable-threads --prefix=@value{RTEMSPREFIX}
+   --enable-threads --enable-languages="c,c++" \
+   --prefix=@value{RTEMSPREFIX}
 make all
 make info
 make install
@@ -559,6 +560,47 @@ refer to the documentation for @value{GCCUNTAR} or
 invoke the @value{GCCUNTAR} @code{configure} command with the
 @code{--help} option.
 
+@c
+@c Building GCC with Ada Support
+@c
+@subheading Building GCC with Ada Support
+
+If you want a GCC toolset that includes support for Ada
+(e.g. GNAT), there are some additional requirements on
+the host environment and additional build steps to perform.
+It is critical that you use the same version of GCC/GNAT as
+the native compiler.  GNAT must be compiled with an Ada compiler
+and when building a GNAT cross-compiler, it should be 
+the same version of GNAT itself. 
+
+The build procedure is the same until the 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 @value{GCCUNTAR} with only
+C, C++, and Ada support for the sparc-rtems target:
+
+@example
+mkdir b-gcc
+cd @value{GCCUNTAR}/gcc/ada
+touch treeprs.ads [es]info.h nmake.ad[bs]
+cd ../../../b-gcc
+../@value{GCCUNTAR}/configure --target=sparc-rtems \
+   --with-gnu-as --with-gnu-ld --with-newlib --verbose \
+   --enable-threads --enable-languages="c,c++,ada" \
+   --prefix=@value{RTEMSPREFIX}
+make all
+make info
+make -C gcc cross-gnattools
+make -C gcc ada.all.cross
+make -C gcc GNATLIBCFLAGS="USER_SELECTED_CPU_CFLAGS" gnatlib
+make install
+@end example
+
+After @value{GCCUNTAR} is built and installed the 
+build directory @code{b-gcc} may be removed.
+
 @c
 @c Building the GNU Debugger GDB
 @c
@@ -577,12 +619,17 @@ specific.  The following configurations have been
 successfully used with RTEMS applications:
 
 @itemize @bullet
-@item Sparc Instruction Simulator (SIS)
-@item PowerPC Instruction Simulator (PSIM)
-@item DINK32
-@item BDM with 68360 and MPC860 CPUs
+@item BDM with ColdFire, 683xx, MPC860 CPUs
 @item Motorola Mxxxbug found on M68xxx VME boards
-@item Motorola PPCbug found on PowerPC VME and CompactPCI boards
+@item Motorola PPCbug found on PowerPC VME, CompactPCI, and MTX boards
+@item ARM based Cogent EDP7312
+@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)
+@item DINK32 on various PowerPC boards
 @end itemize
 
 GDB is currently RTEMS thread/task aware only if you are using the
-- 
cgit v1.2.3