From 3d0743c80e28e0b79e41ef103504bf750008464d Mon Sep 17 00:00:00 2001 From: Anne van Kesteren Date: Mon, 6 Apr 2020 16:15:57 +0200 Subject: [PATCH] Update WHATWG boilerplate To better account for Commit Snapshots and PR Preview. See also https://github.com/whatwg/whatwg.org/pull/310 and https://github.com/whatwg/spec-factory/pull/5. --- .../computed-metadata-LS-COMMIT.include | 16 + .../whatwg/computed-metadata-LS-PR.include | 16 + .../whatwg/computed-metadata-RD.include | 3 +- .../whatwg/computed-metadata.include | 5 +- bikeshed/boilerplate/whatwg/header-RD.include | 4 +- bikeshed/boilerplate/whatwg/header.include | 6 +- bikeshed/boilerplate/whatwg/logo.include | 3 - .../boilerplate/whatwg/warning-custom.include | 10 + .../whatwg/warning-obsolete.include | 10 + bikeshed/config/status.py | 5 +- tests/github/whatwg/compat/compatibility.html | 4 +- tests/github/whatwg/console/index.html | 4 +- tests/github/whatwg/dom/dom.html | 4 +- tests/github/whatwg/encoding/encoding.html | 4 +- tests/github/whatwg/fetch/fetch.html | 4 +- .../github/whatwg/fullscreen/fullscreen.html | 4 +- tests/github/whatwg/infra/infra.html | 4 +- tests/github/whatwg/loader/index.html | 4 +- tests/github/whatwg/mimesniff/mimesniff.html | 4 +- .../whatwg/notifications/notifications.html | 4 +- tests/github/whatwg/quirks/quirks.html | 4 +- tests/github/whatwg/storage/storage.html | 4 +- tests/github/whatwg/streams/index.html | 4 +- tests/github/whatwg/url/url.html | 4 +- tests/github/whatwg/xhr/xhr.html | 4 +- tests/include004-files/include004-2.html | 1561 ++++++++++++++++ .../include004-files/include004-2.html | 1562 ++++++++++++++++ .../include004-files/include004.html | 1562 ++++++++++++++++ tests/include004-files/include004.html | 1574 +++++++++++++++++ 29 files changed, 6356 insertions(+), 41 deletions(-) create mode 100644 bikeshed/boilerplate/whatwg/computed-metadata-LS-COMMIT.include create mode 100644 bikeshed/boilerplate/whatwg/computed-metadata-LS-PR.include delete mode 100644 bikeshed/boilerplate/whatwg/logo.include create mode 100644 bikeshed/boilerplate/whatwg/warning-custom.include create mode 100644 bikeshed/boilerplate/whatwg/warning-obsolete.include create mode 100644 tests/include004-files/include004-2.html create mode 100644 tests/include004-files/include004-files/include004-2.html create mode 100644 tests/include004-files/include004-files/include004.html create mode 100644 tests/include004-files/include004.html diff --git a/bikeshed/boilerplate/whatwg/computed-metadata-LS-COMMIT.include b/bikeshed/boilerplate/whatwg/computed-metadata-LS-COMMIT.include new file mode 100644 index 0000000000..c37680545b --- /dev/null +++ b/bikeshed/boilerplate/whatwg/computed-metadata-LS-COMMIT.include @@ -0,0 +1,16 @@ +{ + "Title": "[SPECTITLE] Standard Commit [COMMIT-SHA] Snapshot", + "Logo": "https://resources.whatwg.org/logo-[SHORTNAME]-snapshot.svg", + "!Participate": [ + "GitHub whatwg/[SHORTNAME] (new issue, open issues)", + "IRC: #whatwg on Freenode" + ], + "!Commits": [ + "GitHub whatwg/[SHORTNAME]/commits", + "Go to the living standard", + "@[TWITTER]" + ], + "!Tests": "web-platform-tests [SHORTNAME]/ (ongoing work)", + "Warning": "obsolete", + "Text Macro": "H1 [SPECTITLE] (Commit [COMMIT-SHA])" +} diff --git a/bikeshed/boilerplate/whatwg/computed-metadata-LS-PR.include b/bikeshed/boilerplate/whatwg/computed-metadata-LS-PR.include new file mode 100644 index 0000000000..c99137b7b7 --- /dev/null +++ b/bikeshed/boilerplate/whatwg/computed-metadata-LS-PR.include @@ -0,0 +1,16 @@ +{ + "Title": "[SPECTITLE] Standard Pull Request #[PR-NUMBER] Preview", + "Logo": "https://resources.whatwg.org/logo-[SHORTNAME]-snapshot.svg", + "!Participate": [ + "GitHub whatwg/[SHORTNAME] (new issue, open issues)", + "IRC: #whatwg on Freenode" + ], + "!Commits": [ + "GitHub whatwg/[SHORTNAME]/commits", + "Go to the living standard", + "@[TWITTER]" + ], + "!Tests": "web-platform-tests [SHORTNAME]/ (ongoing work)", + "Warning": "custom", + "Text Macro": "H1 [SPECTITLE] (PR #[PR-NUMBER])" +} diff --git a/bikeshed/boilerplate/whatwg/computed-metadata-RD.include b/bikeshed/boilerplate/whatwg/computed-metadata-RD.include index deb5507cdd..aa2183790a 100644 --- a/bikeshed/boilerplate/whatwg/computed-metadata-RD.include +++ b/bikeshed/boilerplate/whatwg/computed-metadata-RD.include @@ -1,4 +1,5 @@ { "Title": "[SPECTITLE] Standard Review Draft [DATE-MMY]", - "Logo": "https://resources.whatwg.org/logo-[SHORTNAME]-snapshot.svg" + "Logo": "https://resources.whatwg.org/logo-[SHORTNAME]-snapshot.svg", + "Text Macro": "H1 [SPECTITLE]" } diff --git a/bikeshed/boilerplate/whatwg/computed-metadata.include b/bikeshed/boilerplate/whatwg/computed-metadata.include index 77ae6886e1..4a7d81a73c 100644 --- a/bikeshed/boilerplate/whatwg/computed-metadata.include +++ b/bikeshed/boilerplate/whatwg/computed-metadata.include @@ -7,8 +7,9 @@ ], "!Commits": [ "GitHub whatwg/[SHORTNAME]/commits", - "[SNAPSHOT-LINK]", + "Snapshot as of this commit", "@[TWITTER]" ], - "!Tests": "web-platform-tests [SHORTNAME]/ (ongoing work)" + "!Tests": "web-platform-tests [SHORTNAME]/ (ongoing work)", + "Text Macro": "H1 [SPECTITLE]" } diff --git a/bikeshed/boilerplate/whatwg/header-RD.include b/bikeshed/boilerplate/whatwg/header-RD.include index ae76e6e046..d521ea1458 100644 --- a/bikeshed/boilerplate/whatwg/header-RD.include +++ b/bikeshed/boilerplate/whatwg/header-RD.include @@ -10,7 +10,9 @@
-

+

[SPECTITLE]

[LONGSTATUS] — Published

diff --git a/bikeshed/boilerplate/whatwg/header.include b/bikeshed/boilerplate/whatwg/header.include index 3dcc14118e..e951eb880a 100644 --- a/bikeshed/boilerplate/whatwg/header.include +++ b/bikeshed/boilerplate/whatwg/header.include @@ -13,9 +13,11 @@
-

+
-

[SPECTITLE]

+

[H1]

[LONGSTATUS] — Last Updated

diff --git a/bikeshed/boilerplate/whatwg/logo.include b/bikeshed/boilerplate/whatwg/logo.include deleted file mode 100644 index 5587a64dc6..0000000000 --- a/bikeshed/boilerplate/whatwg/logo.include +++ /dev/null @@ -1,3 +0,0 @@ - diff --git a/bikeshed/boilerplate/whatwg/warning-custom.include b/bikeshed/boilerplate/whatwg/warning-custom.include new file mode 100644 index 0000000000..5026733a1e --- /dev/null +++ b/bikeshed/boilerplate/whatwg/warning-custom.include @@ -0,0 +1,10 @@ +
+ This is a pull request preview of the standard +

+ This document contains the contents of the standard as modified by pull request #[PR-NUMBER], + and should only be used as a preview. +

+ Do not attempt to implement this version of the standard. + Do not reference this version as authoritative in any way. + Instead, see https://[SHORTNAME].spec.whatwg.org/ for the living standard. +

diff --git a/bikeshed/boilerplate/whatwg/warning-obsolete.include b/bikeshed/boilerplate/whatwg/warning-obsolete.include new file mode 100644 index 0000000000..baa2341d7c --- /dev/null +++ b/bikeshed/boilerplate/whatwg/warning-obsolete.include @@ -0,0 +1,10 @@ +
+ This is a commit snapshot of the standard +

+ This document contains the contents of the standard as of the [COMMIT-SHA] commit, + and should only be used as a historical reference. +

+ Do not attempt to implement this version of the standard. + Do not reference this version as authoritative in any way. + Instead, see https://[SHORTNAME].spec.whatwg.org/ for the living standard. +

diff --git a/bikeshed/config/status.py b/bikeshed/config/status.py index bc6134bcd7..5c5a92ddce 100644 --- a/bikeshed/config/status.py +++ b/bikeshed/config/status.py @@ -9,6 +9,7 @@ "LS": "Living Standard", "LS-COMMIT": "Commit Snapshot", "LS-BRANCH": "Branch Snapshot", + "LS-PR": "PR Preview", "LD": "Living Document", "DRAFT-FINDING": "Draft Finding", "FINDING": "Finding", @@ -81,9 +82,9 @@ } snapshotStatuses = ["w3c/WD", "w3c/FPWD", "w3c/LCWD", "w3c/CR", "w3c/PR", "w3c/REC", "w3c/PER", "w3c/WG-NOTE", "w3c/IG-NOTE", "w3c/NOTE", "w3c/MO"] datedStatuses = ["w3c/WD", "w3c/FPWD", "w3c/LCWD", "w3c/CR", "w3c/PR", "w3c/REC", "w3c/PER", "w3c/WG-NOTE", "w3c/IG-NOTE", "w3c/NOTE", "w3c/MO", "whatwg/RD"] -unlevelledStatuses = ["LS", "LD", "DREAM", "w3c/UD", "LS-COMMIT", "LS-BRANCH", "FINDING", "DRAFT-FINDING", "whatwg/RD"] +unlevelledStatuses = ["LS", "LD", "DREAM", "w3c/UD", "LS-COMMIT", "LS-BRANCH", "LS-PR", "FINDING", "DRAFT-FINDING", "whatwg/RD"] deadlineStatuses = ["w3c/LCWD", "w3c/PR"] -noEDStatuses = ["LS", "LS-COMMIT", "LS-BRANCH", "LD", "FINDING", "DRAFT-FINDING", "DREAM", "iso/NP", "whatwg/RD"] +noEDStatuses = ["LS", "LS-COMMIT", "LS-BRANCH", "LS-PR", "LD", "FINDING", "DRAFT-FINDING", "DREAM", "iso/NP", "whatwg/RD"] # W3C statuses can only be used by Working Groups & Interest Groups, not # Community Groups or Business Groups w3cStatuses = ["w3c/ED"] diff --git a/tests/github/whatwg/compat/compatibility.html b/tests/github/whatwg/compat/compatibility.html index c944347bb3..374980bf94 100644 --- a/tests/github/whatwg/compat/compatibility.html +++ b/tests/github/whatwg/compat/compatibility.html @@ -49,7 +49,7 @@
-

+

Compatibility

Living Standard — Last Updated

@@ -61,7 +61,7 @@

IRC: #whatwg on Freenode
Commits:
GitHub whatwg/compat/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@compatstandard
Tests:
web-platform-tests compat/ (ongoing work) diff --git a/tests/github/whatwg/console/index.html b/tests/github/whatwg/console/index.html index 99a8ef8ec3..bfb18331af 100644 --- a/tests/github/whatwg/console/index.html +++ b/tests/github/whatwg/console/index.html @@ -49,7 +49,7 @@
-

+

Console

Living Standard — Last Updated

@@ -61,7 +61,7 @@

IRC: #whatwg on Freenode
Commits:
GitHub whatwg/console/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@consolelog
Tests:
web-platform-tests console/ (ongoing work) diff --git a/tests/github/whatwg/dom/dom.html b/tests/github/whatwg/dom/dom.html index 2c3c983cd7..d93528c143 100644 --- a/tests/github/whatwg/dom/dom.html +++ b/tests/github/whatwg/dom/dom.html @@ -49,7 +49,7 @@
-

+

DOM

Living Standard — Last Updated

@@ -61,7 +61,7 @@

IRC: #whatwg on Freenode
Commits:
GitHub whatwg/dom/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@thedomstandard
Tests:
web-platform-tests dom/ (ongoing work) diff --git a/tests/github/whatwg/encoding/encoding.html b/tests/github/whatwg/encoding/encoding.html index 52baa7281d..d68584e9b3 100644 --- a/tests/github/whatwg/encoding/encoding.html +++ b/tests/github/whatwg/encoding/encoding.html @@ -50,7 +50,7 @@
-

+

Encoding

Living Standard — Last Updated

@@ -62,7 +62,7 @@

IRC: #whatwg on Freenode
Commits:
GitHub whatwg/encoding/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@encodings
Tests:
web-platform-tests encoding/ (ongoing work) diff --git a/tests/github/whatwg/fetch/fetch.html b/tests/github/whatwg/fetch/fetch.html index 086f07bc44..f3d25c7572 100644 --- a/tests/github/whatwg/fetch/fetch.html +++ b/tests/github/whatwg/fetch/fetch.html @@ -49,7 +49,7 @@
-

+

Fetch

Living Standard — Last Updated

@@ -61,7 +61,7 @@

IRC: #whatwg on Freenode
Commits:
GitHub whatwg/fetch/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@fetchstandard
Tests:
web-platform-tests fetch/ (ongoing work) diff --git a/tests/github/whatwg/fullscreen/fullscreen.html b/tests/github/whatwg/fullscreen/fullscreen.html index 992ea654fa..0cbe99f2a2 100644 --- a/tests/github/whatwg/fullscreen/fullscreen.html +++ b/tests/github/whatwg/fullscreen/fullscreen.html @@ -49,7 +49,7 @@
-

+

Fullscreen API

Living Standard — Last Updated

@@ -61,7 +61,7 @@

IRC: #whatwg on Freenode
Commits:
GitHub whatwg/fullscreen/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@fullscreenapi
Tests:
web-platform-tests fullscreen/ (ongoing work) diff --git a/tests/github/whatwg/infra/infra.html b/tests/github/whatwg/infra/infra.html index 79d7f383b9..a4b65e65fe 100644 --- a/tests/github/whatwg/infra/infra.html +++ b/tests/github/whatwg/infra/infra.html @@ -49,7 +49,7 @@
-

+

Infra

Living Standard — Last Updated

@@ -61,7 +61,7 @@

IRC: #whatwg on Freenode
Commits:
GitHub whatwg/infra/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@infrastandard
Tests:
web-platform-tests infra/ (ongoing work) diff --git a/tests/github/whatwg/loader/index.html b/tests/github/whatwg/loader/index.html index 5fd942addc..af12a66f78 100644 --- a/tests/github/whatwg/loader/index.html +++ b/tests/github/whatwg/loader/index.html @@ -24,7 +24,7 @@
-

+

Loader

A Collection of Interesting Ideas — Last Updated

@@ -38,7 +38,7 @@

GitHub whatwg/loader/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@[TWITTER]
Tests:
web-platform-tests loader/ (ongoing work) diff --git a/tests/github/whatwg/mimesniff/mimesniff.html b/tests/github/whatwg/mimesniff/mimesniff.html index 6924f56d18..aa0791b18b 100644 --- a/tests/github/whatwg/mimesniff/mimesniff.html +++ b/tests/github/whatwg/mimesniff/mimesniff.html @@ -49,7 +49,7 @@
-

+

MIME Sniffing

Living Standard — Last Updated

@@ -61,7 +61,7 @@

IRC: #whatwg on Freenode
Commits:
GitHub whatwg/mimesniff/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@mimesniff
Tests:
web-platform-tests mimesniff/ (ongoing work) diff --git a/tests/github/whatwg/notifications/notifications.html b/tests/github/whatwg/notifications/notifications.html index dee65d8e09..63332a6a9a 100644 --- a/tests/github/whatwg/notifications/notifications.html +++ b/tests/github/whatwg/notifications/notifications.html @@ -49,7 +49,7 @@
-

+

Notifications API

Living Standard — Last Updated

@@ -61,7 +61,7 @@

IRC: #whatwg on Freenode
Commits:
GitHub whatwg/notifications/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@notifyapi
Tests:
web-platform-tests notifications/ (ongoing work) diff --git a/tests/github/whatwg/quirks/quirks.html b/tests/github/whatwg/quirks/quirks.html index 255702e2e1..423dc49e60 100644 --- a/tests/github/whatwg/quirks/quirks.html +++ b/tests/github/whatwg/quirks/quirks.html @@ -67,7 +67,7 @@
-

+

Quirks Mode

Living Standard — Last Updated

@@ -79,7 +79,7 @@

IRC: #whatwg on Freenode
Commits:
GitHub whatwg/quirks/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@quirksstandard
Tests:
web-platform-tests quirks/ (ongoing work) diff --git a/tests/github/whatwg/storage/storage.html b/tests/github/whatwg/storage/storage.html index a754b8e800..adc57e82eb 100644 --- a/tests/github/whatwg/storage/storage.html +++ b/tests/github/whatwg/storage/storage.html @@ -49,7 +49,7 @@
-

+

Storage

Living Standard — Last Updated

@@ -61,7 +61,7 @@

IRC: #whatwg on Freenode
Commits:
GitHub whatwg/storage/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@storagestandard
Tests:
web-platform-tests storage/ (ongoing work) diff --git a/tests/github/whatwg/streams/index.html b/tests/github/whatwg/streams/index.html index 4451f7850b..48618e4476 100644 --- a/tests/github/whatwg/streams/index.html +++ b/tests/github/whatwg/streams/index.html @@ -67,7 +67,7 @@
-

+

Streams

Living Standard — Last Updated

@@ -79,7 +79,7 @@

IRC: #whatwg on Freenode
Commits:
GitHub whatwg/streams/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@streamsstandard
Tests:
web-platform-tests streams/ (ongoing work) diff --git a/tests/github/whatwg/url/url.html b/tests/github/whatwg/url/url.html index b97ed11c40..63b6e425c3 100644 --- a/tests/github/whatwg/url/url.html +++ b/tests/github/whatwg/url/url.html @@ -49,7 +49,7 @@
-

+

URL

Living Standard — Last Updated

@@ -61,7 +61,7 @@

IRC: #whatwg on Freenode
Commits:
GitHub whatwg/url/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@urlstandard
Tests:
web-platform-tests url/ (ongoing work) diff --git a/tests/github/whatwg/xhr/xhr.html b/tests/github/whatwg/xhr/xhr.html index c56a64caa0..bcdf602d1e 100644 --- a/tests/github/whatwg/xhr/xhr.html +++ b/tests/github/whatwg/xhr/xhr.html @@ -49,7 +49,7 @@
-

+

XMLHttpRequest

Living Standard — Last Updated

@@ -61,7 +61,7 @@

IRC: #whatwg on Freenode
Commits:
GitHub whatwg/xhr/commits -
[SNAPSHOT-LINK] +
Snapshot as of this commit
@xhrstandard
Tests:
web-platform-tests xhr/ (ongoing work) diff --git a/tests/include004-files/include004-2.html b/tests/include004-files/include004-2.html new file mode 100644 index 0000000000..09c7af2fa7 --- /dev/null +++ b/tests/include004-files/include004-2.html @@ -0,0 +1,1561 @@ + + + + [TITLE] + + + + + + + +
+

+

[TITLE]

+

,

+
+
+
+
+ +
+
+
+

Abstract

+ [ABSTRACT] +
+
+ +
+

Success! +I’m the right file to include, +nested one folder deep, +not two!

+
+
+

Conformance

+

Conformance requirements are expressed with a combination of descriptive assertions and RFC 2119 terminology. + The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” + in the normative parts of this document + are to be interpreted as described in RFC 2119. + However, for readability, + these words do not appear in all uppercase letters in this specification.

+

All of the text of this specification is normative + except sections explicitly marked as non-normative, examples, and notes. [RFC2119]

+

Examples in this specification are introduced with the words “for example” + or are set apart from the normative text with class="example", like this:

+
This is an example of an informative example.
+

Informative notes begin with the word “Note” + and are set apart from the normative text with class="note", like this:

+

Note, this is an informative note.

+
+ +

References

+

Normative References

+
+
[RFC2119] +
S. Bradner. Key words for use in RFCs to Indicate Requirement Levels. March 1997. Best Current Practice. URL: https://tools.ietf.org/html/rfc2119 +
\ No newline at end of file diff --git a/tests/include004-files/include004-files/include004-2.html b/tests/include004-files/include004-files/include004-2.html new file mode 100644 index 0000000000..08fe784714 --- /dev/null +++ b/tests/include004-files/include004-files/include004-2.html @@ -0,0 +1,1562 @@ + + + + [TITLE] + + + + + + + +
+

+

[TITLE]

+

,

+
+
+
+
+ +
+
+
+

Abstract

+ [ABSTRACT] +
+
+ +
+

Failure! +I’m nested two deep, +so the only way to reach me is if the nested include’s path +was resolved relative to its own location, +rather than the parent doc’s location!

+
+
+

Conformance

+

Conformance requirements are expressed with a combination of descriptive assertions and RFC 2119 terminology. + The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” + in the normative parts of this document + are to be interpreted as described in RFC 2119. + However, for readability, + these words do not appear in all uppercase letters in this specification.

+

All of the text of this specification is normative + except sections explicitly marked as non-normative, examples, and notes. [RFC2119]

+

Examples in this specification are introduced with the words “for example” + or are set apart from the normative text with class="example", like this:

+
This is an example of an informative example.
+

Informative notes begin with the word “Note” + and are set apart from the normative text with class="note", like this:

+

Note, this is an informative note.

+
+ +

References

+

Normative References

+
+
[RFC2119] +
S. Bradner. Key words for use in RFCs to Indicate Requirement Levels. March 1997. Best Current Practice. URL: https://tools.ietf.org/html/rfc2119 +
\ No newline at end of file diff --git a/tests/include004-files/include004-files/include004.html b/tests/include004-files/include004-files/include004.html new file mode 100644 index 0000000000..08fe784714 --- /dev/null +++ b/tests/include004-files/include004-files/include004.html @@ -0,0 +1,1562 @@ + + + + [TITLE] + + + + + + + +
+

+

[TITLE]

+

,

+
+
+
+
+ +
+
+
+

Abstract

+ [ABSTRACT] +
+
+ +
+

Failure! +I’m nested two deep, +so the only way to reach me is if the nested include’s path +was resolved relative to its own location, +rather than the parent doc’s location!

+
+
+

Conformance

+

Conformance requirements are expressed with a combination of descriptive assertions and RFC 2119 terminology. + The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” + in the normative parts of this document + are to be interpreted as described in RFC 2119. + However, for readability, + these words do not appear in all uppercase letters in this specification.

+

All of the text of this specification is normative + except sections explicitly marked as non-normative, examples, and notes. [RFC2119]

+

Examples in this specification are introduced with the words “for example” + or are set apart from the normative text with class="example", like this:

+
This is an example of an informative example.
+

Informative notes begin with the word “Note” + and are set apart from the normative text with class="note", like this:

+

Note, this is an informative note.

+
+ +

References

+

Normative References

+
+
[RFC2119] +
S. Bradner. Key words for use in RFCs to Indicate Requirement Levels. March 1997. Best Current Practice. URL: https://tools.ietf.org/html/rfc2119 +
\ No newline at end of file diff --git a/tests/include004-files/include004.html b/tests/include004-files/include004.html new file mode 100644 index 0000000000..3de57d6536 --- /dev/null +++ b/tests/include004-files/include004.html @@ -0,0 +1,1574 @@ + + + + [TITLE] + + + + + + + +
+

+

[TITLE]

+

,

+
+
+
+
+ +
+
+
+

Abstract

+ [ABSTRACT] +
+
+ +
+

This first include should fail—because include paths are relative *to the source document*, +not the included document, +this will result in an attempted circular import +and show nothing between the end of this text and the <hr>:

+

Failure! +I’m nested two deep, +so the only way to reach me is if the nested include’s path +was resolved relative to its own location, +rather than the parent doc’s location!

+
+

This second include should work, +and report success:

+

Failure! +I’m nested two deep, +so the only way to reach me is if the nested include’s path +was resolved relative to its own location, +rather than the parent doc’s location!

+
+
+

Conformance

+

Conformance requirements are expressed with a combination of descriptive assertions and RFC 2119 terminology. + The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” + in the normative parts of this document + are to be interpreted as described in RFC 2119. + However, for readability, + these words do not appear in all uppercase letters in this specification.

+

All of the text of this specification is normative + except sections explicitly marked as non-normative, examples, and notes. [RFC2119]

+

Examples in this specification are introduced with the words “for example” + or are set apart from the normative text with class="example", like this:

+
This is an example of an informative example.
+

Informative notes begin with the word “Note” + and are set apart from the normative text with class="note", like this:

+

Note, this is an informative note.

+
+ +

References

+

Normative References

+
+
[RFC2119] +
S. Bradner. Key words for use in RFCs to Indicate Requirement Levels. March 1997. Best Current Practice. URL: https://tools.ietf.org/html/rfc2119 +
\ No newline at end of file