Mostly correcting case of section headings although a few minor things

were corrected as the Getting Started with GNAT/RTEMS manual was
created.
This commit is contained in:
Joel Sherrill
1998-04-11 14:54:58 +00:00
parent 6d3d425dbd
commit 57a736ffcb
5 changed files with 32 additions and 32 deletions

View File

@@ -50,7 +50,7 @@ intro.texi: intro.t versions.texi
-n "Requirements" ${*}.t -n "Requirements" ${*}.t
require.texi: require.t versions.texi require.texi: require.t versions.texi
$(BMENU) -c -p "Introduction" \ $(BMENU) -c -p "Cross Development" \
-u "Top" \ -u "Top" \
-n "Building the GNU C/C++ Cross Compiler Toolset" ${*}.t -n "Building the GNU C/C++ Cross Compiler Toolset" ${*}.t
@@ -65,12 +65,12 @@ buildrt.texi: buildrt.t versions.texi
-n "Building the Sample Application" ${*}.t -n "Building the Sample Application" ${*}.t
sample.texi: sample.t versions.texi sample.texi: sample.t versions.texi
$(BMENU) -c -p "Generate RTEMS for a specific target and board support package" \ $(BMENU) -c -p "Generate RTEMS for a Specific Target and Board Support Package" \
-u "Top" \ -u "Top" \
-n "Building the GNU Debugger" ${*}.t -n "Building the GNU Debugger" ${*}.t
gdb.texi: gdb.t versions.texi gdb.texi: gdb.t versions.texi
$(BMENU) -c -p "Application executable" \ $(BMENU) -c -p "Application Executable" \
-u "Top" \ -u "Top" \
-n "" ${*}.t -n "" ${*}.t

View File

@@ -13,13 +13,15 @@ source code for a GNU cross compiler toolset, apply
any required RTEMS specific patches, compile that any required RTEMS specific patches, compile that
toolset and install it. toolset and install it.
@section Get all the pieces @section Directory Organization
The tree structure in the figure below is assumed to be present in the The tree structure in the figure below is assumed to be present in the
following discussions: following discussions:
@center @b{XXX directory tree figure goes here} @center @b{XXX directory tree figure goes here}
@section Get All the Pieces
Gather the components that will be required for the installation and place Gather the components that will be required for the installation and place
them in an archive directory. Call this directory arc. Be sure that there them in an archive directory. Call this directory arc. Be sure that there
is sufficient space to hold all necessary information. This will amount to is sufficient space to hold all necessary information. This will amount to
@@ -52,14 +54,20 @@ approximately 20 megabytes.
Directory: @value{RTEMS-FTPDIR} Directory: @value{RTEMS-FTPDIR}
File: @value{RTEMS-TAR} File: @value{RTEMS-TAR}
File: bit File: bit
@ifset BINUTILS-RTEMSPATCH
File: @value{BINUTILS-RTEMSPATCH} File: @value{BINUTILS-RTEMSPATCH}
@end ifset
@ifset NEWLIB-RTEMSPATCH
File: @value{NEWLIB-RTEMSPATCH} File: @value{NEWLIB-RTEMSPATCH}
@end ifset
@ifset GCC-RTEMSPATCH
File: @value{GCC-RTEMSPATCH} File: @value{GCC-RTEMSPATCH}
@end ifset
File: hello_world_c.tgz File: hello_world_c.tgz
@end example @end example
@section Create the tools directory @section Create the tools Directory
Create a directory called tools that will serve as a working directory to Create a directory called tools that will serve as a working directory to
perform the build of the cross compiler tools. perform the build of the cross compiler tools.

View File

@@ -9,7 +9,7 @@
@chapter Building RTEMS @chapter Building RTEMS
@section Unpack the RTEMS source @section Unpack the RTEMS Source
Use the following command sequence to unpack the RTEMS source into the Use the following command sequence to unpack the RTEMS source into the
tools directory: tools directory:
@@ -19,7 +19,7 @@ cd tools
tar xzf ../arc/@value{RTEMS-TAR} tar xzf ../arc/@value{RTEMS-TAR}
@end example @end example
@section Add the bin directory under the install point to the default PATH @section Add <INSTALL_POINT>/bin to Executable PATH
In order to compile RTEMS, you must have the cross compilation toolset In order to compile RTEMS, you must have the cross compilation toolset
in your search patch. The following command appends the directory in your search patch. The following command appends the directory
@@ -33,7 +33,7 @@ NOTE: The above command is in Bourne shell (@code{sh}) syntax and should work w
the Korn (@code{ksh}) and GNU Bourne Again Shell (@code{bash}). It will not the Korn (@code{ksh}) and GNU Bourne Again Shell (@code{bash}). It will not
work with the C Shell (@code{csh})or derivatives of the C Shell. work with the C Shell (@code{csh})or derivatives of the C Shell.
@section Generate RTEMS for a specific target and board support package @section Generate RTEMS for a Specific Target and BSP
Make a build directory under tools and build the RTEMS product in this Make a build directory under tools and build the RTEMS product in this
directory. The ../@value{RTEMS-UNTAR}/configure directory. The ../@value{RTEMS-UNTAR}/configure
@@ -58,9 +58,7 @@ cd build-rtems
gmake all install gmake all install
@end example @end example
Where: Where the list of currently supported of <TARGET_CONFIGURATION>'s and
The list of currently supported of <TARGET_CONFIGURATION>'s and
<BOARD_SUPPORT_PACKAGE>'s can be found in <BOARD_SUPPORT_PACKAGE>'s can be found in
tools/@value{RTEMS-UNTAR}/README.configure. tools/@value{RTEMS-UNTAR}/README.configure.

View File

@@ -20,7 +20,7 @@ successfully used with RTEMS applications:
Other configurations of gdb have successfully been used by RTEMS users Other configurations of gdb have successfully been used by RTEMS users
but are not documented here. but are not documented here.
@section Unarchive the gdb distribution @section Unarchive the gdb Distribution
Use the following commands to unarchive the gdb distribution: Use the following commands to unarchive the gdb distribution:
@@ -76,7 +76,7 @@ The files that are found, have been modified by the patch file.
@section GDB with Sparc Instruction Simulation (SIS) @section GDB with Sparc Instruction Simulation (SIS)
@subheading Make the build directory @subheading Make the Build Directory
Create a build directory for the SIS Debugger Create a build directory for the SIS Debugger
@@ -85,7 +85,7 @@ cd tools
mkdir build-sis mkdir build-sis
@end example @end example
@subheading Configure for the build @subheading Configure for the Build
Configure the GNU Debugger for the Configure the GNU Debugger for the
Sparc Instruction Simulator (SIS): Sparc Instruction Simulator (SIS):
@@ -102,7 +102,7 @@ cd tools/build-sis
Where <INSTALL_POINT_FOR_SIS> is a unique location where the gdb Where <INSTALL_POINT_FOR_SIS> is a unique location where the gdb
with SIS will be created. with SIS will be created.
@subheading Make the debugger @subheading Make the Debugger
From tools/build-sis execute the following command sequence: From tools/build-sis execute the following command sequence:
@@ -113,7 +113,7 @@ gmake all install
@section GDB with PowerPC Instruction Simulator @section GDB with PowerPC Instruction Simulator
@subheading Make the build directory @subheading Make the Build Directory
Create a build directory for the SIS Debugger Create a build directory for the SIS Debugger
@@ -122,7 +122,7 @@ cd tools
mkdir build-ppc mkdir build-ppc
@end example @end example
@subheading Configure for the build @subheading Configure for the Build
Configure the GNU Debugger for the PowerPC Configure the GNU Debugger for the PowerPC
Instruction Simulator (PSIM): Instruction Simulator (PSIM):
@@ -144,7 +144,7 @@ Where <INSTALL_POINT_FOR_PPC> is a unique location where the gdb
with PSIM will be created. with PSIM will be created.
@subheading Make the debugger @subheading Make the Debugger
From tools/build-ppc execute the following command sequence: From tools/build-ppc execute the following command sequence:
@@ -155,11 +155,7 @@ gmake all install
@section GDB for DINK32 @section GDB for DINK32
@subheading Unarchive the gdb distribution @subheading Make the Build Directory
Use the following commands to unarchive the gdb distribution:
@subheading Make the build directory
Create a build directory for the DINK32 Debugger Create a build directory for the DINK32 Debugger
@@ -168,7 +164,7 @@ cd tools
mkdir build-dink32 mkdir build-dink32
@end example @end example
@subheading Configure for the build @subheading Configure for the Build
Configure the GNU Debugger to communicate with Configure the GNU Debugger to communicate with
the DINK32 ROM monitor: the DINK32 ROM monitor:
@@ -184,7 +180,7 @@ cd tools/build-dink32
Where <INSTALL_POINT_FOR_DINK32> is a unique location where the Where <INSTALL_POINT_FOR_DINK32> is a unique location where the
gdb Dink32 will be created. gdb Dink32 will be created.
@subheading Make the debugger @subheading Make the Debugger
From tools/build-dink32 execute the following command sequence: From tools/build-dink32 execute the following command sequence:

View File

@@ -8,7 +8,7 @@
@chapter Building the Sample Application @chapter Building the Sample Application
@section Unpack the sample application @section Unpack the Sample Application
Use the following command to unarchive the sample application: Use the following command to unarchive the sample application:
@@ -17,7 +17,7 @@ cd tools
tar xzf ../arc/hello_world_c.tgz tar xzf ../arc/hello_world_c.tgz
@end example @end example
@section Set the environment variable RTEMS_MAKEFILE_PATH @section Set the Environment Variable RTEMS_MAKEFILE_PATH
It must point to the appropriate directory containing RTEMS build for our It must point to the appropriate directory containing RTEMS build for our
target and board support package combination. target and board support package combination.
@@ -27,9 +27,7 @@ export RTEMS_MAKEFILE_PATH = \
<INSTALLATION_POINT>/rtems/<BOARD_SUPPORT_PACKAGE> <INSTALLATION_POINT>/rtems/<BOARD_SUPPORT_PACKAGE>
@end example @end example
Where: Where <INSTALLATION_POINT> and <BOARD_SUPPORT_PACKAGE> are those used when
<INSTALLATION_POINT> and <BOARD_SUPPORT_PACKAGE> are those used when
configuring and installing RTEMS. configuring and installing RTEMS.
@section Build the Sample Application @section Build the Sample Application
@@ -46,13 +44,13 @@ reasonable to assume that the build of the GNU C/C++ Cross Compiler Tools
for RTEMS and RTEMS itself for the selected host and target for RTEMS and RTEMS itself for the selected host and target
combination was done properly. combination was done properly.
@section Application executable @section Application Executable
If the sample application has successfully been build, then the application If the sample application has successfully been build, then the application
executable is placed in the following directory: executable is placed in the following directory:
@example @example
tools/simple_app/o-<BOARD_SUPPORT_PACKAGE>/<filename>.exe tools/hello_world_c/o-<BOARD_SUPPORT_PACKAGE>/<filename>.exe
@end example @end example
How this executable is downloaded to the target board is very dependent How this executable is downloaded to the target board is very dependent