diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index f0024acf3c63..96f3921985c8 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,3 +1,13 @@ +2003-06-24 Benjamin Kosnik + + * docs/html/documentation.html: Remove assignment info. + * docs/html/17_intro/contribute.html: Edits. + * docs/html/17_intro/libstdc++-assign.tx: Remove. + + * docs/html/test.html: Update. + + * README: Update. + 2003-06-24 Benjamin Kosnik Ulrich Drepper diff --git a/libstdc++-v3/README b/libstdc++-v3/README index 67c390e981dc..b3e860ceaf17 100644 --- a/libstdc++-v3/README +++ b/libstdc++-v3/README @@ -54,11 +54,15 @@ It has subdirectories: Headers that define extensions to the standard library. No standard header refers to any of them. + scripts + Scripts that are used during the configure, build, make, or test + process. + src Files that are used in constructing the library, but are not installed. - testsuites/[thread, 17_* to 27_*] + testsuites/[backward, demangle, ext, performance, thread, 17_* to 27_*] Test programs are here, and may be used to begin to exercise the library. Support for "make check" and "make check-install" is complete, and runs through all the subdirectories here when this @@ -72,17 +76,14 @@ Other subdirectories contain variant versions of certain files that are meant to be copied or linked by the configure script. Currently these are: + config/abi config/cpu - config/os config/io config/locale + config/os In addition, three subdirectories are convenience libraries: - libio - Contains the subset of the GNU libio library needed for - C++. Currently not used. - libmath Support routines needed for C++ math. Only needed if the underlying "C" implementation is non-existent, in particular diff --git a/libstdc++-v3/docs/html/17_intro/contribute.html b/libstdc++-v3/docs/html/17_intro/contribute.html index 17bc65f4ed02..3219f16da0ec 100644 --- a/libstdc++-v3/docs/html/17_intro/contribute.html +++ b/libstdc++-v3/docs/html/17_intro/contribute.html @@ -11,8 +11,10 @@

How to contribute

-

-The Standard C++ Library v3, or libstc++-2.90.x, follows an open development model. Active contributors are assigned maintainer-ship responsibility, and given write access to the CVS repository. First time submitors and all other potential contributors should follow this procedure: +

The Standard C++ Library v3, follows an open development +model. Active contributors are assigned maintainer-ship +responsibility, and given write access to the CVS repository. First +time contributors should follow this procedure:

@@ -33,9 +35,8 @@ and their web-site is right buy the standard on-line.) -
  • The library working group bugs, and known defects, can be obtained at these web sites: +
  • The library working group bugs, and known defects, can be obtained here: http://www.dkuug.dk/jtc1/sc22/wg21 - and http://www.comeaucomputing.com/iso/
  • The newsgroup dedicated to standardization issues is comp.std.c++: this FAQ for this group is quite useful and can be found here . @@ -60,11 +61,31 @@ and their web-site is right Small changes can be accepted without a copyright assignment form on file. New code and additions to the library need completed copyright assignment form on file at the FSF. Note: your employer may be required -to fill out appropriate disclaimer forms as well. Here is the form. +to fill out appropriate disclaimer forms as well. +

    -Please contact Benjamin +

    Historically, the libstdc++ assignment form added the following question: +

    + +[Which Belgian comic book character is better, Tintin or +Asterix, and why?] + +

    +While not strictly necessary, humoring the maintainers and answering +this question would be appreciated. +

    + +

    +For more information about getting a copyright assignment, please see + Legal Issues +

    + +

    +Please contact Benjamin Kosnik if you are confused about the assignment or have general -licensing questions. +licensing questions. When requesting an assignment form from assign@gnu.org, please cc +the above libstdc++ maintainer so that progress can be monitored.

    @@ -82,7 +103,7 @@ response from the maintainers) it would have all of these pieces:
  • A description of the bug and how your patch fixes this bug. For new features a description of the feature and your implementation.
    • -
  • A ChangeLog entry as plaintext; see the various ChangeLog files +
  • A ChangeLog entry as plain text; see the various ChangeLog files for format and content. If using you are using emacs as your editor, simply position the insertion point at the beginning of your change and hit CX-4a to bring up the appropriate ChangeLog @@ -98,7 +119,7 @@ response from the maintainers) it would have all of these pieces:
  • When you have all these pieces, bundle them up in a mail message and send it to libstdc++@gcc.gnu.org. All patches and related -discussion should be sent to the libstdc++ mailinglist.
    • +discussion should be sent to the libstdc++ mailing list. diff --git a/libstdc++-v3/docs/html/17_intro/libstdc++-assign.txt b/libstdc++-v3/docs/html/17_intro/libstdc++-assign.txt deleted file mode 100644 index c9e8ee2b0a21..000000000000 --- a/libstdc++-v3/docs/html/17_intro/libstdc++-assign.txt +++ /dev/null @@ -1,129 +0,0 @@ -The way to assign copyright to the Free Software Foundation is to sign -an assignment contract. This is what legally makes the Free Software -Foundation the copyright holder so that we can register the copyright -on the new version. I'm assuming that you wrote these changes -yourself; if other people wrote parts, we may need papers from them. - -If you are employed to do programming (even at a university), or have -made an agreement with your employer or school saying it owns programs -you write, then you and we need a signed piece of paper from your -employer disclaiming rights to the program. - -The disclaimer should be signed by a vice president or general manager -of the company. If you can't get at them, anyone else authorized to -license software produced there will do. Here is a sample wording: - - Digital Stimulation Corporation hereby disclaims all copyright interest - in the changes and enhancements made by Hugh Heffner to the program - "libstdc++", also including any future revisions of these changes and - enhancements. - - Digital Stimulation Corporation affirms that it has no other - intellectual property interest that would undermine this release, or - the use of the Program, and will do nothing to undermine it in the - future. - - , 1 April 1987 - Ty Coon, President of Vice, Digital Stimulation Corp. - -(If your employer says they do have an intellectual property claim -that could conflict with the use of the program, then please put me in -touch with a suitable representative of the company, so that we can -negotiate what to do about it.) - -IMPORTANT: When you talk to your employer, *no matter what -instructions they have given you*, don't fail to show them the sample -disclaimer above, or a disclaimer with the details filled in for your -specific case. Companies are usually willing to sign a disclaimer -without any fuss. If you make your request less specific, you may -open Pandora's box and cause a long and unnecessary delay. - -Below is the assignment contract that we usually use. You need -to print it out, sign it, and snail it to: - -Copyright Clerk -c/o Free Software Foundation -59 Temple Place - Suite 330 -Boston, MA 02111-1307, USA - -Please try to print the whole first page below on a single piece of -paper. If it doesn't fit on one printed page, put it on two sides of -a single piece of paper. - -Don't forget to put down the date when you sign! Spell out the month -name--don't use a number for the month. Dates using a number for the -month are ambiguous; 2/8/95 means one thing in the US and another in -Europe. - -Snail a copy of the employer's disclaimer as well. - -Please send me email about what you decide to do. If you have any -questions, or would like something to be changed, ask bkoz@gnu.org via -email. - ASSIGNMENT - - For good and valuable consideration, receipt of which I -acknowledge, I, [your name here], hereby transfer to the Free Software -Foundation, Inc. (the "Foundation") my entire right, title, and -interest (including all rights under copyright) in my changes and -enhancements to the libstdc++ library, subject to the conditions -below. These changes and enhancements are herein called the "Work". -The work hereby assigned shall also include any future revisions of -these changes and enhancements hereafter made by me. - - Upon thirty days' prior written notice, the "Foundation" agrees to -grant me non-exclusive rights to use the Work (i.e. my changes and -enhancements, not the program which I enhanced) as I see fit; (and -the "Foundation"'s rights shall otherwise continue unchanged). - - I hereby agree that if I have or acquire hereafter any patent or -interface copyright or other intellectual property interest dominating -the program enhanced by the Work (or use of that program), such -dominating interest will not be used to undermine the effect of this -assignment, i.e. the "Foundation" and the general public will be -licensed to use, in that program and its derivative works, without -royalty or limitation, the subject matter of the dominating interest. -This license provision will be binding on my heirs, assignees, or -other successors to the dominating interest, as well as on me. - - I hereby represent and warrant that I am the sole copyright holder -for the Work and that I have the right and power to enter into this -contract. I hereby indemnify and hold harmless the "Foundation", its -officers, employees, and agents against any and all claims, actions or -damages (including attorney's reasonable fees) asserted by or paid to -any party on account of a breach or alleged breach of the foregoing -warranty. I make no other express or implied warranty (including -without limitation, in this disclaimer of warranty, any warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE). - -Agreed: [signature] Date [Write the month with LETTERS]: - - -For the "Foundation", -Richard Stallman, head dude in charge - -Please do not delete the control-l character before this line. -Please print this as a separate page. - -Please email a copy of the information on this page to -fsf-records@gnu.ai.mit.edu, and cc bkoz@gnu.org, if you can, so that -our clerk doesn't have to type it in. Use your full name as the -subject line. - -[For the copyright registration, what country are you a citizen of? -What year were you born?] - - -[Please write your email address here.] - - -[Please write your snail address here, so we can snail a copy back to you.] - - - -[Which files have you changed so far, and which new files have you written -so far?] - - -[Which Belgian comic book character is better, Tintin or Asterix, and why?] - diff --git a/libstdc++-v3/docs/html/documentation.html b/libstdc++-v3/docs/html/documentation.html index 68f79f7f3c44..2e9a811873ba 100644 --- a/libstdc++-v3/docs/html/documentation.html +++ b/libstdc++-v3/docs/html/documentation.html @@ -239,7 +239,6 @@

    Contributor-Specific Information

    • Contributor checklist
      • -
    • Copyright assignment form for libstdc++-v3
    • Getting CVS write access (look for "Write after approval")
    • BADNAMES diff --git a/libstdc++-v3/docs/html/test.html b/libstdc++-v3/docs/html/test.html index 42d7d763bb88..4d2dc536dc39 100644 --- a/libstdc++-v3/docs/html/test.html +++ b/libstdc++-v3/docs/html/test.html @@ -189,8 +189,7 @@ cat 27_io/objects/char/3_xin.in | a.out specific file name. This indicates a test that is used to analyze runtime performance, for performance regression testing, or for other optimization related analysis. At the moment, these - test cases are not run by default, and instead assumed to be run - manually. + test cases are not run by default.

    @@ -251,6 +250,19 @@ cat 27_io/objects/char/3_xin.in | a.out

    +
  • + testsuite_performance.h +

    + A number of class abstractions for performance counters, and + reporting functions including: +

    +
      +
    • time_counter
      • +
    • resource_counter
      • +
    • report_performance
      • +
    +

    +
  • printnow.c

    @@ -476,7 +488,7 @@ make check-target-libstdc++-v3 RUNTESTFLAGS="--target_board=arm-sim"

    In addition, there are some testing options that are mostly of interest to library maintainers and system integrators. As such, these tests may not work on all cpu and host combinations, and must - be executed in the libbuilddir directory. These options + be executed in the libbuilddir/testsuite directory. These options include, but are not necessarily limited to, the following:

    @@ -508,7 +520,17 @@ make check-target-libstdc++-v3 RUNTESTFLAGS="--target_board=arm-sim" 
        make check-abi

    The library ABI can be tested. This involves testing the shared - library against an ABI-defining previous version.

    + library against an ABI-defining previous version.

    + + 
    +   make check-performance
    +

    This rule runs through the testsuite_files_performance + test cases and collects information for performance analysis and + can be used to spot performance regressions. Various timing + information is collected, as well as number of hard page faults, + and memory used. This is not run by default, and the implementation + is in flux. +

    We are interested in any strange failures of the