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 | 113 +++++++++--------- 9 files changed, 110 insertions(+), 83 deletions(-) diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index 206d7729b18d..92f9ecb07d81 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 46147d905562..a841c35fbce0 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 3568145c92e6..a47d9f81ef02 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 e1e580566044..b8fe45d1e595 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 859050f23fab..630f59986f16 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 86c278c27b7e..39ee9cfbee7e 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 204aba511361..4fae26597995 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 735dc31e8504..8987a521d063 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 a76a932d92e1..6c2f6668d924 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 +

    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. +
    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

    -
    • -

    -
    -
    +

    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: +

    Note:

    1. 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.
        
    
-   
-