Update docs for previous changes

Author: JayPanoz

docs/CSS12-user_prefs.md

@@ -147,8 +147,6 @@ Users may want to normalize text (no bold, no italics, etc.) for accessibility r
 
 Supported value: `readium-a11y-on`
 
-Required flag: `--USER__fontOverride: readium-font-on`
-
 To disable the normalization, you can either set an empty string as a value or remove the property.
 
 ### Hiding Ruby Text

docs/CSS19-api.md

@@ -199,8 +199,6 @@ Preset: `--USER__a11yNormalize: readium-a11y-on`
 
 Scope: `html`
 
-Required flag: `:--fontOverride`
-
 Override class: User settings advanced (optional but should be applied by any means necessary if provided to users)
 
 It impacts font style, weight and variant, text decoration, super and subscripts.

docs/CSS28-migration_guide.md

@@ -188,4 +188,10 @@ These settings now work without the flag. This provides with more flexibility si
 
 It’s been replaced with the flag `--USER__fontSizeNormalize: readium-normalize-on`, whose purpose is to simply force ReadiumCSS 1’s normalization so that the font-size user setting can be guaranteed to work on all publications, even if the book’s font-sizing is styled using absolute units. 
 
-This repurposed flag can be appended as you see fit, when CSS property `zoom` is not supported: you can present it as a toggle to users, or append it programmatically, or append it automatically, etc.
+This repurposed flag can be appended as you see fit, when CSS property `zoom` is not supported: you can present it as a toggle to users, or append it programmatically, or append it automatically, etc.
+
+## Removal of line-height compensation for A11y fonts and normalization
+
+Since version `2.0.0-beta.11`, ReadiumCSS no longer applies a line-height compensation when AccessibleDfA and IA Writer Duospace are the current user font, or the accessibility normalize flag is set.
+
+That was a side-effect that could be surprising to implementers, and impacting their line-height user setting experience.

docs/ReadiumCSS_docs.epub

@@ -168,8 +168,6 @@ root.style.setProperty("name of var", "");</code></pre>
 
         <p>Supported value: <code>readium-a11y-on</code></p>
 
-        <p>Required flag: <code>--USER__fontOverride: readium-font-on</code></p>
-
         <p>Override class: User settings advanced (optional but should be applied by any means necessary if provided to users)</p>
 
 		    <p>To disable the normalization, you can either set an empty string as a value or remove the property.</p>

docs/ReadiumCSS_docs/OEBPS/Text/Section-012.xhtml

@@ -184,8 +184,6 @@
 
       <p>Scope: <code>html</code></p>
 
-      <p>Required flag: <code>:--fontOverride</code></p>
-
       <p>Override class: User settings advanced (optional but should be applied by any means necessary if provided to users)</p>
 
       <p>It impacts font style, weight and variant, text decoration, super and subscripts.</p>

docs/ReadiumCSS_docs/OEBPS/Text/Section-019.xhtml

@@ -228,6 +228,14 @@ const sepiaBackground = sepiaMode.sepiaMode.RS__backgroundColor;</code></pre>
 
       <p>This repurposed flag can be appended as you see fit, when CSS property <code>zoom</code> is not supported: you can present it as a toggle to users, or append it programmatically, or append it automatically, etc.</p>
     </section>
+    
+    <section id="line-height-compensation" class="level2">
+      <h2 id="sigil_toc_id_213">Removal of line-height compensation for A11y fonts and normalization</h2>
+
+      <p>Since version <code>2.0.0-beta.11</code>, ReadiumCSS no longer applies a line-height compensation when AccessibleDfA and IA Writer Duospace are the current user font, or the accessibility normalize flag is set.</p>
+
+      <p>That was a side-effect that could be surprising to implementers, and impacting their line-height user setting experience.</p>
+    </section>
   </section>
 </body>
 </html>

docs/ReadiumCSS_docs/OEBPS/Text/Section-028.xhtml

@@ -747,6 +747,9 @@
         <li>
           <a href="../Text/Section-028.xhtml#sigil_toc_id_212">Removal of advanced settings flag</a>
         </li>
+        <li>
+          <a href="../Text/Section-028.xhtml#sigil_toc_id_213">Removal of line-height compensation for A11y fonts and normalization</a>
+        </li>
       </ol>
       </li>
     </ol>

docs/ReadiumCSS_docs/OEBPS/Text/nav.xhtml

@@ -8,7 +8,7 @@
     <dc:language>en</dc:language>
     <dc:identifier id="epub-id-1">urn:uuid:527D093B-9C0A-4C83-8AF6-0A40E91D30FC</dc:identifier>
     <meta name="cover" content="cover_jpg" />
-    <meta property="dcterms:modified">2025-02-21T14:18:37Z</meta>
+    <meta property="dcterms:modified">2025-04-14T12:35:00Z</meta>
     <meta name="Sigil version" content="0.9.8" />
     <meta property="schema:accessibilityFeature">displayTransformability</meta>
     <meta property="schema:accessibilityFeature">readingOrder</meta>

docs/ReadiumCSS_docs/OEBPS/content.opf

@@ -1359,18 +1359,24 @@
         </navLabel>
         <content src="Text/Section-028.xhtml#sigil_toc_id_209"/>
       </navPoint>
-       <navPoint id="navPoint226">
+      <navPoint id="navPoint226">
         <navLabel>
           <text>Removal of Dynamic Leading</text>
         </navLabel>
         <content src="Text/Section-028.xhtml#sigil_toc_id_211"/>
       </navPoint>
-       <navPoint id="navPoint227">
+      <navPoint id="navPoint227">
         <navLabel>
           <text>Removal of advanced settings flag</text>
         </navLabel>
         <content src="Text/Section-028.xhtml#sigil_toc_id_212"/>
       </navPoint>
+      <navPoint id="navPoint228">
+        <navLabel>
+          <text>Removal of line-height compensation for A11y fonts and normalization</text>
+        </navLabel>
+        <content src="Text/Section-028.xhtml#sigil_toc_id_213"/>
+      </navPoint>
     </navPoint>
   </navMap>
 </ncx>