filter: New file.

2003-05-30  Phil Edwards  <pme@gcc.gnu.org>

	* docs/doxygen/filter:  New file.
	* docs/doxygen/filter.sed:  New file.
	* docs/doxygen/run_doxygen:  Add g flag to sed substitutions.  Duh.
	* docs/doxygen/user.cfg.in (INPUT_FILTER):  Point to new filter.
	* docs/html/documentation.html:  Fix links to doxygen pages.

From-SVN: r67249
This commit is contained in:
Phil Edwards 2003-05-30 19:12:56 +00:00
parent 6d7d3112bd
commit a75e519150
6 changed files with 66 additions and 17 deletions

View File

@ -1,3 +1,11 @@
2003-05-30 Phil Edwards <pme@gcc.gnu.org>
* docs/doxygen/filter: New file.
* docs/doxygen/filter.sed: New file.
* docs/doxygen/run_doxygen: Add g flag to sed substitutions. Duh.
* docs/doxygen/user.cfg.in (INPUT_FILTER): Point to new filter.
* docs/html/documentation.html: Fix links to doxygen pages.
2003-05-30 Paolo Carlini <pcarlini@unitus.it>
* include/bits/fstream.tcc (_M_convert_to_external): Don't

View File

@ -0,0 +1,13 @@
#!/bin/sh
script=$1
file=$2
# Possibly allow some files to go unchanged. Other
# future manipulations are likely.
case $file in
*/alloc_policies.h)
cat $file ;;
*) sed -f $script $file ;;
esac

View File

@ -0,0 +1,26 @@
# Input filter for doxygen.
# Copyright (C) 2003 Free Software Foundation, Inc.
# Phil Edwards <pme@gcc.gnu.org>
# single+capital is easy
s/_Tp/Type/g
s/_\([A-Z]\)/\1/g
# double+lower is not so easy; some names should be left alone.
# The following is a sloppy start. Possibly just require GNU tools
# and use extensions.
s/__a/a/g
s/__c/c/g
s/__first/first/g
s/__in/in/g
s/__last/last/g
s/__n/n/g
s/__out/out/g
s/__pred/pred/g
s/__position/position/g
s/__pos/position/g
s/__s/s/g
s/__value/value/g
s/__x/x/g
s/__y/y/g

View File

@ -134,8 +134,8 @@ test $do_man = yes && {
(
set -e
cd $builddir
sed -e "s=@outdir@=${outdir}=" \
-e "s=@srcdir@=${srcdir}=" \
sed -e "s=@outdir@=${outdir}=g" \
-e "s=@srcdir@=${srcdir}=g" \
-e "s=@html_output_dir@=html_${mode}=" \
-e "s=@enabled_sections@=${enabled_sections}=" \
-e "s=@do_html@=${do_html}=" \

View File

@ -384,6 +384,7 @@ RECURSIVE = YES
EXCLUDE = Makefile \
CVS \
include/bits/demangle.h \
stdc++.h.gch
# The EXCLUDE_SYMLINKS tag can be used select whether or not files or directories
@ -433,7 +434,7 @@ IMAGE_PATH =
# input file. Doxygen will then use the output that the filter program writes
# to standard output.
INPUT_FILTER =
INPUT_FILTER = "@srcdir@/docs/doxygen/filter @srcdir@/docs/doxygen/filter.sed"
# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using
# INPUT_FILTER) will be used to filter the input files when producing source
@ -459,7 +460,7 @@ INLINE_SOURCES = NO
# doxygen to hide any special comment blocks from generated source code
# fragments. Normal C and C++ comments will always remain visible.
STRIP_CODE_COMMENTS = YES
STRIP_CODE_COMMENTS = NO
# If the REFERENCED_BY_RELATION tag is set to YES (the default)
# then for each documented function all documented

View File

@ -67,24 +67,25 @@
the library classes, finding out what is in a particular include
file, looking at inheritance diagrams, etc.
</p>
<p>The Source-Level documentation can be viewed online:</p>
<p>The source-level documentation for the most recent releases can
be viewed online:
</p>
<ul>
<li><a href="libstdc++-html-USERS-3.1/index.html">for the 3.1 release</a>
</li>
<li><a href="libstdc++-html-USERS-3.2.1/index.html">for the 3.2.1 release</a>
</li>
<li><a href="latest-doxygen/index.html">&quot;the latest collection&quot;</a>
(for the snapshot or later; see the date on the first page)
</li>
<li><a href="libstdc++-html-USERS-3.3/index.html">for the 3.3 release</a></li>
<li><a href="latest-doxygen/index.html">&quot;the latest collection&quot;</a>
(for the main development tree; see the date on the first page)
</li>
</ul>
<p>This generated HTML collection, as above, is also available for download in
the libstdc++ snapshots directory at
<code>&lt;URL:ftp://gcc.gnu.org/pub/gcc/libstdc++/doxygen/&gt;</code>.
You will almost certainly need to use one of the <a
href="http://gcc.gnu.org/mirrors.html">mirror sites</a> to download
the tarball. After unpacking, simply load
libstdc++-html-*/index.html into a browser. Feedback (and
additional documentation!) is welcome.
You will almost certainly need to use one of the
<a href="http://gcc.gnu.org/mirrors.html">mirror sites</a> to download
the tarball. After unpacking, simply load libstdc++-html-*/index.html
into a browser.
</p>
<p>Documentation for older releases is available for download only, not
online viewing.
</p>
<p>In addition, an initial set of man pages are also available in the
same place as the HTML collections. Start with C++Intro(3).