Update docs

Author: JayPanoz

docs/CSS12-user_prefs.md

@@ -101,9 +101,21 @@ Supported value: `readium-normalize-on`
 
 Override class: None.
 
+### iOS Scaling Patch
+
+Acts as an explicit switch to force iOS patching of scaling issues so that `--USER__fontSize` can work as expected. This should be applied only when the site is requested in its mobile version on iOS and iPadOS.
+
+```
+--USER__iOSPatch
+```
+
+Supported value: `readium-iOSPatch-on`
+
+Override class: None.
+
 ### iPadOS Zoom Patch
 
-Acts as an explicit switch to force iPadOS patching of zoom issues so that `--USER__fontSize` can work as expected. This should be applied only when the site is requested in its desktop version on iPadOS – mobile version is completely fine.
+Acts as an explicit switch to force iPadOS patching of zoom issues so that `--USER__fontSize` can work as expected. This should be applied only when the site is requested in its desktop version on iPadOS.
 
 ```
 --USER__iPadOSPatch

docs/CSS19-api.md

@@ -88,6 +88,18 @@ Override class: None. This flag can be used to force font-size normalization if
 
 * * *
 
+```
+:--ios-patch
+```
+
+Preset: `--USER__iOSPatch: readium-iOSPatch-on`
+
+Scope: `html`
+
+Override class: None. This flag is used to activate patching of iOS scaling issues in Safari, which can happen on rotate for instance.
+
+* * *
+
 ```
 :--ipadOS-patch
 ```

docs/CSS28-migration_guide.md

@@ -108,7 +108,11 @@ It doesn’t need any change at the implementation level, and should work out of
 
 As a side-effect of this new implementation, please note the `--USER__typeScale` setting is no longer available.
 
-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.
+iOS and iPadOS require patches to be applied to be able to use the font-size user setting properly, as the management of zooming and scaling has numerous and complex heuristics issues depending on the platform, and the way the site is requested (mobile or desktop).
+
+iOS and iPadOS both require a patch to be applied when the site is requested in mobile version, and only in this version. The selector for the flag can be configured (`:--ios-patch`) and is `[style*="readium-iOSPatch-on"]` by default.
+
+Due to iPadOS “desktop-class experience” interventions, another 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.
 

docs/ReadiumCSS_docs.epub

@@ -119,6 +119,18 @@ root.style.setProperty("name of var", "");</code></pre>
         <p>Override class: None.</p>
       </section>
 
+      <section id="ios-scale-patch" class="level3">
+        <h3 class="sigil_not_in_toc">iOS Scaling Patch</h3>
+
+        <p>Acts as an explicit switch to force iOS patching of scaling issues so that <code>--USER__fontSize</code> can work as expected. This should be applied only when the site is requested in its mobile version on iOS and iPadOS.</p>
+
+        <pre><code>--USER__iOSPatch</code></pre>
+
+        <p>Supported value: <code>readium-iOSPatch-on</code></p>
+
+        <p>Override class: None.</p>
+      </section>
+
       <section id="ipados-zoom-patch" class="level3">
         <h3 class="sigil_not_in_toc">iPadOS Zoom Patch</h3>
 

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

@@ -90,6 +90,16 @@
 
       <hr/>
 
+      <pre><code>:--ios-patch</code></pre>
+
+      <p>Preset: <code>--USER__iOSPatch: readium-iOSPatch-on</code></p>
+
+      <p>Scope: <code>html</code></p>
+
+      <p>Override class: None. This flag is used to activate patching of iOS scaling issues in Safari, which can happen on rotate for instance.</p>
+
+      <hr/>
+
       <pre><code>:--ipadOS-patch</code></pre>
 
       <p>Preset: <code>--USER__iPadOSPatch: readium-iPadOSPatch-on</code></p>

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

@@ -126,7 +126,11 @@
 
       <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>iOS and iPadOS require patches to be applied to be able to use the font-size user setting properly, as the management of zooming and scaling has numerous and complex heuristics issues depending on the platform, and the way the site is requested (mobile or desktop).</p>
+
+      <p>iOS and iPadOS both require a patch to be applied when the site is requested in mobile version, and only in this version. The selector for the flag can be configured (<code>:--ios-patch</code>) and is <code>[style*="readium-iOSPatch-on"]</code> by default.</p>
+
+      <p>Due to iPadOS “desktop-class experience” interventions, another 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>