Third try (!?) Starter Document for Virtual I/O Device (VIRTIO) Version 1.0

From
Michael S. Tsirkin <>
Date
2013-11-11T08:31:00+00:00
ID
Thread
Third try (!?) Starter Document for Virtual I/O Device (VIRTIO) Version 1.0
On Mon, Nov 11, 2013 at 09:34:20AM +0200, Michael S. Tsirkin wrote:
> On Mon, Nov 11, 2013 at 02:01:04PM +1030, Rusty Russell wrote:
> > "Michael S. Tsirkin" <> writes:
> >
> OK, I started looking at how we'll maintain this in SVN.
> > > .ODT files are zipped archives of XML files so
> >
> SVN does not handle them as well as text files.
> > >
> >
> So one option is to have a makefile to
> >
> unpack and re-pack this. I attach a version that
> >
> works for me, if we decide to go for it.
> > >
> >
> Another option is to switch to "flat XML" format which
> >
> puts all information in a single file but
> >
> unzipped:
> >
> https://forum.openoffice.org/en/forum/download/file.php?id=12494&sid=6904fd78ca8409766d28ac1f5c908e64
> >
> One downside is things like styles can easily change
> >
> uninitentionally, so we'll likely have trouble merging.
> > >
> >
> First option seems to better separate content from formatting,
> >
> and results in smaller file downloads for users,
> >
> but the second one is slightly easier to use.
> >
>
> We could, alternatively, use XML as the basis, but it seems a bit like
>
> overkill to me.  From now on, we can just use OO's internal change
>
> tracking and merging mechanisms.
>
> So what's the plan? Send openoffice documents as attachments?
> This means indexing by e.g. gmane becomes useless :(
>
> >
>
> Yes, it's a pain for pushing patches around on the mailing list,
>
> but it's easier for end users IMHO.
> >
>
> Cheers,
>
> Rusty.
>
> End users should just get a PDF, no?

Chet mentioned docbook, though that's not easy to use.

Maybe we can sue something simple like rst
http://docutils.sourceforge.net/docs/user/rst/quickref.html
and then convert on the fly.

> --
> MST