From 5d7a4ce0d372c9fd07954e6fa76b6f13ada3fa5a Mon Sep 17 00:00:00 2001 From: Matt Garrish Date: Fri, 20 May 2022 13:59:40 -0300 Subject: [PATCH 1/5] add reading system conformance section --- epub33/rs/index.html | 23 +++++++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) diff --git a/epub33/rs/index.html b/epub33/rs/index.html index f3248e663..526755678 100644 --- a/epub33/rs/index.html +++ b/epub33/rs/index.html @@ -219,6 +219,25 @@

Relationship to SVG

+
+

Reading system conformance

+ +

Whether a reading system has to support a feature is mentioned at the beginning of its section. To be + conformant with this specification, reading systems MUST support all required features as well as all + applicable conditionally-required features (e.g., to support image rendering if the reading system has a + [=viewport=]).

+ +

When support for a feature is only recommended, reading system developers can typically ignore all the + normative statements in its section. In some cases, however, there may be alternative requirements when + not implementing a feature (e.g., to process fallbacks when + scripting is not supported).

+ +
+

EPUB publications typically contain more information than there are support requirements for in this + specification (e.g., [=package document=] metadata). Reading systems may use this additional + information for any purposes (e.g., to improve the user interface).

+
+

Publication resource processing

@@ -1152,8 +1171,8 @@

Cascading Style Sheets (CSS)

  • MUST support [[truetype]], - [[opentype]], [[woff]], and [[woff2]] font resources referenced from - @font-face rules + [[opentype]], [[woff]], and [[woff2]] font resources referenced from @font-face rules [[css-fonts-4]].

  • From 4f0cec583a85b87130d67a005fb9f120d7e3d704 Mon Sep 17 00:00:00 2001 From: Matt Garrish Date: Fri, 20 May 2022 14:01:56 -0300 Subject: [PATCH 2/5] add change log entry --- epub33/rs/index.html | 2 ++ 1 file changed, 2 insertions(+) diff --git a/epub33/rs/index.html b/epub33/rs/index.html index 526755678..d927a7de2 100644 --- a/epub33/rs/index.html +++ b/epub33/rs/index.html @@ -2563,6 +2563,8 @@

    Change log

    >Working Group's issue tracker.

      +
    • 20-May-2022: Added reading system conformance section. See issue 2271.
    • 17-May-2022: Added an index of terms. See issue 2260.
    • 31-Mar-2022: Moved custom attribute authoring requirements to the authoring specification. Added From a2b7071d83d44bb603d697abe9da1a510b41156b Mon Sep 17 00:00:00 2001 From: Matt Garrish Date: Fri, 20 May 2022 17:14:53 -0300 Subject: [PATCH 3/5] Update epub33/rs/index.html Co-authored-by: Dan Lazin --- epub33/rs/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/epub33/rs/index.html b/epub33/rs/index.html index d927a7de2..ea86f4aed 100644 --- a/epub33/rs/index.html +++ b/epub33/rs/index.html @@ -233,7 +233,7 @@

      Reading system conformance

      scripting is not supported).

      -

      EPUB publications typically contain more information than there are support requirements for in this +

      EPUB publications frequently contain information not required by this specification (e.g., [=package document=] metadata). Reading systems may use this additional information for any purposes (e.g., to improve the user interface).

      From 519dcae77a7fef71925a2da6dde35f40295b7162 Mon Sep 17 00:00:00 2001 From: Matt Garrish Date: Fri, 20 May 2022 17:18:22 -0300 Subject: [PATCH 4/5] Update epub33/rs/index.html --- epub33/rs/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/epub33/rs/index.html b/epub33/rs/index.html index ea86f4aed..3cd862216 100644 --- a/epub33/rs/index.html +++ b/epub33/rs/index.html @@ -224,7 +224,7 @@

      Reading system conformance

      Whether a reading system has to support a feature is mentioned at the beginning of its section. To be conformant with this specification, reading systems MUST support all required features as well as all - applicable conditionally-required features (e.g., to support image rendering if the reading system has a + applicable conditionally required features (e.g., to support image rendering if the reading system has a [=viewport=]).

      When support for a feature is only recommended, reading system developers can typically ignore all the From 886a6871c71a81b7daabbef8cb581d78615f31b3 Mon Sep 17 00:00:00 2001 From: Matt Garrish Date: Sun, 22 May 2022 06:49:28 -0300 Subject: [PATCH 5/5] rewrite to remove support ambiguity around supporting recommended/optional feature --- epub33/rs/index.html | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/epub33/rs/index.html b/epub33/rs/index.html index d927a7de2..cd6f81961 100644 --- a/epub33/rs/index.html +++ b/epub33/rs/index.html @@ -225,12 +225,16 @@

      Reading system conformance

      Whether a reading system has to support a feature is mentioned at the beginning of its section. To be conformant with this specification, reading systems MUST support all required features as well as all applicable conditionally-required features (e.g., to support image rendering if the reading system has a - [=viewport=]).

      + [=viewport=]) as defined in their respective sections.

      -

      When support for a feature is only recommended, reading system developers can typically ignore all the - normative statements in its section. In some cases, however, there may be alternative requirements when - not implementing a feature (e.g., to process fallbacks when - scripting is not supported).

      +

      When supporting recommended and optional features, reading systems MUST meet all normative requirements + as defined in their respective sections.

      + +

      When reading system developers opt not to support a recommended or optional feature, it does not always + mean none of the normative requirements of the section apply. In some cases, there may be alternative + requirements when not implementing a feature (e.g., to process + fallbacks when scripting is not supported). Reading systems MUST meet these alternative + requirements when not supporting a feature.

      EPUB publications typically contain more information than there are support requirements for in this