summaryrefslogtreecommitdiffstats
path: root/doc/started_ada/require.t
diff options
context:
space:
mode:
authorJoel Sherrill <joel.sherrill@OARcorp.com>2010-12-16 20:42:53 +0000
committerJoel Sherrill <joel.sherrill@OARcorp.com>2010-12-16 20:42:53 +0000
commit1ae36f59b9c736c3a68acf65dfd4d2c2964c3960 (patch)
tree880cb1fc024a36fa1ffeb7ce4b3181535e8479d9 /doc/started_ada/require.t
parent2010-12-16 Joel Sherrill <joel.sherrilL@OARcorp.com> (diff)
downloadrtems-1ae36f59b9c736c3a68acf65dfd4d2c2964c3960.tar.bz2
2010-12-16 Joel Sherrill <joel.sherrilL@OARcorp.com>
* develenv/direct.t: Remove Getting Started with GNAT/RTEMS. * started_ada/.cvsignore, started_ada/Makefile.am, started_ada/buildada.t, started_ada/gdb.t, started_ada/intro.t, started_ada/require.t, started_ada/sample.t, started_ada/stamp-vti, started_ada/started_ada.texi, started_ada/tversions.texi, started_ada/version.texi: Removed.
Diffstat (limited to '')
-rw-r--r--doc/started_ada/require.t122
1 files changed, 0 insertions, 122 deletions
diff --git a/doc/started_ada/require.t b/doc/started_ada/require.t
deleted file mode 100644
index 53f9738063..0000000000
--- a/doc/started_ada/require.t
+++ /dev/null
@@ -1,122 +0,0 @@
-@c
-@c COPYRIGHT (c) 1988-2002.
-@c On-Line Applications Research Corporation (OAR).
-@c All rights reserved.
-@c
-@c $Id$
-@c
-
-@chapter Requirements
-
-A fairly large amount of disk space is required to perform the build of the
-GNU C/C++ Cross Compiler Tools for RTEMS. The following table may help in
-assessing the amount of disk space required for your installation:
-
-@example
-+------------------------------------+--------------------------+
-| Component | Disk Space Required |
-+------------------------------------+--------------------------+
-| archive directory | 40 Mbytes |
-| tools src unarchived | 200 Mbytes |
-| each individual build directory | up to 500 Mbytes |
-| each installation directory | 20-200 Mbytes |
-+------------------------------------+--------------------------+
-@end example
-
-It is important to understand that the above requirements only address
-the GNU C/C++ Cross Compiler Tools themselves. Adding additional
-languages such as Fortran or Objective-C can increase the size
-of the build and installation directories. Also, the unarchived
-source and build directories can be removed after the tools are
-installed.
-
-After the tools themselves are installed, RTEMS must be built
-and installed for each Board Support Package that you wish
-to use. Thus the precise amount of disk space required
-for each installation directory depends highly on the number
-of RTEMS BSPs which are to be installed. If a single BSP is
-installed, then the additional size of each install directory
-will tend to be in the 40-60 Mbyte range.
-
-There are a number of factors which must be taken into
-account in oreder to estimate the amount of disk space required
-to build RTEMS itself. Attempting to build multiple BSPs in
-a single step increases the disk space requirements. Similarly
-enabling optional features increases the build and install
-space requirements. In particular, enabling and building
-the RTEMS tests results in a significant increase in build
-space requirements but since the test are not installed has
-no impact on installation requirements.
-
-The instructions in this manual should work on any computer running
-a UNIX variant. Some native GNU tools are used by this procedure
-including:
-
-@itemize @bullet
-@item GCC
-@item GNAT
-@item GNU make
-@end itemize
-
-In addition, some native utilities may be deficient for building
-the GNU tools.
-
-@section Native GNAT
-
-The native GNAT must be installed in the default location or built
-from source. No GCC or GNAT environment variables should be set during
-the build or use of the cross GNAT/RTEMS toolset as this could result in
-an unpredictable mix of native and cross toolsets.
-
-Binaries for native GNAT installations are available at the primary
-GNAT ftp site (@value{GNAT-FTP}. Installation instructions are
-included with the binary GNAT distributions. The binary installation
-should be installed in the default location or installed in a
-non-default location and used ONLY to build a native GNAT from source.
-This final native GNAT will be used to build the GNAT/RTEMS cross
-development toolset.
-
-@subsection Verifying Correct Operation of Native GNAT
-
-It is imperative that the native GNAT installation work correctly for
-the installation of GNAT/RTEMS to succeed. It is recommended that the
-user verify that the native GNAT is installed correctly by performing
-these tests:
-
-@subsubsection Native Hello World Test
-
-Place the following Ada source code in hello.adb:
-
-@example
-with Text_IO; use Text_IO;
-
-procedure Hello is
-begin
- Put_Line ( "Hello World");
-end Hello;
-@end example
-
-Use the following command sequence to ompile and execute the above program:
-
-@example
-gnatmake hello
-./hello
-@end example
-
-If the message @code{Hello World} is printed, then the native installation
-of GNAT operates well enough to proceed.
-
-@subsubsection Insure GCC and GNAT Environment Variables Are Not Set
-
-If any of the following commands produce output, then you have
-environment variables overriding the default behavior of the
-native GNAT toolset. These variables will conflict with the cross
-toolset. Please resolve this problem before proceeding further.
-
-@example
-echo $GCC_EXEC_PREFIX
-echo $ADA_INCLUDE_PATH
-echo $ADA_OBJECTS_PATH
-echo $LD_RUN_PATH
-echo $C_INCLUDE_PATH
-@end example