From 1860e6ab056942060d4f9d326cb74d6bac640200 Mon Sep 17 00:00:00 2001 From: Jonathan Wakely Date: Tue, 20 Aug 2002 00:44:19 +0000 Subject: [PATCH] configopts.html, [...]: Conform to HTML 4.01 standard. 2002-08-19 Jonathan Wakely * docs/html/configopts.html, docs/html/documentation.html, docs/html/install.html, docs/html/22_locale/codecvt.html, docs/html/22_locale/ctype.html, docs/html/22_locale/howto.html, docs/html/22_locale/locale.html, docs/html/22_locale/messages.html: Conform to HTML 4.01 standard. From-SVN: r56449 --- libstdc++-v3/ChangeLog | 8 ++ libstdc++-v3/docs/html/22_locale/codecvt.html | 16 ++- libstdc++-v3/docs/html/22_locale/ctype.html | 18 +-- libstdc++-v3/docs/html/22_locale/howto.html | 10 +- libstdc++-v3/docs/html/22_locale/locale.html | 7 +- .../docs/html/22_locale/messages.html | 9 +- libstdc++-v3/docs/html/configopts.html | 9 +- libstdc++-v3/docs/html/documentation.html | 3 +- libstdc++-v3/docs/html/install.html | 117 +++++++++--------- 9 files changed, 112 insertions(+), 85 deletions(-) diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index 206d7729b18..92f9ecb07d8 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,3 +1,11 @@ +2002-08-19 Jonathan Wakely + + * docs/html/configopts.html, docs/html/documentation.html, + docs/html/install.html, docs/html/22_locale/codecvt.html, + docs/html/22_locale/ctype.html, docs/html/22_locale/howto.html, + docs/html/22_locale/locale.html, + docs/html/22_locale/messages.html: Conform to HTML 4.01 standard. + 2002-08-15 Benjamin Kosnik * include/ext/stdio_filebuf.h (stdio_filebuf): Explicitly set diff --git a/libstdc++-v3/docs/html/22_locale/codecvt.html b/libstdc++-v3/docs/html/22_locale/codecvt.html index 46147d90556..a841c35fbce 100644 --- a/libstdc++-v3/docs/html/22_locale/codecvt.html +++ b/libstdc++-v3/docs/html/22_locale/codecvt.html @@ -1,14 +1,19 @@ + + + Notes on the codecvt implementation. + + +

Notes on the codecvt implementation.

- +

prepared by Benjamin Kosnik (bkoz@redhat.com) on August 28, 2000 -

1. Abstract

@@ -142,14 +147,14 @@ includes:

-
+
Identifiers for each of the codesets involved in the conversion. For example, using the iconv family of functions from the Single Unix Specification (what used to be called X/Open) hosted on the GNU/Linux operating system allows bi-directional mapping between far more than the following tantalizing possibilities: -
+
(An edited list taken from `iconv --list` on a Red Hat 6.2/Intel system:
@@ -519,4 +524,5 @@ System Interface Definitions, Issue 6 (IEEE Std. 1003.1-200x) The Open Group/The Institute of Electrical and Electronics Engineers, Inc. http://www.opennc.org/austin/docreg.html - + + diff --git a/libstdc++-v3/docs/html/22_locale/ctype.html b/libstdc++-v3/docs/html/22_locale/ctype.html index 3568145c92e..a47d9f81ef0 100644 --- a/libstdc++-v3/docs/html/22_locale/ctype.html +++ b/libstdc++-v3/docs/html/22_locale/ctype.html @@ -1,9 +1,14 @@ + + + Notes on the ctype implementation. + + +
Notes on the ctype implementation.
- prepared by Benjamin Kosnik (bkoz@redhat.com) on August 30, 2000 @@ -60,15 +65,13 @@ to wchar_t and wcsrtombs for conversions between wchar_t and char. Neither of these two required specializations deals with Unicode characters. As such, libstdc++-v3 implements - -

5. Examples
```
-  typedef ctype cctype;
+  typedef ctype<char> cctype;
 
```
More information can be found in the following testcases: @@ -98,10 +101,10 @@ More information can be found in the following testcases: straighten out the configure-time mess that is a by-product of this class? -
get the ctype::mask stuff under control. Need to +
get the ctype<wchar_t>::mask stuff under control. Need to make some kind of static table, and not do lookup evertime somebody hits the do_is... functions. Too bad we can't just - redefine mask for ctype + redefine mask for ctype<wchar_t>
rename abstract base class. See if just smash-overriding is a better approach. Clarify, add sanity to naming. @@ -143,4 +146,5 @@ System Interface Definitions, Issue 6 (IEEE Std. 1003.1-200x) The Open Group/The Institute of Electrical and Electronics Engineers, Inc. http://www.opennc.org/austin/docreg.html - + + diff --git a/libstdc++-v3/docs/html/22_locale/howto.html b/libstdc++-v3/docs/html/22_locale/howto.html index e1e58056604..b8fe45d1e59 100644 --- a/libstdc++-v3/docs/html/22_locale/howto.html +++ b/libstdc++-v3/docs/html/22_locale/howto.html @@ -1,4 +1,4 @@ - + @@ -49,6 +49,7 @@

The following is the abstract from the implementation notes: +

The standard class codecvt attempts to address conversions between different character encoding schemes. In particular, the standard @@ -64,7 +65,6 @@ the required specializations for wide and narrow characters and the implementation-provided extended functionality are given.
-

class ctype
@@ -88,13 +88,13 @@ description of locales and how to use them.

He also writes: +

Please note that I still consider this detailed description of locales beyond the needs of most C++ programmers. It is written with experienced programmers in mind and novices will do best to avoid it.
-

Nathan Myers on Locales
@@ -131,6 +131,7 @@ is created. Then member functions of that locale are called to perform minor tasks. Continuing the example from Chapter 21, we wish to use the following convenience functions: +
```
    namespace std {
      template <class charT>
@@ -140,6 +141,7 @@
        charT
        tolower (charT c, const locale& loc) const;
    }
```
+
This function extracts the appropriate "facet" from the locale loc and calls the appropriate member function of that facet, passing c as its argument. The resulting character @@ -154,6 +156,7 @@ parameter. So we write simple wrapper structs to handle that.

The next-to-final version of the code started in Chapter 21 looks like: +
```
    #include <iterator>    // for back_inserter
    #include <locale>
@@ -195,7 +198,6 @@
       std::string  capital_s;
       std::transform(s.begin(), s.end(), std::back_inserter(capital_s), up);
    }
```
-

The final version of the code uses bind2nd to eliminate the wrapper structs, but the resulting code is tricky. I have not shown it here because no compilers currently available to me will diff --git a/libstdc++-v3/docs/html/22_locale/locale.html b/libstdc++-v3/docs/html/22_locale/locale.html index 859050f23fa..630f59986f1 100644 --- a/libstdc++-v3/docs/html/22_locale/locale.html +++ b/libstdc++-v3/docs/html/22_locale/locale.html @@ -1,9 +1,14 @@ + + + Notes on the locale implementation. + + +
Notes on the locale implementation.
- prepared by Benjamin Kosnik (bkoz@redhat.com) on August 8, 2001 diff --git a/libstdc++-v3/docs/html/22_locale/messages.html b/libstdc++-v3/docs/html/22_locale/messages.html index 86c278c27b7..39ee9cfbee7 100644 --- a/libstdc++-v3/docs/html/22_locale/messages.html +++ b/libstdc++-v3/docs/html/22_locale/messages.html @@ -1,9 +1,14 @@ + -
+ Notes on the messages implementation. - </h1> + + +
+Notes on the messages implementation. +
prepared by Benjamin Kosnik (bkoz@redhat.com) on August 8, 2001 diff --git a/libstdc++-v3/docs/html/configopts.html b/libstdc++-v3/docs/html/configopts.html index 204aba51136..4fae2659799 100644 --- a/libstdc++-v3/docs/html/configopts.html +++ b/libstdc++-v3/docs/html/configopts.html @@ -34,6 +34,7 @@ options
The canonical way to find out the configure options that are available for a given set of libstdc++ sources is to go to the source directory and then type: ./configure --help +
--enable-multilib [default] @@ -156,16 +157,18 @@ options the following puts all the libstdc++ headers into a directory called "2.97-20001008" instead of the usual "g++-v3". +

--with-gxx-include-dir=/foo/H-x86-gcc-3-c-gxx-inc/include/2.97-20001008
-
--enable-cxx-flags=FLAGS
With this option, you can pass a string of -f (functionality) flags to the compiler to use when building libstdc++. FLAGS is a quoted string of options, like +

--enable-cxx-flags='-fvtable-gc -fomit-frame-pointer -ansi'
+
Note that the flags don't necessarily have to all be -f flags, as shown, but usually those are the ones that will make sense for experimentation and configure-time overriding. @@ -176,12 +179,13 @@ options as well, so that everything matches.

Fun flags to try might include combinations of +

-fstrict-aliasing -fno-exceptions -ffunction-sections -fvtable-gc
- and opposite forms (-fno-) of the same. Tell us (the libstdc++ +
and opposite forms (-fno-) of the same. Tell us (the libstdc++ mailing list) if you discover more!
@@ -211,7 +215,6 @@ options on. Hopefully people will volunteer to do other 'style' options.
-

Return to the top of the page or to the libstdc++ homepage.
diff --git a/libstdc++-v3/docs/html/documentation.html b/libstdc++-v3/docs/html/documentation.html index 735dc31e850..8987a521d06 100644 --- a/libstdc++-v3/docs/html/documentation.html +++ b/libstdc++-v3/docs/html/documentation.html @@ -1,3 +1,4 @@ + TODO - tasks yet undone

@@ -65,7 +65,6 @@

"the latest collection" (for the snapshot or later; see the date on the first page) -

This generated HTML collection, as above, is also available for download in the libstdc++ snapshots directory at <URL:ftp://gcc.gnu.org/pub/gcc/libstdc++/doxygen/>. diff --git a/libstdc++-v3/docs/html/install.html b/libstdc++-v3/docs/html/install.html index a76a932d92e..6c2f6668d92 100644 --- a/libstdc++-v3/docs/html/install.html +++ b/libstdc++-v3/docs/html/install.html @@ -88,46 +88,45 @@ features if the underlying support is present.

Finally, a few system-specific requirements: -

linux - -

If you are using gcc 3.1 or later on linux, and are using - the gnu locale model (enabled by default for sufficient - versions of glibc), the following locales are used and tested - in the libstdc++ testsuites: en_HK, en_US, fr_FR, fr_FR@euro, - de_DE, de_DE@euro, ja_JP.eucjp, and it_IT. Failure to have the - underlying "C" library locale information installed will mean - that C++ named locales for the above regions will not work: - because of this, the libstdc++ testsuite will not pass the - named locale tests. If this isn't an issue, don't worry about - it. If named locales are needed, the underlying locale - information must be installed. Note that rebuilding libstdc++ - after locales are installed is not necessary. - -

To install - support for locales, do only one of the following:

install all locales -

export LC_ALL=C

rpm -e glibc-common --nodeps

rpm -i --define "_install_langs all" - glibc-common-2.2.5-34.i386.rpm

install just the necessary locales -

localedef -i de_DE -f ISO-8859-1 de_DE

Finally, a few system-specific requirements:

linux

If you are using gcc 3.1 or later on linux, and are using + the gnu locale model (enabled by default for sufficient + versions of glibc), the following locales are used and tested + in the libstdc++ testsuites: en_HK, en_US, fr_FR, fr_FR@euro, + de_DE, de_DE@euro, ja_JP.eucjp, and it_IT. Failure to have the + underlying "C" library locale information installed will mean + that C++ named locales for the above regions will not work: + because of this, the libstdc++ testsuite will not pass the + named locale tests. If this isn't an issue, don't worry about + it. If named locales are needed, the underlying locale + information must be installed. Note that rebuilding libstdc++ + after locales are installed is not necessary. + +

To install + support for locales, do only one of the following:

install all locales +
export LC_ALL=C
+
rpm -e glibc-common --nodeps
+
rpm -i --define "_install_langs all" + glibc-common-2.2.5-34.i386.rpm
+
install just the necessary locales +
localedef -i de_DE -f ISO-8859-1 de_DE
+

Setting up the source directories

The following definitions will be used throughout the rest of this document: +

gccsrcdir: The directory holding the source of the compiler. It should have several subdirectories like @@ -142,7 +141,7 @@ the compiler/libraries, set with the --prefix option to the configure script.

Note:

The 3.0 version and following are intended to replace the library that comes with the compiler, so libsrcdir @@ -153,28 +152,27 @@ separate directories. Please don't build out of the source directory.

Check out or download the GCC sources: the resulting source directory (gcc or gcc-3.0.3, for example) is gccsrcdir. Once in gccsrcdir, you'll need to rename or delete the libstdc++-v3 directory which comes with that snapshot: -

+   
+       mv libstdc++-v3 libstdc++-v3-previous  [OR]
    rm -r libstdc++-v3
-   
    Next, unpack the libstdc++-v3 library tarball into this
       gccsrcdir directory; it will create a
       libsrcdir called libstdc++-version:
-      
-   gzip -dc libstdc++-version.tar.gz | tar xf -
    
+   +   gzip -dc libstdc++-version.tar.gz | tar xf -
    Finally, rename libsrcdir to libstdc++-v3 so that
       gcc's configure flags will be able to deal with the new library.
-      
-   mv libsrcdir libstdc++-v3
    
+   +   mv libsrcdir libstdc++-v3
 
 
 
@@ -193,10 +191,9 @@
       building the C++ language parts.
    
 
-   
+       cd gccbuilddir
    gccsrcdir/configure --prefix=destdir --other-opts...
-   
 
 
 
@@ -214,9 +211,10 @@
    
 
    [re]building only libstdc++
-   To rebuild just libstdc++, use:
-      
+   To rebuild just libstdc++, use: 
+       make all-target-libstdc++-v3
+   
       This will configure and build the C++ library in the
       gccbuilddir/cpu-vendor-os/libstdc++ directory.
    
@@ -229,39 +227,38 @@
       information is causing problems, you can delete it entirely, or
       simply edit it and remove lines.
    
-   You're done.  Now install the rebuilt pieces with
-      
+   You're done.  Now install the rebuilt pieces with
+       make install
-      or
-      +   or
+       make install-gcc
    make install-target-libstdc++-v3
-   
 
 
 
 Post-installation
    Installation will create the destdir directory and
       populate it with subdirectories:
-      
+   
+       lib/
    include/g++-v3/
       backward/
       bits/
       cpu-vendor-os/bits/
       ext/
-   
    If you used the version-specific-libs configure option, then most of
       the headers and library files will be moved under
       lib/gcc-lib/ instead.
    
-   You can check the status of the build without installing it using
-      
+   You can check the status of the build without installing it using
+       make check
-      or you can check the status of the installed library using
-      +   or you can check the status of the installed library using
+       make check-install
-      in the libbuilddir directory.
+   in the libbuilddir directory.
       These commands will create a 'testsuite' directory underneath
       libbuilddir containing the results of the tests.  We are
       interested in any strange failures of the testsuite; please see
@@ -271,7 +268,7 @@
 
 

 Using the library
-   Find the new library at runtime (shared linking only)
+   Find the new library at runtime (shared linking only)
        If you only built a static library (libstdc++.a), or if you
           specified static linking, you don't have to worry about this.
           But if you built a shared library (libstdc++.so) and linked
@@ -281,6 +278,7 @@
        
Methods vary for different platforms and different styles, but
           the usual ones are printed to the screen during installation.
           They include:
+       
           
           At runtime set LD_LIBRARY_PATH in your environment correctly,
               so that the shared library for libstdc++ can be found and
@@ -298,7 +296,6 @@
   
More...?  Let us know!
               
           
-       
        Use the ldd(1) utility to show which library the system
           thinks it will get at runtime.
        
@@ -306,8 +303,6 @@
           you use Libtool to create your executables, these details are
           taken care of for you.
        
-   
-

Notes on the codecvt implementation.

1. Abstract

Notes on the ctype implementation.

5. Examples

class ctype

Nathan Myers on Locales

Notes on the locale implementation.

+ Notes on the messages implementation. - </h1> + + +

+Notes on the messages implementation. +

Setting up the source directories

[re]building only libstdc++

Post-installation

Using the library

Find the new library at runtime (shared linking only)