Skip to content

Commit 612b317

Browse files
committed
CXX-1304 CXX-1304 Document std::experimental polyfill as unsupported
1 parent 6a0218e commit 612b317

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

docs/content/mongocxx-v3/installation.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,10 @@ implementations for these features:
5757
Select with `-DBSONCXX_POLY_USE_STD_EXPERIMENTAL=1`. If your
5858
toolchain's standard library provides `optional` and
5959
`string_view` in the namespace `std::experimental`, you can use
60-
this option.
60+
this option. Be aware that your standard library's
61+
`std::experimental` implementation may change over time,
62+
breaking binary compatibility in unexpected ways. Note that this
63+
polyfill is *not* recommended and is unsupported.
6164

6265
Most users should be fine sticking with the default. However, if you
6366
have an existing application which makes heavy use of one of the
@@ -67,9 +70,6 @@ against the same library.
6770
**DO NOT** change your project's polyfill if you need to create a
6871
stable binary interface.
6972

70-
Be aware that your standard library's `std::experimental` implementation
71-
may change over time, breaking binary compatibility in unexpected ways.
72-
7373
### Step 3: Download the latest version of the mongocxx driver.
7474

7575
To get the source via git, the `releases/stable` branch will track the most

0 commit comments

Comments
 (0)