Re: [virtio] We need fixes to the csd and csprd before we can load them

From
Chet Ensign <>
Date
2014-03-24T21:26:00+00:00
ID
Thread
Re: [virtio] We need fixes to the csd and csprd before we can load them
Yes, that'll work fine. Thanks.
On Mon, Mar 24, 2014 at 5:13 PM, Michael S. Tsirkin  < 
>  wrote:
On Mon, Mar 24, 2014 at 02:29:03PM -0400, Chet Ensign wrote:
> First of all, best wishes to you and your family. I still recall the excitement
> when my daughter was born!  >
> We noted that the TeX was voted as authoritative. If that is the case then
> you'll need to add the TeX directory to the This version and Latest version
> links and - is there a master driver file from which all the others are
> processed or assembled? I never did work with TeX but assuming there is, that I
> suppose would be the file to point to. You'll also have to take the  > (Authoritative) designation off the PDF files.
Hmm yes but the master file is mostly empty - it just has names  of included sub-files.  I think it's best to point at a zip archive with  all the necessary files.  Is that OK?
>
> On Sun, Mar 23, 2014 at 9:45 PM, Rusty Russell < 
> wrote:  >
>     Hi,  >
>             My wife went into labor on Friday morning, so things are a bit
>     hectic here.  Michael, can you please organise this?  >
>     We had voted to make the TeX source authoritative for this version, BTW.  >
>     Thanks,
>     Rusty.  >  >     "Michael S. Tsirkin" < 
> writes:  >
> On Thu, Mar 20, 2014 at 01:15:13PM -0400, Chet Ensign wrote:  >     >> Members of the VIRTIO TC,  >     >>  >     >> We are working on your Committee Spec Draft and public review for the
>     2nd csprd  >     >> for VIRTIO ( https://tools.oasis-open.org/issues/browse/TCADMIN-1638  and  >     /  >     >>  tools.oasis-open.org/issues/browse/TCADMIN-1641 ).  >     >>  >     >> In working on these, we have encountered some items that need to be
>     fixed. As  >     >> you produce the documents, we ask that you make these and send us an
>     updated  >     >> set of zip files. Here is what we need:  >     >>  >     >> 1) cover page changes needed for csd02  >     >>  >     >> - This version:  >     >>  >     >> -- both tex and pdf are listed as authoritative. obviously 2 versions
>     can’t be  >     >> authoritative. since pdf has been authoritative before, it seems best to
>     stay  >     >> with that but regardless, please indicate one authoritative source  >     (Latest,  >     >> Previous, This)  >     >>  >     >> -- assuming PDF is labelled authoritative, remove /tex directory. It is  >     >> indicated in the Additional artifacts section below  >     >>  >     >> - Previous version:  >     >>

--
Change links to  >     >>  http://docs.oasis-open.org/virtio/virtio/v1.0/csprd01/
>     virtio-v1.0-csprd01.pdf  >     >>  http://docs.oasis-open.org/virtio/virtio/v1.0/csprd01/
>     virtio-v1.0-csprd01.html  >     >>  >     >>

--
Label the PDF version (Authoritative)  >     >>  >     >> - Latest version:  >     >>

--
Label the PDF version (Authoritative)  >     >>  >     >> - Editors:  >     >>

--
Pawel’s link under ARM goes to a download page not to the company
>     page.  >     >> Should be changed to  http://www.arm.com
>     >>  >     >> - Citation format:  >     >> We updated our citation model a few months ago to include the editors
>     and the  >     >> Latest version link. Please update the citation block to read:  >     >>  >     >> [VIRTIO-v1.0]  >     >>  >     >> <italics>Virtual I/O Device (VIRTIO)

Version 1.0</>. Edited by Michael
>     S.  >     >> Tsirkin, Cornelia Huck, and Pawel Moll. 11 March 2014. OASIS Committee  >     >> Specification Draft 02.  http://docs.oasis-open.org/virtio/virtio/v1.0/
>     csd02/  >     >> virtio-v1.0-csd02.html. Latest version:  http://docs.oasis-open.org/
>     virtio/  >     >> virtio/v1.0/virtio-v1.0.html.  >     >>  >     >> *Note that “OASIS” is also added before “Committee Specification Draft
>     02” for  >     >> the csd and before "Committee Specification Draft 02 / Public Review
>     Draft 02"  >     >> for the csprd.  >     >>  >     >> - Notices:  >     >> Set copyright year to 2014  >     >>  >     >> - In PDF, for footer:  >     >> Set copyright year to 2014.  >     >>  >     >> 2) cover page changes needed for csprd02:  >     >>  >     >> - Same changes as for the csd02 files.  >     >>  >     >>

--
Plus: The ZIP file contains all the individual html files for the
>     footnotes,  >     >> but they are not needed.  They should be removed. I think the TC removed
>     them  >     >> in the csd02 files, but not in the csprd02 files. (csprd02 footnotes
>     work fine  >     >> without the files - the footnotes are embedded and linked in the main  >     .html  >     >> file.)  >     >>  >     >>

--
We need a red-lined DIFF file in PDF between csprd02 and csprd01 that  >     >> displays the changes. We point out this to reviewers in order to limit
>     the  >     >> public review comments to only those that changed.  >     >  >
> Due to the huge number of formatting and text movement changes, we ended  >
> up with almost all of the file red-lined.  On the TC, we voted to  >
> produce csprd02 and csd02 without this DIFF and start producing DIFF  >
> files from version 03.  >     >  >
> I hope this is acceptable.  >     >  >     >> 3) We need a comment resolution log from the TC for comments received in  >     >> csprd01  >     >  >
> I actually wrote a script to append the resolution changelog as last  >
> part of the file, but this was done after csd02/csprd02 were approved.  >
> Do you think appending the log is an acceptable change to make  >
> without re-doing the voting?  >     >  >     >> Thanks - if you can send me those files when they are ready, I'll update
>     the  >     >> ticket and we will continue to process the spec.  >     >>  >     >> Thanks & best,  >     >>  >     >> /chet  >     >  >
> I'll work on this shortly - unless Rusty already started?  >     >  >     >  >     >>  >     >>  >     >> --  >     >>  >     >> /chet  >     >>

----------------

>     >> Chet Ensign  >     >> Director of Standards Development and TC Administration  >     >> OASIS: Advancing open standards for the information society  >     >>  http://www.oasis-open.org
>     >>  >     >> Primary:  +1 973-996-2298
>     >>
Mobile:  +1 201-341-1393
>     >>  >     >> Check your work using the Support Request Submission Checklist at http:/  >     /  >     >>  www.oasis-open.org/committees/download.php/47248/
>     >> tc-admin-submission-checklist.html  >     >>  >     >> TC Administration information and support is available at http://  >     >>  www.oasis-open.org/resources/tcadmin
>     >>  >     >> Follow OASIS on:  >     >> LinkedIn:     http://linkd.in/OASISopen
>     >> Twitter:         http://twitter.com/OASISopen
>     >> Facebook:   http://facebook.com/oasis.open
>  >  >  >  > --  >  > /chet  >

----------------
> Chet Ensign
> Director of Standards Development and TC Administration
> OASIS: Advancing open standards for the information society
>  http://www.oasis-open.org
>
> Primary:  +1 973-996-2298
>
Mobile:  +1 201-341-1393
>
> Check your work using the Support Request Submission Checklist at http://
>  www.oasis-open.org/committees/download.php/47248/
> tc-admin-submission-checklist.html  >
> TC Administration information and support is available at http://
>  www.oasis-open.org/resources/tcadmin
>
> Follow OASIS on:
> LinkedIn:     http://linkd.in/OASISopen
> Twitter:         http://twitter.com/OASISopen
> Facebook:   http://facebook.com/oasis.open

---------------------------------------------------------------------

To unsubscribe from this mail list, you must leave the OASIS TC that  generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
--
/chet

----------------

Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society
http://www.oasis-open.org
Primary: +1 973-996-2298
Mobile: +1 201-341-1393

Check your work using the Support Request Submission Checklist at  http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html
TC Administration information and support is available at  http://www.oasis-open.org/resources/tcadmin
Follow OASIS on: LinkedIn:     http://linkd.in/OASISopen
Twitter:         http://twitter.com/OASISopen  Facebook:   http://facebook.com/oasis.open