Re: [virtio] Third try (!?) Starter Document for Virtual I/O Device (VIRTIO) Version 1.0

["Michael S. Tsirkin" <mst@redhat.com>]

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" <mst@redhat.com> 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