diff options
author | Michael S. Tsirkin <mst@redhat.com> | 2019-01-11 17:09:10 -0500 |
---|---|---|
committer | Michael S. Tsirkin <mst@redhat.com> | 2019-01-11 17:14:14 -0500 |
commit | 1a6406d93270b943f7181c141e3e7ec10db6a7dd (patch) | |
tree | febcfc5a5cb374e8f3f8c86104f007951e6494a7 | |
parent | 990739a0c87b76bf2f1725b27707c6cd9c805103 (diff) | |
download | virtio-spec-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.tex | 8 | ||||
-rw-r--r-- | specvars.tex | 8 | ||||
-rw-r--r-- | title.tex | 33 | ||||
-rw-r--r-- | virtio-html.cfg | 2 |
4 files changed, 33 insertions, 18 deletions
@@ -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{ @@ -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\%; }} |