This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
[wwwdocs] Testing C++ changes (was: [patch] Make vector::at() assertion message more useful)
- From: Gerald Pfeifer <gerald at pfeifer dot com>
- To: gcc-patches at gcc dot gnu dot org, libstdc++ at gcc dot gnu dot org, Jason Merrill <jason at redhat dot com>
- Cc: Paolo Carlini <paolo dot carlini at oracle dot com>
- Date: Mon, 6 Apr 2015 13:37:18 +0200 (CEST)
- Subject: [wwwdocs] Testing C++ changes (was: [patch] Make vector::at() assertion message more useful)
- Authentication-results: sourceware.org; auth=none
- References: <ye6qhae0qpf8 dot fsf at elbrus2 dot mtv dot corp dot google dot com> <CAGNvRgDfHf6pYmBYC66HHhj6RobhiaiAAVEKj1FDxSWGxbYFTg at mail dot gmail dot com> <CALoOobMf3u8R_DVW5b2eRy05fBpB5unhriLMYdUEkT_E3DwtaA at mail dot gmail dot com> <CAGNvRgD6mK=-n7QhK=-NtfXZHOpCniXKc-riWUNfqZeVa8xufQ at mail dot gmail dot com> <CALoOobO6XEsrSM6jJFCQ=n00iY8qM=eujs-=LixNZyuya5f-cA at mail dot gmail dot com> <5232E2AF dot 4000106 at oracle dot com> <CALoOobMejGJLVVCszP8Joa+4B21UbvK4chyFUnjiCNPP0GJF0A at mail dot gmail dot com> <mvma9j35377 dot fsf at hawking dot suse dot de> <52402567 dot 2080407 at oracle dot com> <mvm1u4f4v81 dot fsf at hawking dot suse dot de> <11cc3fe3-a8b9-43ff-a614-d4f374447236 at email dot android dot com> <alpine dot DEB dot 2 dot 10 dot 1309231542490 dot 4526 at stedding dot saclay dot inria dot fr>
On Mon, 23 Sep 2013, Marc Glisse wrote:
> http://gcc.gnu.org/contribute.html has an outdated section on testing.
> It mentions that you should do a bootstrap for a change to the C
> front-end (should also be for the C++ front-end and I guess libstdc++
> even if it isn't used much inside gcc).
Somehow nobody bit or did update contribute.html anyway, so here
is a patch to adjust this.
Jason, any other thoughts?
Gerald
Index: contribute.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/contribute.html,v
retrieving revision 1.85
diff -u -r1.85 contribute.html
--- contribute.html 27 Jun 2014 11:12:18 -0000 1.85
+++ contribute.html 6 Apr 2015 11:32:05 -0000
@@ -100,9 +100,9 @@
<h3>Which tests to perform</h3>
<p>If your change is to code that is not in a front end, or is to the
-C front end, you must perform a complete build of GCC and the runtime
-libraries included with it, on at least one target. You must
-bootstrap all default languages, not just C, and run all testsuites.
+C or C++ front ends, you must perform a complete build of GCC and the
+runtime libraries included with it, on at least one target. You must
+bootstrap all default languages, not just C and C++, and run all testsuites.
For a normal native configuration, running</p>
<blockquote><pre>
make bootstrap
@@ -111,17 +111,6 @@
<p>from the top level of the GCC tree (<strong>not</strong> the
<code>gcc</code> subdirectory) will accomplish this.</p>
-<p>If your change is to the C++ front end, you should rebuild the compiler,
-<code>libstdc++</code>, <code>libjava</code> and run the C++ testsuite.
-If you already did a complete C,C++,Java bootstrap from your build
-directory before, you can use the following:</p>
-<blockquote><pre>
-make clean-target-libstdc++-v3 # clean libstdc++ and ...
-test -d */libjava && make -C */libjava clean-nat # ... parts of libjava
-make all-target-libstdc++-v3 all-target-libjava # rebuild compiler and libraries
-make -k check-c++ # run C++/libstdc++ testsuite
-</pre></blockquote>
-
<p>If your change is to a front end other than the C or C++ front end,
or a runtime library other than <code>libgcc</code>, you need to verify
only that the runtime library for that language still builds and the