[libc++] Rewrite the tuple constructors to be strictly Standards conforming
This nasty patch rewrites the tuple constructors to match those defined
by the Standard. We were previously providing several extensions in those
constructors - those extensions are removed by this patch.
The issue with those extensions is that we've had numerous bugs filed
against us over the years for problems essentially caused by them. As a
result, people are unable to use tuple in ways that are blessed by the
Standard, all that for the perceived benefit of providing them extensions
that they never asked for.
Since this is an API break, I communicated it in the release notes.
I do not foresee major issues with this break because I don't think the
extensions are too widely relied upon, but we can ship it and see if we
get complaints before the next LLVM release - that will give us some
amount of information regarding how much use these extensions have.
Differential Revision: https://reviews.llvm.org/D96523
GitOrigin-RevId: a3ab5120fd572215afeac190757834a041dda73a
diff --git a/docs/ReleaseNotes.rst b/docs/ReleaseNotes.rst
index 00ada48..1bcb26d 100644
--- a/docs/ReleaseNotes.rst
+++ b/docs/ReleaseNotes.rst
@@ -43,4 +43,15 @@
API Changes
-----------
-- ...
+- There has been several changes in the tuple constructors provided by libc++.
+ Those changes were made as part of an effort to regularize libc++'s tuple
+ implementation, which contained several subtle bugs due to these extensions.
+ If you notice a build breakage when initializing a tuple, make sure you
+ properly initialize all the tuple elements - this is probably the culprit.
+
+ In particular, the extension allowing tuples to be constructed from fewer
+ elements than the number of elements in the tuple (in which case the remaining
+ elements would be default-constructed) has been removed. See https://godbolt.org/z/sqozjd.
+
+ Also, the extension allowing a tuple to be constructed from an array has been
+ removed. See https://godbolt.org/z/5esqbW.