Re: [virtio] Re: [virtio-comment] can we do better than text?

[Rusty Russell <rusty@au1.ibm.com>]

Chet Ensign <chet.ensign@oasis-open.org> writes:
> Hi Michael,
>
> Moving this off the -comment@ list to the main TC mailing list.
>
> Several TCs are using DocBook XML to author their specs if you want to look
> at that approach. And the CMIS TC used Tex to publish their specification
> (see http://docs.oasis-open.org/cmis/CMIS/v1.1/CMIS-v1.1.html).

Yes, text is easiest to send diffs against, but I figure we'll translate
to XML once the main changes are in.

I have been ignoring cross-refs and section numbers.  Just put FIXME in
for cross-references, and we will fix them up towards the end, eg:

        used to allow this (see FIXME: Reserved Feature Bits). To increase 

Thanks,
Rusty.

> On Mon, Aug 26, 2013 at 4:56 PM, Michael S. Tsirkin <mst@redhat.com> wrote:
>
>> I'm editing the spec in text format, and keeping numbering and
>> cross-references consistent is a huge pain.
>>
>> for now I'm just avoiding any numbering changes
>> and adding cross-references, but I'm not sure we can
>> keep going like this.
>>
>> Unless we want to go back to lyx, or latex, any
>> better ideas on how to do this?
>>
>> 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/
>>
>>
>
>
> -- 
>
> /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