1 files changed, 61 insertions, 0 deletions
diff --git a/doc/started_ada/require.t b/doc/started_ada/require.t
index e598e088ca..779ea7b3df 100644
--- a/doc/started_ada/require.t
+++ b/doc/started_ada/require.t
@@ -29,8 +29,69 @@ 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