On 17/01/17 15:36 +0000, Jonathan Wakely wrote:
The closest thing we have to a version macro in libstdc++ is
__GLIBCXX__ which holds the valid of gcc/DATESTAMP from the source
tree. That's useless for version checking or feature testing because
snapshots have arbitrary values and there's no total order across
branches (a later date does not mean a "better" release with more
features implemented). This updates the docs to point out it isn't
very useful. I've also removed the list of release dates, linking to
the online release timeline instead, so we don't have to keep adding
to the list. This means the information is not included in the sources
and you need to be online to find a date, but since the dates are not
very useful anyway I don't think this is a problem.
PR libstdc++/69699
* doc/xml/manual/abi.xml (abi.versioning.history): Explain why the
_GLIBCXX__ macro is not useful. Remove redundant date information
and link to the GCC release timeline.
(abi.versioning.active): Move partial sentence into the previous
paragraph.
* doc/html/*: Regenerate.
Committed to trunk.
This fixes a typo pointed out by François. Committed to trunk.
commit d13820611693c189b5a1b1e5e1e75df0d8946452
Author: Jonathan Wakely <jwak...@redhat.com>
Date: Thu Jan 19 23:12:51 2017 +0000
Fix typo in recent doc updates
* doc/xml/manual/abi.xml: Fix typo.
* doc/html/manual/abi.html: Likewise.
diff --git a/libstdc++-v3/doc/xml/manual/abi.xml b/libstdc++-v3/doc/xml/manual/abi.xml
index f2b2ec3..cd76710 100644
--- a/libstdc++-v3/doc/xml/manual/abi.xml
+++ b/libstdc++-v3/doc/xml/manual/abi.xml
@@ -418,7 +418,7 @@ compatible.
<literal>20160427</literal> value of the macro in the 6.1.0 release,
but there are features supported in the 6.1.0 release that are not
supported in 5.4.0 release.
- You also can't test for the the exact values listed below to try and
+ You also can't test for the exact values listed below to try and
identify a release, because a snapshot taken from the gcc-5-branch on
2016-04-27 would have the same value for the macro as the 6.1.0 release
despite being a different version.
