summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/started/buildc.t131
-rw-r--r--doc/started/buildrt.t2
-rw-r--r--doc/started/gdb.t4
-rw-r--r--doc/started/require.t2
-rw-r--r--doc/started/sample.t2
5 files changed, 66 insertions, 75 deletions
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
-<IMG SRC="sfile12c.jpg" WIDTH=417 HEIGHT=178
- ALT="Starting Directory Organization">
-@end html
-@end ifset
+@c @ifset use-html
+@c @html
+@c <IMG SRC="sfile12c.jpg" WIDTH=417 HEIGHT=178
+@c ALT="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
-<IMG SRC="bit_c.jpg" WIDTH=816 HEIGHT=267 ALT="Directory Organization">
-@end html
-@end ifset
+
+@c @ifset use-html
+@c @html
+@c <IMG SRC="bit_c.jpg" WIDTH=816 HEIGHT=267 ALT="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 <INSTALL_POINT>/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