aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael S. Tsirkin <mst@redhat.com>2019-01-11 17:09:10 -0500
committerMichael S. Tsirkin <mst@redhat.com>2019-01-11 17:14:14 -0500
commit1a6406d93270b943f7181c141e3e7ec10db6a7dd (patch)
treefebcfc5a5cb374e8f3f8c86104f007951e6494a7
parent990739a0c87b76bf2f1725b27707c6cd9c805103 (diff)
downloadvirtio-text-1a6406d93270b943f7181c141e3e7ec10db6a7dd.tar.gz
edit: address comments by Paul Knight
Several changes will be needed to the documents prepared by the TC: - date should be set to "20 December 2018" in subtitle, page footers, and citation format - "Previous version" should just show "N/A" instead of URIs from v1.0-cs04 (this is a new Version) - use "https" instead of http for all URIs for this specification. (including citation format) - insert actual stage name - "csprd01" instead of "wd12122018" in all of the URIs - replace "Working Draft" with "Committee Specification Draft 01 / Public Review Draft 01" in subtitle and in Citation format text. - change the "title" attribute/tag in the HTML file to be "Virtual I/O Device (VIRTIO) Version 1.1" instead of "... Version 1.0" - add reference to VIRTIO v1.0 in the "Related work" section, similar to the 0.9.5 reference (replaces or supersedes) - (Virtual I/O Device (VIRTIO) Version 1.0. Edited by Rusty Russell, Michael S. Tsirkin, Cornelia Huck, and Pawel Moll. Latest version: http://docs.oasis-open.org/virtio/virtio/v1.0/ virtio-v1.0.html.) - copied from v1.0-cs04 citation format block, with specific stage removed - set the copyright year to be 2018. (in "Notices" and in page footers (PDF)) - in "Citation format" only list the currently identified Editors - Michael S. Tsirkin and Cornelia Huck (or add other names into "Editors" list near top) - change "Chairs" to "Chair" near top - add the new IPR Policy text in the Status section and as Section 1.1 in the body (details below) - add the note on machine-readable content as the fourth paragraph in Status section (details below) Paragraph 3 of Status section AND Section 1.1 of the specification body "1.1 IPR Policy": <visible text><hyperlink> This specification is provided under the <Non-Assertion><https:// www.oasis-open.org/policies-guidelines/ipr#Non-Assertion-Mode> Mode of the <OASIS IPR Policy><https://www.oasis-open.org/policies-guidelines/ipr>, the mode chosen when the Technical Committee was established. For information on whether any patents have been disclosed that may be essential to implementing this specification, and any offers of patent licensing terms, please refer to the Intellectual Property Rights section of the TC's web page (<https:// www.oasis-open.org/committees/virtio/ipr.php><https://www.oasis-open.org/ committees/virtio/ipr.php>). Paragraph 4 of Status section: Note that any machine-readable content (<Computer Language Definitions><https:/ /www.oasis-open.org/policies-guidelines/tc-process#wpComponentsCompLang>) 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 content in the Work Product's prose narrative document(s), the content in the separate plain text file prevails. Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
-rw-r--r--ipr.tex8
-rw-r--r--specvars.tex8
-rw-r--r--title.tex33
-rw-r--r--virtio-html.cfg2
4 files changed, 33 insertions, 18 deletions
diff --git a/ipr.tex b/ipr.tex
new file mode 100644
index 0000000..d0c3207
--- /dev/null
+++ b/ipr.tex
@@ -0,0 +1,8 @@
+This specification is provided under the
+\href{https://www.oasis-open.org/policies-guidelines/ipr#Non-Assertion-Mode}{Non-Assertion} Mode of the
+\href{https://www.oasis-open.org/policies-guidelines/ipr}{OASIS IPR Policy}, the
+mode chosen when the Technical Committee was established. For information on
+whether any patents have been disclosed that may be essential to implementing
+this specification, and any offers of patent licensing terms, please refer to
+the Intellectual Property Rights section of the TC's web page
+(\url{https://github.com/oasis-tcs/virtio-admin/blob/master/IPR.md}).
diff --git a/specvars.tex b/specvars.tex
index 84f8bae..8cecf6f 100644
--- a/specvars.tex
+++ b/specvars.tex
@@ -1,17 +1,17 @@
\input{setup-generated.tex}
\newcommand{\virtioversion}{Virtual I/O Device (VIRTIO) Version \virtiorev}
\newcommand{\virtiospecfile}{virtio-v\virtiorev-\virtiodraftstage\virtioworkingdraft}
-\newcommand{\virtiourlbase}{http://docs.oasis-open.org/virtio/virtio/v\virtiorev/\virtiodraftstage\virtioworkingdraft}
+\newcommand{\virtiourlbase}{https://docs.oasis-open.org/virtio/virtio/v\virtiorev/\virtiodraftstage\virtioworkingdraft}
%Below must be used to make links work correctly in HTML
\urldef \virtiourllistings\url{\virtiourlbase/listings/}
\urldef \virtiourltex\url{\virtiourlbase/tex/}
\urldef \virtiourlpdf\url{\virtiourlbase/\virtiospecfile.pdf}
\urldef \virtiourlhtml\url{\virtiourlbase/\virtiospecfile.html}
\urldef \virtiourlh\url{\virtiourlbase/listings/virtio_queue.h}
-\urldef \virtiourllatestpdf\url{http://docs.oasis-open.org/virtio/virtio/v\virtiorev/virtio-v\virtiorev.pdf}
-\urldef \virtiourllatesthtml\url{http://docs.oasis-open.org/virtio/virtio/v\virtiorev/virtio-v\virtiorev.html}
+\urldef \virtiourllatestpdf\url{https://docs.oasis-open.org/virtio/virtio/v\virtiorev/virtio-v\virtiorev.pdf}
+\urldef \virtiourllatesthtml\url{https://docs.oasis-open.org/virtio/virtio/v\virtiorev/virtio-v\virtiorev.html}
\newcommand{\virtioworkproduct}{Standards Track Work Product}
-\newcommand{\virtiooasiscopyright}{Copyright © OASIS Open 2015. All Rights Reserved.}
+\newcommand{\virtiooasiscopyright}{Copyright © OASIS Open 2018. All Rights Reserved.}
% PDF setup
\hypersetup{
diff --git a/title.tex b/title.tex
index 67aa064..5b42e76 100644
--- a/title.tex
+++ b/title.tex
@@ -20,10 +20,7 @@
\end{oasistitlesection}
\begin{oasistitlesection}{Previous version}
-\url{http://docs.oasis-open.org/virtio/virtio/v1.0/cs04/tex/}
-{}(Authoritative)\newline
-\url{http://docs.oasis-open.org/virtio/virtio/v1.0/cs04/virtio-v1.0-cs04.pdf}\newline
-\url{http://docs.oasis-open.org/virtio/virtio/v1.0/cs04/virtio-v1.0-cs04.html}
+N/A
\end{oasistitlesection}
\begin{oasistitlesection}{Latest version}
@@ -35,7 +32,7 @@
\href{https://www.oasis-open.org/committees/virtio/}{OASIS Virtual I/O Device (VIRTIO) TC}
\end{oasistitlesection}
-\begin{oasistitlesection}{Chairs}
+\begin{oasistitlesection}{Chair}
Michael S. Tsirkin (\href{mailto:mst@redhat.com}{mst@redhat.com}), \href{http://www.redhat.com/}{Red Hat}\newline
\end{oasistitlesection}
@@ -57,6 +54,10 @@ This prose specification is one component of a Work Product that also includes:
\begin{oasistitlesection}{Related work}
This specification replaces or supersedes:
\begin{itemize*}
+ \item Virtual I/O Device (VIRTIO) Version 1.0. Edited by Rusty Russell, Michael S. Tsirkin, Cornelia Huck, and Pawel
+ Moll. Latest version:\newline
+ \url{https://docs.oasis-open.org/virtio/virtio/v1.0/virtio-v1.0.html}
+ \url{http://ozlabs.org/~rusty/virtio-spec/virtio-0.9.5.pdf}
\item Virtio PCI Card Specification Version 0.9.5:\newline
\url{http://ozlabs.org/~rusty/virtio-spec/virtio-0.9.5.pdf}
\end{itemize*}
@@ -94,11 +95,16 @@ should send comments to the Technical Committee by using the
A Comment}'' button on the Technical Committee’s web page at
\url{https://www.oasis-open.org/committees/virtio/}.
-For information on whether any patents have been disclosed that
-may be essential to implementing this specification, and any
-offers of patent licensing terms, please refer to the
-Intellectual Property Rights section of the Technical Committee
-web page (\url{https://www.oasis-open.org/committees/virtio/ipr.php}).
+\input{ipr.tex}
+
+Note that any machine-readable content
+(\href{https://www.oasis-open.org/policies-guidelines/tc-process#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
+content in the Work Product's prose narrative document(s), the
+content in the separate plain text file prevails.
+
\end{oasistitlesection}
@@ -106,8 +112,7 @@ web page (\url{https://www.oasis-open.org/committees/virtio/ipr.php}).
When referencing this specification the following citation format should be used:\newline
\textbf{[VIRTIO-v\virtiorev]}\newline
-\textit{\virtioversion}. Edited by Rusty Russell, Michael S.
-Tsirkin, Cornelia Huck, and Pawel Moll. \virtioworkingdraftdate.
+\textit{\virtioversion}. Edited by Michael S. Tsirkin and Cornelia Huck. \virtioworkingdraftdate.
\virtiodraftoasisstagename \virtiodraftstageextra . \virtiourlhtml .
Latest version: \virtiourllatesthtml .
\end{oasistitlesection}
@@ -116,7 +121,7 @@ Latest version: \virtiourllatesthtml .
\oasisnoticelabel{Notices}
-Copyright © OASIS Open 2015. All Rights Reserved.
+Copyright © OASIS Open 2018. 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
@@ -135,6 +140,8 @@ Committee (in which case the rules applicable to copyrights, as set
forth in the OASIS IPR Policy, must be followed) or as required to
translate it into languages other than English.
+\input{ipr.tex}
+
The limited permissions granted above are perpetual and will not be
revoked by OASIS or its successors or assigns.
diff --git a/virtio-html.cfg b/virtio-html.cfg
index bf4c89b..80212aa 100644
--- a/virtio-html.cfg
+++ b/virtio-html.cfg
@@ -17,7 +17,7 @@
%%\Configure{HColWidth}{\HCode{ style="min-width:\HColWidth"}}
- \Configure{@TITLE}{Virtual I/O Device (VIRTIO) Version 1.0}
+ \Configure{@TITLE}{Virtual I/O Device (VIRTIO) Version 1.1}
\Css{body { font-family: Arial, Helvetica, sans-serif; font-size: 10pt; }}
\Css{h1 { color:\#552681; font-size:150\%; }}
\Css{h2 { color:\#552681; font-size:140\%; }}