[virtio-comment] [PATCH 0/3] some editorial patches for 1.3-csd01

[virtio-comment] [PATCH 0/3] some editorial patches for 1.3-csd01

[Cornelia Huck]

Incorporate some feedback, and work around a possible bug in latexdiff --
should hopefully be ready now for public review, keeping fingers crossed...

Cornelia Huck (3):
  editorial: various fixes for 1.3-csd01
  editorial: update "Computer Language Definitions" URL
  makediff: update list of cherry-picks

 REVISION         |  2 +-
 REVISION-DATE    |  2 +-
 changelog.tex    |  2 +-
 introduction.tex | 11 +++++++++--
 makediff.sh      |  3 +--
 title.tex        | 15 ++++++---------
 6 files changed, 19 insertions(+), 16 deletions(-)

-- 
2.41.0


This publicly archived list offers a means to provide input to the
OASIS Virtual I/O Device (VIRTIO) TC.

In order to verify user consent to the Feedback License terms and
to minimize spam in the list archive, subscription is required
before posting.

Subscribe: virtio-comment-subscribe@lists.oasis-open.org
Unsubscribe: virtio-comment-unsubscribe@lists.oasis-open.org
List help: virtio-comment-help@lists.oasis-open.org
List archive: https://lists.oasis-open.org/archives/virtio-comment/
Feedback License: https://www.oasis-open.org/who/ipr/feedback_license.pdf
List Guidelines: https://www.oasis-open.org/policies-guidelines/mailing-lists
Committee: https://www.oasis-open.org/committees/virtio/
Join OASIS: https://www.oasis-open.org/join/

[virtio-comment] [PATCH 1/3] editorial: various fixes for 1.3-csd01

[Cornelia Huck]

- Set approval date to 06 October 2023. (applies to front page subtitle,
citation format, PDF page footers)
- Set filenames and URIs to show csd01 instead of wd01 (also PDF footers)
- Set "Previous stage" to "N/A" (don't list a different numbered Version)
- In "Related work", change (3x) text - "Latest version" to "Latest stage"
- In "Notices", set the copyright year to 2023.

- In the first line of Appendix D. Revision History, replace "the previous
version" with "Version 1.2"

- In Section 1.3, apply the current IETF-recommended text:
"The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described in BCP 14
[[RFC2119](#link)] and [[RFC8174](#link)] when, and only when, they appear
in all capitals, as shown here."
- Also, add the RFC 8174 reference:
[RFC8174]
Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP
14, RFC 8174, DOI 10.17487/RFC8174, May 2017,
https://www.rfc-editor.org/info/rfc8174.

Reported-by: Paul Knight <paul.knight@oasis-open.org>
Signed-off-by: Cornelia Huck <cohuck@redhat.com>
---
 REVISION         |  2 +-
 REVISION-DATE    |  2 +-
 changelog.tex    |  2 +-
 introduction.tex | 11 +++++++++--
 title.tex        | 13 +++++--------
 5 files changed, 17 insertions(+), 13 deletions(-)

diff --git a/REVISION b/REVISION
index d2c53b5f9201..ba56baf05d69 100644
--- a/REVISION
+++ b/REVISION
@@ -1 +1 @@
-virtio-v1.3-wd01
+virtio-v1.3-csd01
diff --git a/REVISION-DATE b/REVISION-DATE
index 6c68e6b0e8a9..d149b6e782f5 100644
--- a/REVISION-DATE
+++ b/REVISION-DATE
@@ -1 +1 @@
-25 August 2023
+06 October 2023
diff --git a/changelog.tex b/changelog.tex
index 76fbd37693aa..51ca2a68ccf9 100644
--- a/changelog.tex
+++ b/changelog.tex
@@ -1,5 +1,5 @@
 \chapter{Revision History}
-The following changes have been made since the previous version
+The following changes have been made since version 1.2
 of this specification:
 
 \begin{DIFnomarkup}
diff --git a/introduction.tex b/introduction.tex
index 1e39a4b2c529..cfa6633bad81 100644
--- a/introduction.tex
+++ b/introduction.tex
@@ -141,6 +141,10 @@ \section{Normative References}\label{sec:Normative References}
 	\phantomsection\label{intro:TCP}\textbf{[TCP]} &
     TRANSMISSION CONTROL PROTOCOL
 	\newline\url{https://www.rfc-editor.org/rfc/rfc793}\\
+	\phantomsection\label{intro:rfc2119}\textbf{[RFC8174]} &
+    Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP
+    14, RFC 8174, DOI 10.17487/RFC8174, May 2017
+        \newline\url{http://www.ietf.org/rfc/rfc8174.txt}\\
 \end{longtable}
 
 \section{Non-Normative References}
@@ -153,8 +157,11 @@ \section{Non-Normative References}
 
 \section{Terminology}\label{Terminology}
 
-The key words ``MUST'', ``MUST NOT'', ``REQUIRED'', ``SHALL'', ``SHALL NOT'', ``SHOULD'', ``SHOULD NOT'', ``RECOMMENDED'', ``MAY'', and ``OPTIONAL'' in this document are to be interpreted as described in \hyperref[intro:rfc2119]{[RFC2119]}.
-
+The key words ``MUST'', ``MUST NOT'', ``REQUIRED'', ``SHALL'', ``SHALL NOT'',
+``SHOULD'', ``SHOULD NOT'', ``RECOMMENDED'', ``NOT RECOMMENDED'', ``MAY'', and
+``OPTIONAL'' in this document are to be interpreted as described in
+\hyperref[intro:rfc2119]{[RFC2119]} and \hyperref[intro:rfc8174]{[RFC8174]} when,
+and only when, they appear in all capitals, as shown here.
 \subsection{Legacy Interface: Terminology}\label{intro:Legacy
 Interface: Terminology}
 
diff --git a/title.tex b/title.tex
index 23c0a1a39d24..f3c8f97a361f 100644
--- a/title.tex
+++ b/title.tex
@@ -18,10 +18,7 @@
 \end{oasistitlesection}
 
 \begin{oasistitlesection}{Previous stage}
-\url{https://docs.oasis-open.org/virtio/virtio/v1.2/csd01/tex/}
-{}(Authoritative)\newline
-\url{https://docs.oasis-open.org/virtio/virtio/v1.2/csd01/virtio-v1.2-csd01.pdf}\newline
-\url{https://docs.oasis-open.org/virtio/virtio/v1.2/csd01/virtio-v1.2-csd01.html}
+N/A
 \end{oasistitlesection}
 
 \begin{oasistitlesection}{Latest stage}
@@ -57,12 +54,12 @@
 \begin{oasistitlesection}{Related work}
 This specification replaces or supersedes:
 \begin{itemize*}
-	\item Virtual I/O Device (VIRTIO) Version 1.2. Edited by Michael S. Tsirkin and Cornelia Huck. Latest version:\newline
+	\item Virtual I/O Device (VIRTIO) Version 1.2. Edited by Michael S. Tsirkin and Cornelia Huck. Latest stage:\newline
 	\url{https://docs.oasis-open.org/virtio/virtio/v1.2/virtio-v1.2.html}
-	\item Virtual I/O Device (VIRTIO) Version 1.1. Edited by Michael S. Tsirkin and Cornelia Huck. Latest version:\newline
+	\item Virtual I/O Device (VIRTIO) Version 1.1. Edited by Michael S. Tsirkin and Cornelia Huck. Latest stage:\newline
 	\url{https://docs.oasis-open.org/virtio/virtio/v1.1/virtio-v1.1.html}
 	\item Virtual I/O Device (VIRTIO) Version 1.0. Edited by Rusty Russell, Michael S. Tsirkin, Cornelia Huck, and Pawel
- Moll. Latest version:\newline
+ Moll. Latest stage:\newline
 	\url{https://docs.oasis-open.org/virtio/virtio/v1.0/virtio-v1.0.html}
 	\item Virtio PCI Card Specification Version 0.9.5:\newline
 	\url{http://ozlabs.org/~rusty/virtio-spec/virtio-0.9.5.pdf}
@@ -127,7 +124,7 @@
 
 \oasisnoticelabel{Notices}
 
-Copyright © OASIS Open 2022. All Rights Reserved.
+Copyright © OASIS Open 2023. All Rights Reserved.
 
 All capitalized terms in the following text have the meanings assigned
 to them in the OASIS Intellectual Property Rights Policy (the "OASIS
-- 
2.41.0


This publicly archived list offers a means to provide input to the
OASIS Virtual I/O Device (VIRTIO) TC.

In order to verify user consent to the Feedback License terms and
to minimize spam in the list archive, subscription is required
before posting.

Subscribe: virtio-comment-subscribe@lists.oasis-open.org
Unsubscribe: virtio-comment-unsubscribe@lists.oasis-open.org
List help: virtio-comment-help@lists.oasis-open.org
List archive: https://lists.oasis-open.org/archives/virtio-comment/
Feedback License: https://www.oasis-open.org/who/ipr/feedback_license.pdf
List Guidelines: https://www.oasis-open.org/policies-guidelines/mailing-lists
Committee: https://www.oasis-open.org/committees/virtio/
Join OASIS: https://www.oasis-open.org/join/

[virtio-comment] [PATCH 2/3] editorial: update "Computer Language Definitions" URL

[Cornelia Huck]

Split out from the other fixes for 1.3-csd01 so that we can fixup the
diff.

- In "Status", (fourth paragraph) change the hyperlink under (Computer
Language Definitions) to be "
https://www.oasis-open.org/policies-guidelines/tc-process-2017-05-26/#wpComponentsCompLang
"

Reported-by: Paul Knight <paul.knight@oasis-open.org>
Signed-off-by: Cornelia Huck <cohuck@redhat.com>
---
 title.tex | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/title.tex b/title.tex
index f3c8f97a361f..bf08d33d4a52 100644
--- a/title.tex
+++ b/title.tex
@@ -101,7 +101,7 @@
 \input{ipr.tex}
 
 Note that any machine-readable content
-(\href{https://www.oasis-open.org/policies-guidelines/tc-process#wpComponentsCompLang}
+(\href{https://www.oasis-open.org/policies-guidelines/tc-process-2017-05-26/#wpComponentsCompLang}
 {Computer Language Definitions}) declared Normative for this Work
 Product is provided in separate plain text files. In the event of
 a discrepancy between any such plain text file and display
-- 
2.41.0


This publicly archived list offers a means to provide input to the
OASIS Virtual I/O Device (VIRTIO) TC.

In order to verify user consent to the Feedback License terms and
to minimize spam in the list archive, subscription is required
before posting.

Subscribe: virtio-comment-subscribe@lists.oasis-open.org
Unsubscribe: virtio-comment-unsubscribe@lists.oasis-open.org
List help: virtio-comment-help@lists.oasis-open.org
List archive: https://lists.oasis-open.org/archives/virtio-comment/
Feedback License: https://www.oasis-open.org/who/ipr/feedback_license.pdf
List Guidelines: https://www.oasis-open.org/policies-guidelines/mailing-lists
Committee: https://www.oasis-open.org/committees/virtio/
Join OASIS: https://www.oasis-open.org/join/

[virtio-comment] [PATCH 3/3] makediff: update list of cherry-picks

[Cornelia Huck]

We don't need to apply the old commits anymore, but we have to apply
the URL update to work around a not-yet-debugged latexdiff problem.

Signed-off-by: Cornelia Huck <cohuck@redhat.com>
---
 makediff.sh | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/makediff.sh b/makediff.sh
index f65a2b43676a..897eeaded83e 100755
--- a/makediff.sh
+++ b/makediff.sh
@@ -20,8 +20,7 @@ while read -r rev; do
 	echo "Applying $rev"
 	git cherry-pick --keep-redundant-commits --allow-empty `git rev-list -1 -F --grep "$rev" $newrev` || exit 1
 done << 'EOF'
-headerfile: rename virtio_ring to virtio queue
-edit: drop obsolete commands related to cs02
+editorial: update "Computer Language Definitions" URL
 EOF
 
 #mv specvars.tex specvars-orig.tex
-- 
2.41.0


This publicly archived list offers a means to provide input to the
OASIS Virtual I/O Device (VIRTIO) TC.

In order to verify user consent to the Feedback License terms and
to minimize spam in the list archive, subscription is required
before posting.

Subscribe: virtio-comment-subscribe@lists.oasis-open.org
Unsubscribe: virtio-comment-unsubscribe@lists.oasis-open.org
List help: virtio-comment-help@lists.oasis-open.org
List archive: https://lists.oasis-open.org/archives/virtio-comment/
Feedback License: https://www.oasis-open.org/who/ipr/feedback_license.pdf
List Guidelines: https://www.oasis-open.org/policies-guidelines/mailing-lists
Committee: https://www.oasis-open.org/committees/virtio/
Join OASIS: https://www.oasis-open.org/join/