Update docs

Author: JayPanoz

docs/CSS12-user_prefs.md

@@ -89,9 +89,23 @@ Override class: None. This flag is required to change the `font-family` user set
 
 To switch back to the publisher’s font, you can either set an empty string as a value or remove the property.
 
+### Toggling the Deprecated Implementation of the Font Size Setting
+
+Allows to switch to the Deprecated Implementation of the Font Size Setting from version 1.
+
+```
+--USER__fontSizeImplementation
+```
+
+Supported value: `readium-deprecatedFontSize-on`
+
+Override class: None.
+
+**Note:** This implementation will automatically be used in case `zoom` is not supported.
+
 ### Font Size Normalization
 
-Acts as an explicit switch to force font-normalization in publications whose font-sizing is declared using CSS absolute units, breaking the font-size user setting in engines that don’t support CSS property `zoom`.
+Acts as an explicit switch to force font-normalization in publications whose font-sizing is declared using CSS absolute units, breaking the font-size user setting.
 
 ```
 --USER__fontSizeNormalize

docs/CSS19-api.md

@@ -74,6 +74,18 @@ Scope: `html`
 
 Override class: None. This flag is required to change the `font-family` user setting.
 
+* * *
+
+```
+:--deprecated-font-size
+```
+
+Preset: `--USER__fontSizeImplementation: readium-deprecatedFontSize-on`
+
+Scope: `html`
+
+Override class: None. This flag can be used to force the previous and deprecated implementation of font-size setting. It is also used automatically if the browser/rendering engine does not support CSS property `zoom` – note font-size normalization is not triggered by default in that case.
+
 * * * 
 
 ```

docs/CSS28-migration_guide.md

@@ -110,6 +110,10 @@ As a side-effect of this new implementation, please note the `--USER__typeScale`
 
 Due to iPadOS “desktop-class experience” interventions, a patch has to be applied when the site is requested (by default) in desktop version, and only in this version (mobile website is fine without it). The selector for the flag can be configured (`:--ipadOS-patch`) and is `[style*="readium-iPadOSPatch-on"]` by default.
 
+Starting version `2.0.0-beta.12` the previous and deprecated implementation of font-size is exposed under a flag that can be configured (`:--deprecated-font-size`) and is `[style*="readium-deprecatedFontSize-on"]` by default. This can be used if you need some time to switch to the new implementation, or simply prefer to use the old one. The font-size normalize is no longer applied by default though, and is relying on another flag (`:--fs-normalize`) with `[style*="readium-normalize-on"]` as default.
+
+Note that when zoom is not supported, the setting will automatically switch to the previous implementation. Once again, you need to manually apply the font-size normalization as you see fit.
+
 ## Extension of the font-family user setting override
 
 In version 1, the font-family user setting overrode a selection of elements of body copy e.g. `p`, `li`, `dt`, etc. This explained why the font-family of headings would remain the same as the one set in authors’ stylesheets for instance.

docs/ReadiumCSS_docs.epub

@@ -109,10 +109,22 @@ root.style.setProperty("name of var", "");</code></pre>
         <p>To switch back to the publisher’s font, you can either set an empty string as a value or remove the property.</p>
       </section>
 
+      <section id="toggling-font-size-implementation" class="level3">
+        <h3 class="sigil_not_in_toc">Toggling the Deprecated Implementation of the Font Size Setting</h3>
+
+        <p>Allows to switch to the Deprecated Implementation of the Font Size Setting from version 1.</p>
+
+        <pre><code>--USER__fontSizeImplementation</code></pre>
+
+        <p>Supported value: <code>readium-deprecatedFontSize-on</code></p>
+
+        <p>Override class: None.</p>
+      </section>
+
       <section id="font-size-normalization" class="level3">
         <h3 class="sigil_not_in_toc">Font Size Normalization</h3>
 
-        <p>Acts as an explicit switch to orce font-normalization in publications whose font-sizing is declared using CSS absolute units, breaking the font-size user setting in engines that don’t support CSS property <code>zoom</code>.</p>
+        <p>Acts as an explicit switch to orce font-normalization in publications whose font-sizing is declared using CSS absolute units, breaking the font-size user setting.</p>
 
         <pre><code>--USER__fontSizeNormalize</code></pre>
 

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

@@ -80,6 +80,16 @@
 
       <hr/>
 
+      <pre><code>:--deprecated-font-size</code></pre>
+
+      <p>Preset: <code>--USER__fontSizeImplementation: readium-deprecatedFontSize-on</code></p>
+
+      <p>Scope: <code>html</code></p>
+
+      <p>Override class: None. This flag can be used to force the previous and deprecated implementation of font-size setting. It is also used automatically if the browser/rendering engine does not support CSS property <code>zoom</code> – note font-size normalization is not triggered by default in that case.</p>
+
+      <hr/>
+
       <pre><code>:--fs-normalize</code></pre>
 
       <p>Preset: <code>--USER__fontSizeNormalize: readium-normalize-on</code></p>

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

@@ -127,6 +127,10 @@
       <p>As a side-effect of this new implementation, please note the <code>--USER__typeScale</code> setting is no longer available.</p>
 
       <p>Due to iPadOS “desktop-class experience” interventions, a patch has to be applied when the site is requested (by default) in desktop mode, and only in this mode (mobile website is fine without it). The selector for the flag can be configured (<code>:--ipadOS-patch</code>) and is <code>[style*="readium-iPadOSPatch-on"]</code> by default.</p>
+
+      <p>Starting version <code>2.0.0-beta.12</code> the previous and deprecated implementation of font-size is exposed under a flag that can be configured (<code>:--deprecated-font-size</code>) and is <code>[style*="readium-deprecatedFontSize-on"]</code> by default. This can be used if you need some time to switch to the new implementation, or simply prefer to use the old one. The font-size normalize is no longer applied by default though, and is relying on another flag (<code>:--fs-normalize</code>) with <code>[style*="readium-normalize-on"]</code> as default.</p>
+
+      <p>Note that when zoom is not supported, the setting will automatically switch to the previous implementation. Once again, you need to manually apply the font-size normalization as you see fit.</p>
     </section>
 
     <section id="extension-of-the-font-family-user-setting-override" class="level2">

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

@@ -1,5 +1,5 @@
 <!doctype html>
-<html style="--USER__view: readium-scroll-on; --USER__fsImplementation: readium-deprecatedFontSize-on; --USER__fontSize: 200%; --USER__fsNormalize: readium-normalize-on;">
+<html style="--USER__view: readium-scroll-on; --USER__fontSizeImplementation: readium-deprecatedFontSize-on; --USER__fontSize: 200%; --USER__fontSizeNormalize: readium-normalize-on;">
 <head>
   <title>Test</title>
   <meta charset="UTF-8" />