Patch rtemsdoc-4.5.0-rc-0.diff from Ralf Corsepius <corsepiu@faw.uni-ulm.de>

which contains the bulk of converting the documentation tree to automake
and GNU conventions.  Comments follow:

This is the automake port of rtemsdoc.

To apply:

cvs co rtemsdoc
cd rtemsdoc
sh cvs-rm.sh
patch -p0 < rtemsdoc-4.5.0-rc-0.diff
sh cvs-add.sh

[Attention: cvs-rm.sh and cvs-add.sh directly modify cvs]

Known bugs:
1) src2html is not supported (yet? - Is this supposed to work?)
2) all *.pdf images now are generated on-the-fly, but not yet deleted
during "make distclean"
3) All supplements, including the templated ones, get build and
installed.
4) Building outside of the source tree is completely untested and very
likely does not work.
5) Make [ps|pdf] are not (yet) supported, make [dvi|info] are supported
by automake's default texinfo rules.

Fixing 2, 3 and 5 is almost trivial and needs to be done.
4) is a matter of testing and tool-properties, for now it is simply
untested.



General issues:
* gif vs jpg vs png. I would recommend to replace all images with pngs
  to avoid potential copyright issues (gif) or lack in quality (jpg, jpg
  is good for real world photographs, but extremely poor on artificial
  images, graphs).
* pdf images do net get placed correctly in pdf-documents.
* texinfo: We now use a local copy of texinfo-4.0's texinfo.tex in
  texinfo/texinfo.tex for generating infos. However pdftex's system-wide
  texinfo.tex and pdftexinfo.tex are used for generating *.dvi, *.ps, *.pdf.
* .cvsignore files still missing.
* I have renamed the supplements filename not to use c_<supplement>,
  because automake seems to have problems with it.

Notes:
* Again, I recommend not to put any generated files into CVS. Here, this
  comprises some *texi, all *.pdf and many *.html pages. Ie. I recommend
  to run make maintainer-clean before checking in any files.

* To get building started, this should be sufficient:
  ./bootstrap
  ./configure
  cd tools; make; cd ..
  make info

* To make a public tarball:
  [cvs co ; ./bootstrap]
  ./configure
  cd tools; make; cd ..
  make info
  [make clean]
  make dist
=> This generates a rtems-<version>.tar.gz in the toplevel directory.
=> Building the tools only is required after a "cvs co", but not in a
   distribution tarball.

1 files changed, 92 insertions, 0 deletions

diff --git a/doc/started/tversions.texi b/doc/started/tversions.texi
new file mode 100644
index 0000000000..5b93d6a3b4
--- /dev/null
+++ b/doc/started/tversions.texi
@@ -0,0 +1,92 @@
+@c
+@c  COPYRIGHT (c) 1988-1999.
+@c  On-Line Applications Research Corporation (OAR).
+@c  All rights reserved.
+@c
+@c  $Id$
+@c
+
+@c
+@c This file contains all toolset version dependent information
+@c
+
+@c 
+@c Comment out setting the "XYZ-RTEMSPATCH" variable if there is no 
+@c patch required.  The documentation will detect this and print 
+@c an appropriate message in a short section.
+@c 
+
+
+@c
+@c  GCC/EGCS Version
+@c
+
+@set GCC-VERSION     gcc 2.95.2
+@set GCC-TAR         gcc-2.95.2.tar.gz
+@set GCC-UNTAR       gcc-2.95.2
+@set GCC-FTPSITE     gcc.gnu.org
+@set GCC-FTPDIR      /pub/gcc/gcc-2.95.2
+@set GCC-HTTPDIR     /pub/gcc/releases/index.html
+@set GCC-RTEMSPATCH  gcc-2.95.2-rtems-20000106.diff
+
+@c
+@c  BINUTILS Version
+@c
+
+@c The "official" binutils
+@c @set BINUTILS-VERSION     binutils 2.9.1
+@c @set BINUTILS-TAR         binutils-2.9.1.tar.gz
+@c @set BINUTILS-UNTAR       binutils-2.9.1
+@c @set BINUTILS-FTPSITE     ftp.gnu.org
+@c @set BINUTILS-FTPDIR      /pub/gnu
+@c @set BINUTILS-RTEMSPATCH  binutils-2.9.1-rtems-diff-19981012.gz
+
+@c The "official" Linux binutils
+@set BINUTILS-VERSION     binutils 2.9.5.0.22
+@set BINUTILS-TAR         binutils-2.9.5.0.22.tar.gz
+@set BINUTILS-UNTAR       binutils-2.9.5.0.22
+@set BINUTILS-FTPSITE     ftp.varesearch.com
+@set BINUTILS-FTPDIR      /pub/support/hjl/binutils
+@set BINUTILS-RTEMSPATCH  binutils-2.9.5.0.22-rtems-20000114.diff
+
+@c When forced to use a snapshot
+@c @set BINUTILS-VERSION     gas 980314
+@c @set BINUTILS-TAR         gas-980314.tgz
+@c @set BINUTILS-UNTAR       gas-980314
+@c @set BINUTILS-FTPSITE     ftp.OARcorp.com
+@c @set BINUTILS-FTPDIR      /oarcorp/private/beta3/ada_tools
+@c @set BINUTILS-RTEMSPATCH  binutils-2.8.1-rtems-diff-1998xxxx.gz
+
+@c
+@c  NEWLIB Version
+@c
+
+@set NEWLIB-VERSION     newlib 1.8.2
+@set NEWLIB-TAR         newlib-1.8.2.tar.gz
+@set NEWLIB-UNTAR       newlib-1.8.2
+@set NEWLIB-FTPSITE     sourceware.cygnus.com
+@set NEWLIB-FTPDIR      /pub/newlib
+@set NEWLIB-RTEMSPATCH  newlib-1.8.2-rtems-20000104.diff
+
+@c
+@c  GDB Version
+@c
+
+@set GDB-VERSION     gdb 4.18
+@set GDB-TAR         gdb-4.18.tar.gz
+@set GDB-UNTAR       gdb-4.18
+@set GDB-FTPSITE     ftp.gnu.org
+@set GDB-FTPDIR      /pub/gnu/gdb
+@set GDB-RTEMSPATCH  gdb-4.18-rtems-20000107.diff
+
+@c
+@c  RTEMS Version
+@c
+
+@set RTEMS-VERSION   RTEMS 4.5.0-beta
+@set RTEMS-TAR       rtems-4.5.0-beta.tgz
+@set RTEMS-UNTAR     rtems-4.5.0-beta
+@set RTEMS-FTPSITE   ftp.OARcorp.com
+@set RTEMS-FTPDIR    /pub/rtems/releases/4.5.0-beta
+@set BUILDTOOLS-TAR  c_build_scripts-20000104.tgz
+