asciidoc tilde escaped as U+007E

#fix fix #804
cppalliance · Jan 15, 2025 · fe7c6e9 · fe7c6e9
1 parent 0d046cb
commit fe7c6e9
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 6 deletions.
diff --git a/src/lib/Gen/adoc/AdocEscape.cpp b/src/lib/Gen/adoc/AdocEscape.cpp
@@ -24,7 +24,13 @@ HTMLNamedEntity(char const c)
     // Otherwise, we return std::nullopt
     switch (c)
     {
-        case '~': return "&tilde;";
+        // There's no named entity for '~' (U+007E / &#126;) in HTML
+        // - "&tilde;" represents a small tilde (U+02DC)
+        // - "&Tilde;" or "&sim;" represent the tilde operator (U+223C)
+        // The 'tilde operator' (U+223C) is not the same character as
+        // "tilde" (U+007E) although the same glyph might be used to
+        // represent both.
+        // case '~': return "&tilde;";
         case '^': return "&circ;";
         case '_': return "&lowbar;";
         case '*': return "&ast;";

diff --git a/test-files/golden-tests/javadoc/ref.adoc b/test-files/golden-tests/javadoc/ref.adoc
@@ -36,7 +36,7 @@
 
 
 | <<f6,`f6`>> 
-| See xref:#F-operator_bitnot[F&colon;&colon;operator&tilde;]
+| See xref:#F-operator_bitnot[F&colon;&colon;operator&#126;]
 
 
 
@@ -355,7 +355,7 @@ struct F;
 | <<F-operator_bitor,`operator&verbar;`>> 
 | <<F-operator_or_eq,`operator&verbar;&equals;`>> 
 | <<F-operator_or,`operator&verbar;&verbar;`>> 
-| <<F-operator_bitnot,`operator&tilde;`>> 
+| <<F-operator_bitnot,`operator&#126;`>> 
 |===
 
 
@@ -931,7 +931,7 @@ operator&verbar;&verbar;(<<F,F>>&);
 ----
 
 [#F-operator_bitnot]
-== <<F,F>>::operator&tilde;
+== <<F,F>>::operator&#126;
 
 
 === Synopsis
@@ -942,7 +942,7 @@ Declared in `&lt;ref&period;cpp&gt;`
 [source,cpp,subs="verbatim,replacements,macros,-callouts"]
 ----
 void
-operator&tilde;();
+operator&#126;();
 ----
 
 [#f0]
@@ -990,7 +990,7 @@ See xref:#A-f1[&colon;&colon;A&colon;&colon;f1]
 == f6
 
 
-See xref:#F-operator_bitnot[F&colon;&colon;operator&tilde;]
+See xref:#F-operator_bitnot[F&colon;&colon;operator&#126;]