From ae2e9f2935585164dfd1d9c6ef1ba8011d85478f Mon Sep 17 00:00:00 2001 From: Joel Sherrill Date: Tue, 14 Apr 1998 21:17:53 +0000 Subject: "arc" changed to "archive" Pictures now in ASCII. --- doc/started/buildc.t | 131 +++++++++++++++++++++++--------------------------- doc/started/buildrt.t | 2 +- doc/started/gdb.t | 4 +- doc/started/require.t | 2 +- doc/started/sample.t | 2 +- 5 files changed, 66 insertions(+), 75 deletions(-) (limited to 'doc') diff --git a/doc/started/buildc.t b/doc/started/buildc.t index e6b733ab04..e90d1c714d 100644 --- a/doc/started/buildc.t +++ b/doc/started/buildc.t @@ -21,50 +21,28 @@ directory. The command sequence to do this is shown below: @example -mkdir arc +mkdir archive mkdir tools @end example This will result in an initial directory structure similar to the one shown in the following figure: -@ifset use-ascii @example @group - parent directory common to the - tools and archive subdirectories - | - +----------------------+----------------------+ - | | - tools arc -@end group -@end example -@end ifset - +/whatever/prefix/you/choose/ + archive/ + tools/ -@ifset use-tex -@c for now use the ascii version -@example -@group - parent directory common to the - tools and archive subdirectories - | - +----------------------+----------------------+ - | | - tools arc @end group @end example -@tex -@end tex -@end ifset - -@ifset use-html -@html -Starting Directory Organization -@end html -@end ifset +@c @ifset use-html +@c @html +@c Starting Directory Organization +@c @end html +@c @end ifset @section Get All the Pieces @@ -148,9 +126,9 @@ tar files using the following command sequence: @example cd tools -tar xzf ../arc/@value{GCC-TAR} -tar xzf ../arc/@value{BINUTILS-TAR} -tar xzf ../arc/@value{NEWLIB-TAR} +tar xzf ../archive/@value{GCC-TAR} +tar xzf ../archive/@value{BINUTILS-TAR} +tar xzf ../archive/@value{NEWLIB-TAR} @end example After the compressed tar files have been unpacked, the following @@ -162,51 +140,64 @@ directories will have been created under tools. @item @value{NEWLIB-UNTAR} @end itemize -The @code{bit} script will automatically create two other -subdirectories: +Copy the @code{bit} script from the @code{archive} directory +to the @code{tools} directory as shown below: + +@example +cp ../archive/bit . +@end example + +When the @code{bit} script is executed later in this process, +it will automatically create two other subdirectories: + +@itemize @bullet +@item src +@item build-$@{CPU@}-tools +@end itemize @itemize @bullet @item src @item build-$@{CPU@}-tools @end itemize -Ignoring version numbers, this will look something like the following figure: +The tree should look something like the following figure: -@ifset use-ascii @example @group - tools - | bit (script) - + - +---------+-------------+------------+----------------+ - | | | | | -src binutils-2.9 egcs-1.0.2 newlib-1.8.0 build-$@{CPU@}-tools -@end group -@end example +/whatever/prefix/you/choose/ + bit + archive/ + @value{GCC-TAR} + @value{BINUTILS-TAR} + @value{NEWLIB-TAR} + @value{RTEMS-TAR} +@ifset GCC-RTEMSPATCH + @value{GCC-RTEMSPATCH} @end ifset +@ifset BINUTILS-RTEMSPATCH + @value{BINUTILS-RTEMSPATCH} +@end ifset +@ifset NEWLIB-RTEMSPATCH + @value{NEWLIB-RTEMSPATCH} +@end ifset + hello_world_c.tgz + bit + tools/ + @value{BINUTILS-UNTAR}/ + @value{GCC-UNTAR}/ + @value{NEWLIB-UNTAR}/ + @value{RTEMS-UNTAR}/ + bit - -@ifset use-tex -@c for now use the ascii version -@example -@group - tools - | bit (script) - + - +---------+-------------+------------+----------------+ - | | | | | -src binutils-2.9 egcs-1.0.2 newlib-1.8.0 build-${CPU}-tools @end group @end example -@tex -@end tex -@end ifset -@ifset use-html -@html -Directory Organization -@end html -@end ifset + +@c @ifset use-html +@c @html +@c Directory Organization +@c @end html +@c @end ifset @c @c Reading the Documentation @@ -235,7 +226,7 @@ Apply the patch using the following command sequence: @example cd tools/@value{GCC-UNTAR} -zcat arc/@value{GCC-RTEMSPATCH} | patch -p1 +zcat archive/@value{GCC-RTEMSPATCH} | patch -p1 @end example Check to see if any of these patches have been rejected using the following @@ -267,7 +258,7 @@ Apply the patch using the following command sequence: @example cd tools/@value{BINUTILS-UNTAR} -zcat arc/@value{BINUTILS-RTEMSPATCH} | patch -p1 +zcat archive/@value{BINUTILS-RTEMSPATCH} | patch -p1 @end example Check to see if any of these patches have been rejected using the following @@ -300,7 +291,7 @@ Apply the patch using the following command sequence: @example cd tools/@value{NEWLIB-UNTAR} -zcat arc/@value{NEWLIB-RTEMSPATCH} | patch -p1 +zcat archive/@value{NEWLIB-RTEMSPATCH} | patch -p1 @end example Check to see if any of these patches have been rejected using the following @@ -322,7 +313,7 @@ This should not happen with a good patch file. @section Modify the bit Script -Copy the @code{bit} script from arc to the tools directory. +Copy the @code{bit} script from @code{archive} to the tools directory. Edit the @code{bit} file to alter the following environmental variables: diff --git a/doc/started/buildrt.t b/doc/started/buildrt.t index 0bbd77215a..29716c24bf 100644 --- a/doc/started/buildrt.t +++ b/doc/started/buildrt.t @@ -16,7 +16,7 @@ tools directory: @example cd tools -tar xzf ../arc/@value{RTEMS-TAR} +tar xzf ../archive/@value{RTEMS-TAR} @end example @section Add /bin to Executable PATH diff --git a/doc/started/gdb.t b/doc/started/gdb.t index 753be10c87..d54fca9d42 100644 --- a/doc/started/gdb.t +++ b/doc/started/gdb.t @@ -26,7 +26,7 @@ Use the following commands to unarchive the gdb distribution: @example cd tools -tar xzf ../arc/@value{GDB-TAR} +tar xzf ../archive/@value{GDB-TAR} @end example The directory @value{GDB-UNTAR} is created under the tools directory. @@ -48,7 +48,7 @@ Apply the patch using the following command sequence: @example cd tools/@value{GDB-UNTAR} -zcat arc/@value{GDB-RTEMSPATCH} | patch -p1 +zcat archive/@value{GDB-RTEMSPATCH} | patch -p1 @end example Check to see if any of these patches have been rejected using the following diff --git a/doc/started/require.t b/doc/started/require.t index e598e088ca..09a893bce8 100644 --- a/doc/started/require.t +++ b/doc/started/require.t @@ -16,7 +16,7 @@ assessing the amount of disk space required for your installation: +----------------------------------------+------------------------------+ | Component | Disk Space Required | +----------------------------------------+------------------------------+ -| arc directory | 20 Mbytes | +| archive directory | 20 Mbytes | | tools src unzipped | 77 Mbytes | | each individual build directory | 120 Mbytes worst case | | each installation directory | 20-60 Mbytes | diff --git a/doc/started/sample.t b/doc/started/sample.t index e7bfebc0d2..b2910319bc 100644 --- a/doc/started/sample.t +++ b/doc/started/sample.t @@ -14,7 +14,7 @@ Use the following command to unarchive the sample application: @example cd tools -tar xzf ../arc/hello_world_c.tgz +tar xzf ../archive/hello_world_c.tgz @end example @section Set the Environment Variable RTEMS_MAKEFILE_PATH -- cgit v1.2.3