Changeset 39075eb2 in rtems

Timestamp:

Feb 4, 2004, 12:34:09 AM (18 years ago)

Author:

Joel Sherrill <joel.sherrill@…>

Branches:

4.10, 4.11, 4.8, 4.9, 5, master

Children:

6ccb466

Parents:

66661b3a

Message:

2004-02-03 Joel Sherrill <joel@…>

• HELP.html, index.html.in, rtems_footer.html.in, rtems_header.html.in, FAQ/basic.t, gnu_docs/gnu_footer.html, gnu_docs/index.html, gnu_docs/refcard.html, gnu_docs/rtems_tools_index.html, started/binaries.t, started/buildc.t, started/buildrt.t, started/intro.t, started/require.t, started/sample.t, started/tversions.texi.in: Incorporating changes from pre-4.6.0 review.

Location:

doc

Files:

• ChangeLog (modified) (1 diff)
• FAQ/basic.t (modified) (3 diffs)
• HELP.html (modified) (1 diff)
• gnu_docs/gnu_footer.html (modified) (1 diff)
• gnu_docs/index.html (modified) (1 diff)
• gnu_docs/refcard.html (modified) (1 diff)
• gnu_docs/rtems_tools_index.html (modified) (1 diff)
• index.html.in (modified) (1 diff)
• rtems_footer.html.in (modified) (1 diff)
• rtems_header.html.in (modified) (1 diff)
• started/binaries.t (modified) (5 diffs)
• started/buildc.t (modified) (4 diffs)
• started/buildrt.t (modified) (1 diff)
• started/intro.t (modified) (3 diffs)
• started/require.t (modified) (2 diffs)
• started/sample.t (modified) (2 diffs)
• started/tversions.texi.in (modified) (1 diff)

doc/ChangeLog

@@ +1 @@
+2004-02-03      Joel Sherrill <joel@OARcorp.com>
+
+        * HELP.html, index.html.in, rtems_footer.html.in, rtems_header.html.in,
+        FAQ/basic.t, gnu_docs/gnu_footer.html, gnu_docs/index.html,
+        gnu_docs/refcard.html, gnu_docs/rtems_tools_index.html,
+        started/binaries.t, started/buildc.t, started/buildrt.t,
+        started/intro.t, started/require.t, started/sample.t,
+        started/tversions.texi.in: Incorporating changes from pre-4.6.0
+        review.
+
 2004-02-01      Ralf Corsepius <corsepiu@faw.uni-ulm.de>
 

doc/FAQ/basic.t

@@ -151 +151 @@
 RTEMS is distributed from @uref{@value{RTEMSHTTPURL},@value{RTEMSHTTPURL}}.
 This is a server dedicated to the RTEMS Project which was donated by and
-hosted by @uref{http://www.OARcorp.com,OAR Corporation} to provide
+hosted by @uref{http://www.oarcorp.com,OAR Corporation} to provide
 a focal point for all RTEMS activities.  Point your
 favorite browser at the following URL and following the link:
@@ -178 +178 @@
 
 @example
-http://www.oarcorp.com/rtems/maillistArchives/rtems-users
+http://www.rtems.com/ml/rtems-users
 @end example
 
@@ -190 +190 @@
 
 @example
-http://www.oarcorp.com/rtems/maillistArchives/rtems-snapshots
+http://www.rtems.com/ml/rtems-snapshots
 @end example
 

doc/HELP.html

@@ -18 +18 @@
 
 <HR>
-Copyright &copy; 1988-2003 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>
+Copyright &copy; 1988-2004 <A HREF="http://www.rtems.com" target="Text Frame">OAR Corporation</A>
 </BODY></HTML>

doc/gnu_docs/gnu_footer.html

@@ -1 @@
-<P>Packaging copyright &copy; 1988-2003 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A></BR>
-Content copyright by each document's author.  See <A HREF="http://www.gnu.org" target="Text Frame">Free Software Foundation</A> for information.
+<P>Each document is copyright by its author(s).  See <A HREF="http://www.gnu.org" target="Text Frame">Free Software Foundation</A> for information.

doc/gnu_docs/index.html

@@ -140 +140 @@
 </MENU>
 <HR>
-Copyright &copy; 1988-2003 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>
+Copyright &copy; 1988-2004 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>
 </BODY></HTML>

doc/gnu_docs/refcard.html

@@ -10 +10 @@
 no HTML or PDF version of this file.
 <HR>
-Copyright &copy; 1988-2003 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>
+Copyright &copy; 1988-2004 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>
 </BODY></HTML>

doc/gnu_docs/rtems_tools_index.html

@@ -12 +12 @@
 </MENU>
 <HR>    
-Copyright &copy; 1988-2003 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>
+Copyright &copy; 1988-2004 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>
 </BODY></HTML>      

doc/index.html.in

@@ -278 +278 @@
 </MENU>
 <HR>
-Copyright &copy; 1988-2003 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>
+Copyright &copy; 1988-2004 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>
 </BODY></HTML>

doc/rtems_footer.html.in

@@ -1 @@
-<P>Copyright &copy; 1988-2003 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>
+<P>Copyright &copy; 1988-2004 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>

doc/rtems_header.html.in

@@ -1 +1 @@
 <BODY BGCOLOR="FFFFFF">
 <A HREF="http://www.rtems.com" target="Text Frame">
-  <IMG align=right BORDER=0 SRC="../images/rtems_jpg.jpg" ALT="RTEMS Logo"> </A>
+  <IMG align=right BORDER=0 SRC="../images/rtems_logo.jpg" ALT="RTEMS Logo"> </A>
 <H1>RTEMS @VERSION@ On-Line Library</H1>
 <HR>

doc/started/binaries.t

@@ -20 +20 @@
 RPM is an acronym for the RPM Package Manager.  RPM is the
 native package installer for many Linux distributions including
-RedHat and SuSE.
-@c RPM supports other operating systems including
-@c Cygwin.  @uref{mailto:D.J@@fiddes.surfaid.org,David Fiddes <D.J@@fiddes.surfaid.org>}
-@c did the initial groundwork that lead to Cygwin RPMs being available.
+RedHat, SuSE, and Fedora.
 
 The prebuilt binaries are intended to be easy to install and
@@ -39 +36 @@
 "base" packages.
 
-@item If buildable for a particular CPU, RPMs are provided for 
-Ada (gnat), Chill, Java (gcj), Fortran (g77), and Objective-C (objc).
-These binaries are strictly optional.
+@item Depending upon the version of GCC as well as the development
+host and target CPU combination, pre-built supplemental packages may 
+be provided for Ada (gnat), Chill, Java (gcj), Fortran (g77), and
+Objective-C (objc).  These binaries are strictly optional.
 
 @end enumerate
@@ -107 +105 @@
 
 This section provides information on installing and removing
-Zipped Tar Files (.tgz).
+Zipped Tar Files (e.g .tar.gz or .tar.bz2).
 
 @subsection Installing Zipped Tar Files
@@ -113 +111 @@
 The following is a sample session illustrating the installation
 of a C/C++ toolset targeting the SPARC architecture assuming
-that GNU tar is installed as @code{tar}:
+that GNU tar is installed as @code{tar} for a set of archive
+files compressed with GNU Zip (gzip):
 
 @example
 cd /
-tar xzf rtems-base-binutils-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.tgz
-tar xzf sparc-rtems-binutils-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.tgz
-tar xzf rtems-base-gcc-gcc@value{GCCVERSION}newlib@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.tgz
-tar xzf sparc-rtems-gcc-gcc@value{GCCVERSION}newlib@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.tgz
-tar xzf rtems-base-gdb-@value{GDBVERSION}-@value{GDBRPMRELEASE}.tgz
-tar xzf sparc-rtems-gdb-@value{GDBVERSION}-@value{GDBRPMRELEASE}.tgz
+tar xzf @value{RTEMSRPMPREFIX}rtems-base-binutils-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.tar.gz
+tar xzf @value{RTEMSRPMPREFIX}sparc-rtems-binutils-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.tar.gz
+tar xzf @value{RTEMSRPMPREFIX}rtems-base-gcc-gcc@value{GCCVERSION}newlib@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.tar.gz
+tar xzf @value{RTEMSRPMPREFIX}sparc-rtems-gcc-gcc@value{GCCVERSION}newlib@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.tar.gz
+tar xzf @value{RTEMSRPMPREFIX}rtems-base-gdb-@value{GDBVERSION}-@value{GDBRPMRELEASE}.tar.gz
+tar xzf @value{RTEMSRPMPREFIX}sparc-rtems-gdb-@value{GDBVERSION}-@value{GDBRPMRELEASE}.tar.gz
+@end example
+
+The following command set is the equivalent command sequence
+for the same toolset assuming that is was compressed with
+GNU BZip (bzip2):
+
+@example
+cd /
+tar xjf @value{RTEMSRPMPREFIX}rtems-base-binutils-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.tar.bz2
+tar xjf @value{RTEMSRPMPREFIX}sparc-rtems-binutils-@value{BINUTILSVERSION}-@value{BINUTILSRPMRELEASE}.tar.bz2
+tar xjf @value{RTEMSRPMPREFIX}rtems-base-gcc-gcc@value{GCCVERSION}newlib@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.tar.bz2
+tar xjf @value{RTEMSRPMPREFIX}sparc-rtems-gcc-gcc@value{GCCVERSION}newlib@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.tar.bz2
+tar xjf @value{RTEMSRPMPREFIX}rtems-base-gdb-@value{GDBVERSION}-@value{GDBRPMRELEASE}.tar.bz2
+tar xjf @value{RTEMSRPMPREFIX}sparc-rtems-gdb-@value{GDBVERSION}-@value{GDBRPMRELEASE}.tar.bz2
 @end example
 
@@ -133 +146 @@
 @subsection Removing Zipped Tar Files
 
-There is no automatic way to remove the contents of a @code{tgz} once
-it is installed.  The contents of the directory @code{@value{RTEMSPREFIX}}
-can be removed but this will likely result in other packages
-being removed as well.
+There is no automatic way to remove the contents of a @code{tar.gz} 
+or @code{tar.bz2} once it is installed.  The contents of the directory
+@code{@value{RTEMSPREFIX}} can be removed but this will likely result
+in other packages being removed as well.
 
 

doc/started/buildc.t

@@ -93 +93 @@
 @example
     FTP Site:    @value{RTEMSFTPSITE}
-    Directory:   @value{RTEMSFTPDIR}/c_tools/source
+    Directory:   @value{RTEMSFTPDIR}/@value{VERSION}
 @ifset BINUTILSPATCHVERSION
     File:        @value{BINUTILSRTEMSPATCH}
@@ -104 +104 @@
 @end ifset
 @ifset use-html
-@c    URL:         @uref{ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/c_tools/source,Download RTEMS Patches and Scripts}
-    URL:         ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/c_tools/source
+@c    URL:         @uref{ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/SOURCES,Download RTEMS Patches and Scripts}
+    URL:         ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/SOURCES
 @end ifset
 @end example
@@ -438 +438 @@
 @example
 @value{RTEMSRPMPREFIX}rtems-base-gcc-gcc@value{GCCVERSION}newlib@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.i386.rpm
-@value{RTEMSRPMPREFIX}rtems-base-chill-gcc@value{GCCVERSION}newlib@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.i386.rpm
 @value{RTEMSRPMPREFIX}rtems-base-g77-gcc@value{GCCVERSION}newlib@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.i386.rpm
 @value{RTEMSRPMPREFIX}rtems-base-gcj-gcc@value{GCCVERSION}newlib@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.i386.rpm
 @value{RTEMSRPMPREFIX}i386-rtems-gcc-gcc@value{GCCVERSION}newlib@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.i386.rpm
-@value{RTEMSRPMPREFIX}i386-rtems-chill-gcc@value{GCCVERSION}newlib@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.i386.rpm
 @value{RTEMSRPMPREFIX}i386-rtems-g77-gcc@value{GCCVERSION}newlib@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.i386.rpm
 @value{RTEMSRPMPREFIX}i386-rtems-gcj-gcc@value{GCCVERSION}newlib@value{NEWLIBVERSION}-@value{GCCRPMRELEASE}.i386.rpm
@@ -668 +666 @@
 @example
     FTP Site:    @value{RTEMSFTPSITE}
-    Directory:   @value{RTEMSFTPDIR}/c_tools/source
+    Directory:   @value{RTEMSFTPDIR}/SOURCES
 @ifset GDBPATCHVERSION
     File:        @value{GDBRTEMSPATCH}
-    URL:         @uref{ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/c_tools/source/@value{GDBRTEMSPATCH},,ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/c_tools/source/@value{GDBRTEMSPATCH}}
+    URL:         @uref{ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/SOURCES/@value{GDBRTEMSPATCH},,ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/SOURCES/@value{GDBRTEMSPATCH}}
 @end ifset
 @end example

doc/started/buildrt.t

@@ -19 +19 @@
 @example
     FTP Site:    @value{RTEMSFTPSITE}
-    Directory:   @value{RTEMSFTPDIR}
+    Directory:   @value{RTEMSFTPDIR}/@value{VERSION}
     File:        @value{RTEMSTAR}
 @ifset use-html
-@c    URL:         @uref{ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}, Download RTEMS components}
-    URL:         ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}
+@c    URL:         @uref{ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/@value{VERSION}, Download RTEMS components}
+    URL:         ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/@value{VERSION}
 @end ifset
 @end example
 
-@subheading RTEMS Hello World
+@subheading RTEMS Examples including Hello World
 @example
     FTP Site:    @value{RTEMSFTPSITE}
-    Directory:   @value{RTEMSFTPDIR}
-    File:        hello_world_c.tgz
-    URL:         @uref{ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/hello_world_c.tgz,,ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/hello_world_c.tgz}
+    Directory:   @value{RTEMSFTPDIR}/@value{VERSION}
+    File:        examples-@value{VERSION}.tar.bz2
+    URL:         @uref{ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/@value{VERSION}/examples-@value{VERSION}.tar.bz2,,ftp://@value{RTEMSFTPSITE}@value{RTEMSFTPDIR}/@value{VERSION}/examples-@value{VERSION}.tar.bz2}
 @end example
 

doc/started/intro.t

@@ -138 +138 @@
 The RTEMS Project provides formatted documentation for the primary
 tools in the cross development toolset including BINUTILS, GCC,
-NEWLIB, and GDB at
-@uref{http://www.oarcorp.com/rtemsdoc-4.5.0, http://www.oarcorp.com/rtemsdoc-4.5.0}.
+NEWLIB, and GDB with the pre-built versions of those tools.
 
 Much of the documentation is available at other sites on the Internet.
@@ -148 +147 @@
 
 @item Free Software Foundation
-@uref{http://www.gnu.org/manual/manual.html, http://www.gnu.org/manual/manual.html}
+@uref{http://www.gnu.org/manual/manual.html,
+http://www.gnu.org/manual/manual.html}
 
 @item Delorie Software
@@ -178 +178 @@
 @uref{http://www.objsw.com/CrossGCC/,CrossGCC FAQ}.
 
-The CrossGCC FAQ as well as a number of patches and utilities
-of interest to cross development system users are available
-at @uref{ftp://ftp.cygnus.com/pub/embedded/crossgcc}.
+The CrossGCC FAQ and Wiki are are available
+at @uref{http://www.billgatliff.com,http://www.billgatliff.com}.
 
 @subsection GCC Mailing Lists

doc/started/require.t

@@ -22 +22 @@
 |              Component             |   Disk Space Required    |
 +------------------------------------+--------------------------+
-|        archive directory           |        35 Mbytes         |
-|        tools src unarchived        |       150 Mbytes         |
-|  each individual build directory   |     up to 500 Mbytes     |
+|        archive directory           |        55 Mbytes         |
+|        tools src unarchived        |       350 Mbytes         |
+|  each individual build directory   |     up to 750 Mbytes     |
 |     each installation directory    |      20-200 Mbytes       |
 +------------------------------------+--------------------------+
@@ -185 +185 @@
 the storage of source archives and patches as well as for building the
 tools is up to the user.  The only concern is that there be enough
-disk space to complete the build.
+disk space to complete the build.  In this document, the following
+organization will be used.
 
 Make an @code{archive} directory to contain the downloaded

doc/started/sample.t

@@ -258 +258 @@
 How this executable is downloaded to the target board is very dependent
 on the BOARD_SUPPORT_PACKAGE selected.
-----------------------------------------------------
 
 @c
@@ -265 +264 @@
 @section More Information on RTEMS Application Makefiles
 
-The hello world sample application is a simple example of an
-RTEMS application that uses the RTEMS Application Makefile 
+These sample applications are examples of simple
+RTEMS applications that use the RTEMS Application Makefile 
 system.  This Makefile system simplifies building
 RTEMS applications by providing Makefile templates and

doc/started/tversions.texi.in

@@ -89 +89 @@
 @set RTEMSTAR       @value{RTEMSUNTAR}.tar.bz2
 @set RTEMSFTPSITE   ftp.rtems.com
-@set RTEMSFTPDIR    /pub/rtems/releases/@value{VERSION}
+@set RTEMSFTPDIR    /pub/rtems