2001-01-17 Joel Sherrill <joel@OARcorp.com>

	* SUPPORT, LICENSE: New files.
	* Numerous files touched as part of merging the 4.5 branch
	onto the mainline development trunk and ensuring that the
	script that cuts snapshots and releases works on the documentation.

10 files changed, 125 insertions, 35 deletions

diff --git a/doc/started_ada/Makefile.am b/doc/started_ada/Makefile.am
index 82d945803b..152b10007e 100644
--- a/doc/started_ada/Makefile.am
+++ b/doc/started_ada/Makefile.am
@@ -1,5 +1,5 @@
 #
-#  COPYRIGHT (c) 1988-1999.
+#  COPYRIGHT (c) 1988-2002.
 #  On-Line Applications Research Corporation (OAR).
 #  All rights reserved.
 #
@@ -40,12 +40,12 @@ $(srcdir)/buildada.texi: buildada.t tversions.texi
 	    -n "Building RTEMS" < $< > $@
 
 $(srcdir)/buildrt.texi: ../started/buildrt.t tversions.texi
-	$(BMENU2) -c -p "Running the bit_ada Script" \
+	$(BMENU2) -c -p "Error Messages Indicating Configuration Problems" \
 	    -u "Top" \
 	    -n "Building the Sample Application" < $< > $@
 
 $(srcdir)/sample.texi: sample.t tversions.texi
-	$(BMENU2) -c -p "Using the RTEMS configure Script Directly" \
+	$(BMENU2) -c -p "Using the bit_rtems Script" \
 	    -u "Top" \
 	    -n "Building the GNU Debugger" < $< > $@
 
diff --git a/doc/started_ada/buildada.t b/doc/started_ada/buildada.t
index bb6fd3ba65..58ee3f3778 100644
--- a/doc/started_ada/buildada.t
+++ b/doc/started_ada/buildada.t
@@ -1,5 +1,5 @@
 @c
-@c  COPYRIGHT (c) 1988-1999.
+@c  COPYRIGHT (c) 1988-2002.
 @c  On-Line Applications Research Corporation (OAR).
 @c  All rights reserved.
 @c
@@ -611,3 +611,92 @@ GNU C/C++ cross compilation tools are installed.
 If the @code{bit_ada} script does not successfully complete, then investigation
 will be required to determine the source of the error.
 
+@c
+@c Common Problems
+@c
+
+@section Common Problems
+
+@subsection Error Message Indicates Invalid Option to Assembler
+
+If a message like this is printed then the new cross compiler
+is most likely using the native assembler instead of the cross
+assembler or vice-versa (native compiler using new cross assembler).
+This can occur for one of the following reasons:
+
+@itemize @bullet
+
+@item Binutils Patch Improperly Applied
+@item Binutils Not Built
+@item Current Directory is in Your PATH
+
+@end itemize
+
+If you are using binutils 2.9.1 or newer with certain older versions of
+gcc, they do not agree on what the name of the newly 
+generated cross assembler is.  Older binutils called it @code{as.new}
+which became @code{as.new.exe} under Windows.  This is not a valid
+file name, so @code{as.new} is now called @code{as-new}.  By using the latest
+released tool versions and RTEMS patches, this problem will be avoided.
+
+If binutils did not successfully build the cross assembler, then 
+the new cross gcc (@code{xgcc}) used to build the libraries can not
+find it.  Make sure the build of the binutils succeeded.
+
+If you include the current directory in your PATH, then there
+is a chance that the native compiler will accidentally use
+the new cross assembler instead of the native one.  This usually
+indicates that "." is before the standard system directories
+in your PATH.  As a general rule, including "." in your PATH
+is a security risk and should be avoided.  Remove "." from
+your PATH.
+
+NOTE:  In some environments, it may be difficult to remove "."
+completely from your PATH.  In this case, make sure that "."
+is after the system directories containing "as" and "ld".
+
+@subsection Error Messages Indicating Configuration Problems
+
+If you see error messages like the following,
+
+@itemize @bullet
+
+@item cannot configure libiberty
+@item coff-emulation not found
+@item etc.
+
+@end itemize
+
+Then it is likely that one or more of your gnu tools is 
+already configured locally in its source tree.  You can check
+for this by searching for the @code{config.status} file
+in the various tool source trees.  The following command
+does this for the binutils source:
+
+@example
+find @value{BINUTILS-UNTAR} -name config.status -print
+@end example
+
+The solution for this is to execute the command 
+@code{make distclean} in each of the GNU tools
+root source directory.  This should remove all
+generated files including Makefiles.
+
+This situation usually occurs when you have previously
+built the tool source for some non-RTEMS target.  The
+generated configuration specific files are still in
+the source tree and the include path specified during
+the RTEMS build accidentally picks up the previous
+configuration.  The include path used is something like
+this:
+
+@example
+-I../../@value{BINUTILS-UNTAR}/gcc -I/@value{BINUTILS-UNTAR}/gcc/include -I.
+@end example
+
+Note that the tool source directory is searched before the 
+build directory.
+
+This situation can be avoided entirely by never using 
+the source tree as the build directory -- even for
+
diff --git a/doc/started_ada/gdb.t b/doc/started_ada/gdb.t
index b7a615bf9f..668ab9535f 100644
--- a/doc/started_ada/gdb.t
+++ b/doc/started_ada/gdb.t
@@ -1,5 +1,5 @@
 @c
-@c  COPYRIGHT (c) 1988-1999.
+@c  COPYRIGHT (c) 1988-2002.
 @c  On-Line Applications Research Corporation (OAR).
 @c  All rights reserved.
 @c
diff --git a/doc/started_ada/intro.t b/doc/started_ada/intro.t
index b8ae0ca57f..b7f5ebe209 100644
--- a/doc/started_ada/intro.t
+++ b/doc/started_ada/intro.t
@@ -1,5 +1,5 @@
 @c
-@c  COPYRIGHT (c) 1988-1999.
+@c  COPYRIGHT (c) 1988-2002.
 @c  On-Line Applications Research Corporation (OAR).
 @c  All rights reserved.
 @c
diff --git a/doc/started_ada/require.t b/doc/started_ada/require.t
index aa08dc6e88..53f9738063 100644
--- a/doc/started_ada/require.t
+++ b/doc/started_ada/require.t
@@ -1,5 +1,5 @@
 @c
-@c  COPYRIGHT (c) 1988-1999.
+@c  COPYRIGHT (c) 1988-2002.
 @c  On-Line Applications Research Corporation (OAR).
 @c  All rights reserved.
 @c
@@ -18,7 +18,7 @@ assessing the amount of disk space required for your installation:
 +------------------------------------+--------------------------+
 |        archive directory           |        40 Mbytes         |
 |        tools src unarchived        |       200 Mbytes         |
-|  each individual build directory   |  300 Mbytes worst case   |
+|  each individual build directory   |     up to 500 Mbytes     |
 |     each installation directory    |      20-200 Mbytes       |
 +------------------------------------+--------------------------+
 @end example
diff --git a/doc/started_ada/sample.t b/doc/started_ada/sample.t
index 53a2ba4cbb..e66b3a3776 100644
--- a/doc/started_ada/sample.t
+++ b/doc/started_ada/sample.t
@@ -1,5 +1,5 @@
 @c
-@c  COPYRIGHT (c) 1988-1999.
+@c  COPYRIGHT (c) 1988-2002.
 @c  On-Line Applications Research Corporation (OAR).
 @c  All rights reserved.
 @c
diff --git a/doc/started_ada/stamp-vti b/doc/started_ada/stamp-vti
index 27e5ccd0cb..91e60ee8f2 100644
--- a/doc/started_ada/stamp-vti
+++ b/doc/started_ada/stamp-vti
@@ -1,3 +1,3 @@
-@set UPDATED 1 June 2000
+@set UPDATED 17 January 2002
 @set EDITION 1
-@set VERSION 4.5.0-beta3
+@set VERSION 4.5.1-pre3
diff --git a/doc/started_ada/started_ada.texi b/doc/started_ada/started_ada.texi
index ef93148df6..6cd6d1ec18 100644
--- a/doc/started_ada/started_ada.texi
+++ b/doc/started_ada/started_ada.texi
@@ -1,13 +1,14 @@
 \input texinfo   @c -*-texinfo-*-
 @c %**start of header
 @setfilename started_ada
+@setcontentsaftertitlepage
 @syncodeindex vr fn
 @synindex ky cp
 @paragraphindent 0
 @c %**end of header
 
 @c
-@c  COPYRIGHT (c) 1988-1999.
+@c  COPYRIGHT (c) 1988-2002.
 @c  On-Line Applications Research Corporation (OAR).
 @c  All rights reserved.
 @c
diff --git a/doc/started_ada/tversions.texi b/doc/started_ada/tversions.texi
index d3b6ef4b9e..6c5a82e0a0 100644
--- a/doc/started_ada/tversions.texi
+++ b/doc/started_ada/tversions.texi
@@ -1,5 +1,5 @@
 @c
-@c  COPYRIGHT (c) 1988-1999.
+@c  COPYRIGHT (c) 1988-2002.
 @c  On-Line Applications Research Corporation (OAR).
 @c  All rights reserved.
 @c
@@ -25,31 +25,31 @@
 @set GCC-TAR         gcc-2.8.1.tar.gz
 @set GCC-UNTAR       gcc-2.8.1
 @set GCC-FTPSITE     ftp.gnu.org
-@set GCC-FTPDIR      /pub/gnu
-@set GCC-RTEMSPATCH  gcc-2.8.1-rtems-gnat-3.12p-20000429.diff.gz
+@set GCC-FTPDIR      /pub/gnu/gcc
+@set GCC-RTEMSPATCH  gcc-2.8.1-rtems-gnat-3.13p-20000429.diff.gz
 
 @c
 @c  GNAT Version
 @c
 
-@set GNAT-VERSION     gnat 3.12p
-@set GNAT-TAR         gnat-3.12p-src.tar.gz
-@set GNAT-UNTAR       gnat-3.12p-src
+@set GNAT-VERSION     gnat 3.13p
+@set GNAT-TAR         gnat-3.13p-src.tar.gz
+@set GNAT-UNTAR       gnat-3.13p-src
 @set GNAT-FTPSITE     NONE
 @set GNAT-FTPDIR      NO_DIRECTORY
-@set GNAT-RTEMSPATCH  gnat-3.12p-rtems-20000429.diff.gz
+@set GNAT-RTEMSPATCH  gnat-3.13p-rtems-20000829.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-VERSION     binutils 2.10
+@set BINUTILS-TAR         binutils-2.10.tar.gz
+@set BINUTILS-UNTAR       binutils-2.10
 @set BINUTILS-FTPSITE     ftp.gnu.org
-@set BINUTILS-FTPDIR      /pub/gnu
-@set BINUTILS-RTEMSPATCH  binutils-2.9.1-rtems-gnat-3.12p-20000429.diff.gz
+@set BINUTILS-FTPDIR      /pub/gnu/binutils
+@set BINUTILS-RTEMSPATCH  binutils-2.10-rtems-gnat-3.13p-20001107.diff
 
 @c When forced to use a snapshot
 @c @set BINUTILS-VERSION     gas 980314
@@ -66,9 +66,9 @@
 @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     ftp.cygnus.com
+@set NEWLIB-FTPSITE     sources.redhat.com
 @set NEWLIB-FTPDIR      /pub/newlib
-@set NEWLIB-RTEMSPATCH  newlib-1.8.2-rtems-20000501.diff.gz
+@set NEWLIB-RTEMSPATCH  newlib-1.8.2-rtems-20000606.diff.gz
 
 @c
 @c  GDB Version
@@ -78,19 +78,19 @@
 @set GDB-TAR         gdb-4.17.tar.gz
 @set GDB-UNTAR       gdb-4.17
 @set GDB-FTPSITE     ftp.gnu.org
-@set GDB-FTPDIR      /pub/gnu
-@set GDB-RTEMSPATCH  gdb-4.17-rtems-gnat-3.12p-20000429.diff
+@set GDB-FTPDIR      /pub/gnu/gdb/
+@set GDB-RTEMSPATCH  gdb-4.17-rtems-gnat-3.13p-20000918.diff
 @c @set GDB-GNATPATCH   gdb-ada-patch-1.17.8.gz
 
 @c
 @c  RTEMS Version
 @c
 
-@set RTEMS-VERSION   RTEMS 4.5.0-beta3
-@set RTEMS-TAR       rtems-4.5.0-beta3.tgz
-@set RTEMS-UNTAR     rtems-4.5.0-beta3
+@set RTEMS-VERSION   RTEMS 4.5.1
+@set RTEMS-TAR       rtems-4.5.1.tgz
+@set RTEMS-UNTAR     rtems-4.5.1
 @set RTEMS-FTPSITE   ftp.OARcorp.com
-@set RTEMS-FTPDIR    /pub/rtems/betas/4.5.0-beta
-@set BUILDTOOLS-TAR  c_build_scripts-4.5.0-beta3.tgz 
+@set RTEMS-FTPDIR    /pub/rtems/releases/4.5.1
+@set BUILDTOOLS-TAR  c_build_scripts-4.5.1.tgz 
 
 
diff --git a/doc/started_ada/version.texi b/doc/started_ada/version.texi
index 27e5ccd0cb..91e60ee8f2 100644
--- a/doc/started_ada/version.texi
+++ b/doc/started_ada/version.texi
@@ -1,3 +1,3 @@
-@set UPDATED 1 June 2000
+@set UPDATED 17 January 2002
 @set EDITION 1
-@set VERSION 4.5.0-beta3
+@set VERSION 4.5.1-pre3