From 6449498bc7dea93900d6980a66af64c9116ef597 Mon Sep 17 00:00:00 2001 From: Joel Sherrill Date: Thu, 17 Jan 2002 21:47:47 +0000 Subject: 2001-01-17 Joel Sherrill * 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. --- doc/started_ada/Makefile.am | 6 +-- doc/started_ada/buildada.t | 91 +++++++++++++++++++++++++++++++++++++++- doc/started_ada/gdb.t | 2 +- doc/started_ada/intro.t | 2 +- doc/started_ada/require.t | 4 +- doc/started_ada/sample.t | 2 +- doc/started_ada/stamp-vti | 4 +- doc/started_ada/started_ada.texi | 3 +- doc/started_ada/tversions.texi | 42 +++++++++---------- doc/started_ada/version.texi | 4 +- 10 files changed, 125 insertions(+), 35 deletions(-) (limited to 'doc/started_ada') 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 -- cgit v1.2.3