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 10:31:21AM +0200, Michael S. Tsirkin wrote:
> 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.

Or go through latex. There are tools to produce latex from rst:
http://docutils.sourceforge.net/docs/user/links.html#pdf

We might be able to reuse the latex template from CMIS:
http://docs.oasis-open.org/cmis/CMIS/v1.1/os/tex/CMIS-v1.1-os-source.zip


> > -- 
> > MST