2006-08-27 Joel Sherrill <joel@OARcorp.com>

* Makefile.am, configure.ac, develenv/direct.t: Remove gnu_docs. Now
	included with RPMs.
	* gnu_docs/.cvsignore, gnu_docs/ChangeLog, gnu_docs/Makefile.am,
	gnu_docs/Tool_Doc_Instructions, gnu_docs/gen_docs,
	gnu_docs/gnu_footer.html, gnu_docs/gnu_header.html,
	gnu_docs/index.html, gnu_docs/mk_install_dir, gnu_docs/refcard.html,
	gnu_docs/rtems_tools_index.html: Removed.
This commit is contained in:
Joel Sherrill
2006-08-27 15:07:35 +00:00
parent 896247d5e6
commit 45bcd282b4
15 changed files with 14 additions and 457 deletions
+10
View File
@@ -1,3 +1,13 @@
2006-08-27 Joel Sherrill <joel@OARcorp.com>
* Makefile.am, configure.ac, develenv/direct.t: Remove gnu_docs. Now
included with RPMs.
* gnu_docs/.cvsignore, gnu_docs/ChangeLog, gnu_docs/Makefile.am,
gnu_docs/Tool_Doc_Instructions, gnu_docs/gen_docs,
gnu_docs/gnu_footer.html, gnu_docs/gnu_header.html,
gnu_docs/index.html, gnu_docs/mk_install_dir, gnu_docs/refcard.html,
gnu_docs/rtems_tools_index.html: Removed.
2006-08-23 Joel Sherrill <joel@OARcorp.com>
* Makefile.am, configure.ac, index.html.in: FAQ should now be
+1 -1
View File
@@ -9,7 +9,7 @@ ACLOCAL_AMFLAGS = -I ../aclocal
SUBDIRS = tools started user bsp_howto porting develenv posix_users \
posix1003.1 filesystem itron3.0 networking ada_user started_ada \
rtems_gdb rgdb_specs new_chapters relnotes cpu_supplement gnu_docs
rtems_gdb rgdb_specs new_chapters relnotes cpu_supplement
if USE_HTML
html_DATA = index.html HELP.html
-1
View File
@@ -214,6 +214,5 @@ rgdb_specs/Makefile
relnotes/Makefile
new_chapters/Makefile
cpu_supplement/Makefile
gnu_docs/Makefile
])
AC_OUTPUT
+3 -12
View File
@@ -581,10 +581,6 @@ and PostScript.
@table @code
@item $@{RTEMS_ROOT@}/doc/FAQ/
This directory contains the source code for the @cite{RTEMS Frequently Asked
Questions (FAQ) Collection}.
@item $@{RTEMS_ROOT@}/doc/user/
This directory contains the source code for the @cite{RTEMS
Applications C User's Guide} which documents the Classic API.
@@ -620,11 +616,6 @@ capture the design of the interface between system
calls and filesystem implementations as well as the
information required by those implementing filesystems.
@item $@{RTEMS_ROOT@}/doc/gnu_docs/
This directory contains the scripts which assist in
generating HTML for the GNU tools in the RTEMS Cross
Development Environment set.
@item $@{RTEMS_ROOT@}/doc/images/
This directory contains the source code for the graphics
used in the HTML version of the RTEMS Documentation.
@@ -680,9 +671,9 @@ This directory contains the source code for the
This directory contains the source code for the
@cite{Getting Started with RTEMS for Ada Users} manual.
@item $@{RTEMS_ROOT@}/doc/supplements/
This directory contains the source code for the various
RTEMS CPU Supplements.
@item $@{RTEMS_ROOT@}/doc/cpu_supplement/
This directory contains the source code for the
RTEMS CPU Supplement.
the
@item $@{RTEMS_ROOT@}/doc/tools/
-2
View File
@@ -1,2 +0,0 @@
Makefile
Makefile.in
-24
View File
@@ -1,24 +0,0 @@
2003-12-12 Ralf Corsepius <corsepiu@faw.uni-ulm.de>
* Makefile.am: Cosmetics.
2003-12-11 Ralf Corsepius <corsepiu@faw.uni-ulm.de>
* Makefile.am: Cosmetics.
2003-09-19 Joel Sherrill <joel@OARcorp.com>
* gnu_footer.html, gnu_header.html, index.html, refcard.html,
rtems_tools_index.html: Merge from branch.
2002-03-27 Ralf Corsepius <corsepiu@faw.uni-ulm.de>
* Makefile.am: Remove AUTOMAKE_OPTIONS.
2002-01-18 Ralf Corsepius <corsepiu@faw.uni-ulm.de>
* Makefile.am: Require automake-1.5.
2000-08-10 Joel Sherrill <joel@OARcorp.com>
* ChangeLog: New file.
-5
View File
@@ -1,5 +0,0 @@
## $Id$
EXTRA_DIST = gnu_footer.html mk_install_dir Tool_Doc_Instructions \
gnu_header.html refcard.html gen_docs index.html rtems_tools_index.html \
gen_docs
-42
View File
@@ -1,42 +0,0 @@
#
# $Id$
#
Apparently, the tool documentation is tough to build without configuring
in the tool source directory. So you need to do some magic to make
this happen. In addition, the makefiles included with the tools
only support building dvi and info. So this directory is
trying to help finish out building the tool documentation.
# Odd Notes:
#
# binutils/ld: May have to copy bfdsumm.texi from config/bfd to ld
# gcc: no rule to build java.dvi
# for binutils, gcc, and gdb
mkdir doc_build
cp -r binutils-XXX gcc-XXX gdb-XXX newlib-XXX doc_build
cd TOOL-XXX
./configure --target=i386-rtems --prefix=/usr3/tmp/DOCTMP
make info dvi
# for newlib we have to do the build differently. It actually needs
# to be configured and built for an RTEMS target so pick something
# you have tools installed for. Hopefully, this will be a target
# without many multilib variants. The actual target is not relevant
# since the documentation is always the same.
mkdir b
cd b
../newlib-1.8.2/configure --target=i386-rtems --prefix=/usr3/tmp/DOCTMP
make
make info dvi
cd ../newlib-1.8.2
find newlib/ -name "*.t*" | cpio -pdum ../b/i386-rtems/
find etc/ -name "*.t*" | cpio -pdum ../b
cd ../b
# run the script
-164
View File
@@ -1,164 +0,0 @@
#! /bin/sh
#
# This script is intended to be run in the build directory of a software
# package including documentation in texinfo format. The basic operation
# of this script is to:
# + find all ".dvi" files from the current directory down,
# + for each dvi file
# + install the dvi file
# + generate PostScript files for the dvi file
# + install the PostScript file
# + if there is texinfo source for this dvi file
# install the info files
# generate PDF from the texinfo source
# install the PDF file
# generate HTML from the texinfo source
# install the HTML file
#
#
# Ralf... where do these come from using autoconf?
srcdir=/usr1/rtems/work/rtems-doc/
texi2www=${srcdir}/tools/texi2www/texi2www
gnu_docs=${srcdir}/gnu_docs
images=${srcdir}/images
install_base=/home/httpd/html/rtems/rtemsdoc-4.5.1-pre3
install_share=/home/httpd/html/rtems/rtemsdoc-4.5.1-pre3/share/toolsdoc
install_info=/home/httpd/html/rtems/rtemsdoc-4.5.1-pre3/info
#if [ $? -ne 1 ] ; then
# echo "Usage: $0 install_directory"
# exit 1
#fi
if [ ! -d ${install} ] ; then
echo "${install} is not a directory"
exit 1
fi
#ECHO=echo
STARTDIR=`pwd`
find . -name "*.dvi" | while read file
do
cd $STARTDIR
cd `dirname $file`
echo $file
i=`basename $file`
####
b=`echo $i | cut -d'.' -f1`
echo $b
if [ -d ${install}/${b} ] ; then
echo "Cleaning install point for ${b}"
${ECHO} rm -rf ${install}/html/${b}
fi
for dir_to_do in ${install_info} \
${install_share}/ps \
${install_share}/pdf ${install_share}/dvi \
${install_share}/html/${b}
do
test -d ${dir_to_do} || mkdir -p ${dir_to_do}
done
echo "Copying DVI for ${b}"
echo "+ cp ${b}.dvi ${install_share}/dvi/${b}.dvi"
${ECHO} cp ${b}.dvi ${install_share}/dvi/${b}.dvi
echo "Generating PS for ${b}"
echo "+ dvips -o ${install_share}/ps/${b}.ps ${b}.dvi"
${ECHO} dvips -o ${install_share}/ps/${b}.ps ${b}.dvi
# unfortunately the .dvi names are not always the same. :(
case ${b} in
history) tsrc=hist ;;
readline) tsrc=rlman ;;
*) tsrc=${b} ;;
esac
case ${b} in
refcard)
cp ${gnu_docs}/refcard.html ${install_share}/${b}
;;
*)
# for some reason chill installs the dvi 1 directory up.
test ${b} = "chill" && cd ch
if [ -r ${tsrc}.texi ] ; then
ext=texi
elif [ -r ${tsrc}.texinfo ] ; then
ext=texinfo
else
echo "***
echo "*** Cannot find a texi or texinfo file for ${b}"
echo "***
exit 1
fi
echo "Copying INFO for ${b}"
${ECHO} cp ${b}.info* ${install_info}
case ${b} in
g77) bad_for_pdf="yes" ;;
*) bad_for_pdf="no" ;;
esac
case ${b} in
gdb) extraargs_for_pdf="-I ../../readline/doc" ;;
*) extraargs_for_pdf="" ;;
esac
if [ ${bad_for_pdf} = "yes" ] ; then
echo "*** "
echo "*** Skipping PDF for ${b}"
echo "*** "
else
echo "Generating PDF for ${b}"
${ECHO} texi2pdf ${extraargs_for_pdf} ${tsrc}.${ext} && \
${ECHO} cp ${tsrc}.pdf ${install_share}/pdf/${b}.pdf
fi
# until texi2www is modified to take a search path
case ${b} in
gdb)
sed -e 's/^ @/@/' <../../readline/doc/rluser.texinfo >rluser.texinfo
cp ../../readline/doc/inc-hist.texi .
;;
readline)
cp rluser.texinfo rluser.texinfo.tmp
sed -e 's/^ @/@/' <../../readline/doc/rluser.texinfo >rluser.texinfo
rm -f rluser.texinfo.tmp
;;
*) ;;
esac
echo "Generating HTML for ${b}"
${ECHO} ${texi2www} \
-dirfile ../index.html \
-header ${gnu_docs}/gnu_header.html \
-footer ${gnu_docs}/gnu_footer.html \
-icons ../images -dir ${install_share}/html/${b} \
${tsrc}.${ext}
;;
esac
done
echo "Installing graphics"
test -d ${install_share}/html/images || mkdir ${install_share}/html/images
cd ${images}
for f in dir-arrow.gif dvi.gif missing-arrow.gif next-arrow.gif oaronly.jpg \
pdf.gif pdf1.gif prev-arrow.gif ps.gif up-arrow.gif
do
cp ${f} ${install_share}/html/images/${f}
done
echo "Installing top level HTML indices"
cp ${gnu_docs}/index.html ${install_share}/html/index.html
cp ${gnu_docs}/rtems_tools_index.html ${install_share}/../index.html
# Now deal with the reference card
set -x
test -d ${install_share}/html/refcard || mkdir ${install_share}/html/refcard
cp ${gnu_docs}/refcard.html ${install_share}/html/refcard/refcard.html
exit 0
-1
View File
@@ -1 +0,0 @@
<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.
-5
View File
@@ -1,5 +0,0 @@
<BODY BGCOLOR="FFFFFF">
<A HREF="http://www.rtems.com" target="Text Frame">
<IMG align=right BORDER=0 SRC="../images/rtems_logo.jpg" ALT="RTEMS Logo"></A>
<H1>RTEMS GNU Tools On-Line Library</H1>
<HR>
-143
View File
@@ -1,143 +0,0 @@
<HTML>
<HEAD><TITLE>RTEMS GNU Tools On-Line Library</TITLE></HEAD>
<BODY BGCOLOR="FFFFFF">
<A HREF="http://www.rtems.com" target="Text Frame">
<IMG align=right BORDER=0 SRC="images/rtems_logo.jpg" ALT="RTEMS Logo"> </A>
<H1>RTEMS GNU Tools On-Line Library</H1>
<HR>
<BODY>
<MENU>
<LI>GNU Compiler Collection (GCC) 2.95.2
<MENU>
<LI><A HREF="../pdf/gcc.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/gcc.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/gcc.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="gcc/index.html">
Using and Porting the GNU Compiler Collection (GCC)</A></LI>
<LI><A HREF="../pdf/cpp.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/cpp.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/cpp.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="cpp/index.html">
The C Preprocessor</A></LI>
<LI><A HREF="../pdf/chill.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/chill.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/chill.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="chill/index.html">
Guide to GNU Chill</A></LI>
<LI><A HREF="BAD.html"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/g77.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/g77.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="g77/index.html">
Using and Porting GNU Fortran</A></LI>
</MENU>
</LI>
<LI>GNU binutils 2.9.5.0.24
<MENU>
<LI><A HREF="../pdf/binutils.pdf">
<IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/binutils.ps">
<IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/binutils.dvi">
<IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="binutils/index.html">
GNU Binary Utilities</A></LI>
<LI><A HREF="../pdf/as.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/as.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/as.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="as/index.html">
Using the GNU Assembler</A></LI>
<LI><A HREF="../pdf/gasp.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/gasp.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/gasp.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="gasp/index.html">
GNU Preprocessor for Assembly Programs (gasp)</A></LI>
<LI><A HREF="../pdf/ld.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/ld.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/ld.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="ld/index.html">
Using the GNU Linker (ld)</A></LI>
</MENU>
</LI>
<LI>GNU gdb 4.18
<MENU>
<LI><A HREF="../pdf/gdb.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/gdb.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/gdb.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="gdb/index.html">
Debugging with GDB</A></LI>
<LI><A HREF="../pdf/gdbint.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/gdbint.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/gdbint.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="gdbint/index.html">
GDB Internals</A></LI>
<LI><A HREF="../pdf/stabs.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/stabs.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/stabs.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="stabs/index.html">
STABS Debugging Format</A></LI>
<LI><A HREF="refcard/refcard.html"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/refcard.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/refcard.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="refcard/refcard.html">
GDB Quick Reference Card</A></LI>
</MENU>
</LI>
<LI>Newlib 1.8.2
<MENU>
<LI><A HREF="../pdf/libc.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/libc.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/libc.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="libc/index.html">
libc</A></LI>
<LI><A HREF="../pdf/libm.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/libm.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/libm.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="libm/index.html">
libm</A></LI>
</MENU>
</LI>
<LI>GNU Libraries Used by Multiple Tools
<MENU>
<LI><A HREF="../pdf/history.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/history.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/history.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="history/index.html">
GNU History Library</A></LI>
<LI><A HREF="../pdf/readline.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/readline.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/readline.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="readline/index.html">
GNU Readline Library</A></LI>
<LI><A HREF="../pdf/mmalloc.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/mmalloc.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/mmalloc.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="mmalloc/index.html">
GNU Memory-Mapped Malloc Library (mmalloc)</A></LI>
<LI><A HREF="../pdf/bfd.pdf"><IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/bfd.ps"><IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/bfd.dvi"><IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="bfd/index.html">
GNU Binary File Descriptor (libbfd)</A></LI>
</MENU>
</LI>
<LI>General GNU Project Documentation
<MENU>
<LI><A HREF="../pdf/standards.pdf">
<IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../ps/standards.ps">
<IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="../dvi/standards.dvi">
<IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
<A HREF="standards/index.html">
GNU Coding Standards</A></LI>
</MENU>
</LI>
</MENU>
<HR>
Copyright &copy; 1988-2004 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>
</BODY></HTML>
-29
View File
@@ -1,29 +0,0 @@
#! /bin/sh
#
# This script creates the install infrastructure for the GNU tools
# documentation.
#
install=/usr3/rtems_cds/test_cd/doc/tools
#if [ $? -ne 1 ] ; then
# echo "Usage: $0 install_directory"
# exit 1
#fi
rm -rf ${install}
mkdir ${install}
mkdir ${install}/info
mkdir ${install}/html
cp rtems_tools_index.html ${install}/../index.html
cp index.html ${install}/html
cp ../BAD.html ${install}/html
cp ../tools/texi2www/*.gif ${install}/html
cp ../common/*arrow.gif ${install}/html
cp ../common/up-arrow.gif ${install}/html
cp ../common/oaronly.jpg ${install}/html
cp ../common/dvi.gif ${install}/html
cp ../common/pdf.gif ${install}/html
cp ../common/pdf1.gif ${install}/html
cp ../common/ps.gif ${install}/html
-13
View File
@@ -1,13 +0,0 @@
<HTML>
<HEAD><TITLE>GDB Reference Card</TITLE></HEAD>
<BODY BGCOLOR="FFFFFF">
<A HREF="http://www.rtems.com" target="Text Frame">
<IMG align=right BORDER=0 SRC="../rtems_logo.jpg" ALT="RTEMS Logo"> </A>
<H1>RTEMS On-Line Library</H1>
<HR>
<BODY>
The GDB Reference card is not written in texinfo file. There is currently
no HTML or PDF version of this file.
<HR>
Copyright &copy; 1988-2004 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>
</BODY></HTML>
-15
View File
@@ -1,15 +0,0 @@
<HTML>
<HEAD><TITLE>RTEMS and Tools On-Line Library</TITLE></HEAD>
<BODY BGCOLOR="FFFFFF">
<A HREF="http://www.rtems.com" target="Text Frame">
<IMG align=right BORDER=0 SRC="rtemsdoc/html/images/rtems_logo.jpg" ALT="RTEMS Logo"> </A>
<H1>RTEMS and Tools On-Line Library</H1>
<HR>
<BODY>
<MENU>
<LI><A HREF="rtemsdoc/html/index.html">RTEMS Documentation</A></LI>
<LI><A HREF="toolsdoc/html/index.html">GNU Documentation</A></LI>
</MENU>
<HR>
Copyright &copy; 1988-2004 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>
</BODY></HTML>