summaryrefslogtreecommitdiffstats
path: root/doc/started_ada
diff options
context:
space:
mode:
authorJoel Sherrill <joel.sherrill@OARcorp.com>2002-01-17 21:47:47 +0000
committerJoel Sherrill <joel.sherrill@OARcorp.com>2002-01-17 21:47:47 +0000
commit6449498bc7dea93900d6980a66af64c9116ef597 (patch)
tree7d89881d70af765dc7ad549095fb9f5f381cba6f /doc/started_ada
parentd09ad1f0e0c435fce5f1d0a36f089cb69cb3f5cc (diff)
downloadrtems-6449498bc7dea93900d6980a66af64c9116ef597.tar.bz2
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.
Diffstat (limited to 'doc/started_ada')
-rw-r--r--doc/started_ada/Makefile.am6
-rw-r--r--doc/started_ada/buildada.t91
-rw-r--r--doc/started_ada/gdb.t2
-rw-r--r--doc/started_ada/intro.t2
-rw-r--r--doc/started_ada/require.t4
-rw-r--r--doc/started_ada/sample.t2
-rw-r--r--doc/started_ada/stamp-vti4
-rw-r--r--doc/started_ada/started_ada.texi3
-rw-r--r--doc/started_ada/tversions.texi42
-rw-r--r--doc/started_ada/version.texi4
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