Skip to content

Commit f86c19a

Browse files
committed
Update paper
1 parent 26969f8 commit f86c19a

File tree

2 files changed

+13
-13
lines changed

2 files changed

+13
-13
lines changed

papers/p3904.bs

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ David Wheeler
2323
`std::filesystem::path`, addressing encoding issues and making formatting
2424
lossless except for one case, unpaired surrogates on Windows. This paper
2525
proposes addressing this case and making formatting 100% lossless by default
26-
via the WTF-8 encoding ([[WTF]]). This will improve consistency in path
26+
via the WTF-8 encoding ([[WTF-8]]). This will improve consistency in path
2727
handling between Windows and POSIX platforms and align with the design of
2828
`std::format` where the default formatting is normally lossless.
2929

@@ -81,7 +81,7 @@ The current paper proposes preventing data loss and formatting ill-formed
8181
UTF-16 paths using WTF-8 (Wobbly Transformation Format − 8-bit) which is
8282
"a superset of UTF-8 that can losslessly represent arbitrary sequences of
8383
16-bit code unit (even if ill-formed in UTF-16) but preserves the other
84-
well-formedness constraints of UTF-8." ([[WTF]])
84+
well-formedness constraints of UTF-8." ([[WTF-8]])
8585

8686
<table>
8787
<tr>
@@ -140,9 +140,9 @@ on implementations that follow the recommended practice from
140140
> units with U+FFFD REPLACEMENT CHARACTER per the Unicode Standard, Chapter 3.9
141141
> U+FFFD Substitution in Conversion.
142142

143-
WTF-8 is used to handle invalid UTF-16 in Rust ([[RUST-OSSTRING]]) and Node.js
144-
libuv ([[LIBUV]]). Python also handles this but with a different mechanism
145-
([[PEP383]]).
143+
WTF-8 is used to handle invalid UTF-16 in paths and other system APIs in Rust
144+
([[RUST-OSSTRING]]) and Node.js libuv ([[LIBUV]]). Python also handles this but
145+
with a different mechanism ([[PEP383]]).
146146

147147
<pre class=biblio>
148148
{
@@ -166,7 +166,7 @@ libuv ([[LIBUV]]). Python also handles this but with a different mechanism
166166
"authors": "libuv contributors,",
167167
"href": "https://docs.libuv.org/en/v1.x/misc.html"
168168
},
169-
"WTF": {
169+
"WTF-8": {
170170
"title": "The WTF-8 encoding",
171171
"authors": ["Simon Sapin"],
172172
"href": "https://wtf-8.codeberg.page/"

papers/p3904.html

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1563,7 +1563,7 @@
15631563
</style>
15641564
<meta content="Bikeshed version 4416b18d5, updated Tue Jan 2 15:52:39 2024 -0800" name="generator">
15651565
<link href="https://isocpp.org/favicon.ico" rel="icon">
1566-
<meta content="36253156092910ff21aa2d4b2a5b9a7ec762c0bf" name="revision">
1566+
<meta content="26969f8e22b014ff36432e52efdd0173cfcf5071" name="revision">
15671567
<style>/* Boilerplate: style-autolinks */
15681568
.css.css, .property.property, .descriptor.descriptor {
15691569
color: var(--a-normal-text);
@@ -2121,7 +2121,7 @@ <h2 class="heading settled" data-level="1" id="intro"><span class="secno">1. </s
21212121
<p><a data-link-type="biblio" href="#biblio-p2845" title="Formatting of std::filesystem::path">[P2845]</a>, adopted in C++26, added formatting support for <code class="highlight"><c- n>std</c-><c- o>::</c-><c- n>filesystem</c-><c- o>::</c-><c- n>path</c-></code>, addressing encoding issues and making formatting
21222122
lossless except for one case, unpaired surrogates on Windows. This paper
21232123
proposes addressing this case and making formatting 100% lossless by default
2124-
via the WTF-8 encoding (<a data-link-type="biblio" href="#biblio-wtf" title="The WTF-8 encoding">[WTF]</a>). This will improve consistency in path
2124+
via the WTF-8 encoding (<a data-link-type="biblio" href="#biblio-wtf-8" title="The WTF-8 encoding">[WTF-8]</a>). This will improve consistency in path
21252125
handling between Windows and POSIX platforms and align with the design of <code class="highlight"><c- n>std</c-><c- o>::</c-><c- n>format</c-></code> where the default formatting is normally lossless.</p>
21262126
<h2 class="heading settled" data-level="2" id="motivation"><span class="secno">2. </span><span class="content">Motivation</span><a class="self-link" href="#motivation"></a></h2>
21272127
<p><a data-link-type="biblio" href="#biblio-p2845" title="Formatting of std::filesystem::path">[P2845]</a> made it possible to format and print Unicode paths, even on Windows,
@@ -2164,7 +2164,7 @@ <h2 class="heading settled" data-level="3" id="proposal"><span class="secno">3.
21642164
UTF-16 paths using WTF-8 (Wobbly Transformation Format − 8-bit) which is
21652165
"a superset of UTF-8 that can losslessly represent arbitrary sequences of
21662166
16-bit code unit (even if ill-formed in UTF-16) but preserves the other
2167-
well-formedness constraints of UTF-8." (<a data-link-type="biblio" href="#biblio-wtf" title="The WTF-8 encoding">[WTF]</a>)</p>
2167+
well-formedness constraints of UTF-8." (<a data-link-type="biblio" href="#biblio-wtf-8" title="The WTF-8 encoding">[WTF-8]</a>)</p>
21682168
<table>
21692169
<tbody>
21702170
<tr>
@@ -2205,9 +2205,9 @@ <h2 class="heading settled" data-level="3" id="proposal"><span class="secno">3.
22052205
units with U+FFFD REPLACEMENT CHARACTER per the Unicode Standard, Chapter 3.9
22062206
U+FFFD Substitution in Conversion.</p>
22072207
</blockquote>
2208-
<p>WTF-8 is used to handle invalid UTF-16 in Rust (<a data-link-type="biblio" href="#biblio-rust-osstring" title="OsString Struct. The Rust Standard Library.">[RUST-OSSTRING]</a>) and Node.js
2209-
libuv (<a data-link-type="biblio" href="#biblio-libuv" title="Miscellaneous utilities. libuv Documentation.">[LIBUV]</a>). Python also handles this but with a different mechanism
2210-
(<a data-link-type="biblio" href="#biblio-pep383" title="PEP 383 – Non-decodable Bytes in System Character Interfaces">[PEP383]</a>).</p>
2208+
<p>WTF-8 is used to handle invalid UTF-16 in paths and other system APIs in Rust
2209+
(<a data-link-type="biblio" href="#biblio-rust-osstring" title="OsString Struct. The Rust Standard Library.">[RUST-OSSTRING]</a>) and Node.js libuv (<a data-link-type="biblio" href="#biblio-libuv" title="Miscellaneous utilities. libuv Documentation.">[LIBUV]</a>). Python also handles this but
2210+
with a different mechanism (<a data-link-type="biblio" href="#biblio-pep383" title="PEP 383 – Non-decodable Bytes in System Character Interfaces">[PEP383]</a>).</p>
22112211
</main>
22122212
<script>
22132213
(function() {
@@ -2351,6 +2351,6 @@ <h3 class="no-num no-ref heading settled" id="informative"><span class="content"
23512351
<dd>R; et al. <a href="https://doc.rust-lang.org/std/ffi/struct.OsString.html"><cite>OsString Struct. The Rust Standard Library.</cite></a>. URL: <a href="https://doc.rust-lang.org/std/ffi/struct.OsString.html">https://doc.rust-lang.org/std/ffi/struct.OsString.html</a>
23522352
<dt id="biblio-win32-fileio">[WIN32-FILEIO]
23532353
<dd>Microsoft Corporation. <a href="https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation"><cite>Maximum Path Length Limitation – Local file systems</cite></a>. URL: <a href="https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation">https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation</a>
2354-
<dt id="biblio-wtf">[WTF]
2354+
<dt id="biblio-wtf-8">[WTF-8]
23552355
<dd>Simon Sapin. <a href="https://wtf-8.codeberg.page/"><cite>The WTF-8 encoding</cite></a>. URL: <a href="https://wtf-8.codeberg.page/">https://wtf-8.codeberg.page/</a>
23562356
</dl>

0 commit comments

Comments
 (0)