[PATCH] libstdc++/doc: Document POSIX use in filesystem

[Jonathan Wakely]

On Tue, 26 May 2026 at 13:14 +0100, Jonathan Wakely wrote:
>On Tue, 12 May 2026 at 21:22 -0400, Nathan Myers wrote:
>>[This patch has only the XML text; the usual scripts have
>>not been run on it yet.]
>
>Please do that, which will find the invalid XML in the patch.
>https://gcc.gnu.org/onlinedocs/libstdc++/manual/documentation_hacking.html#docbook.rules
>
>>ISO C++ leaves concurrent use of std::filesystem operations
>>undefined. POSIX provides definitions for concurrent use. Here
>>we document POSIX (and sometimes GNU extension) operations used
>>to implement std::filesystem ops so that when run with libstdc++
>>hosted on POSIX, they are defined by the union of ISO C++ and
>>POSIX.
>>
>>libstdc++/Changelog
>>	* doc/xml/manual/io.xml: Document POSIX usage in filesystem.

P.S. no "/doc" in the component in the start of the git commit summary
line. It already says "Document" which seems explicit enough about
what it's doing.