| Age | Commit message (Collapse) | Author |
|---|
|
This change:
- Turns formatted lists into real lists (itemize, etc).
- Turns ascii tables into real tables.
- Use \ldots for ...
- Moves \footnote to immediately after what it refers to, otherwise we
get awkward whitespace before the superscript.
- List of stats for balloon contains values in () to match other lists.
- Puts lstlisting around CCW code example
- Cross references to numbered steps, rather than hardcoded (2) etc.
No actual contents changed.
Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@148 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
The spec language is mostly written with a view to driver authors, and
contains assumptions, eg:
The Device Status field is updated by the OS and driver...
But the spec is for both device and driver authors. It should specify
exactly what is to be done, and by whom, eg:
The driver MUST update the Device Status field...
1) Change from passive to active (eg "foo must be reset" => "driver
must reset foo").
2) Upcase SHOULD, MUST etc. There are probably more that I missed.
3) Make the following requirements explicit:
- The driver must not clear device status bits.
- Make bad on looped descriptors explicit.
- Driver must not set VRING_DESC_F_INDIRECT unless negotiated feature.
- Available/used ring sections rewritten to be more explicit that driver
must not set VRING_AVAIL_F_NO_INTERRUPT.
- Following device initialization sequence is a MUST.
- Driver must not continue initialization if it sets FAILED.
- "memory barriers" are now a MUST, though the weasel-word "suitable"
was added.
- Driver MUST notify device.
4) Misc changes:
- Use "device offers" / "driver accepts" language for feature negotiation.
- config space always uses little-endian, remove 'generally'.
- "descriptor chain" term used everywhere.
- Extraneous "+" deleted.
- Remove "Unless explicitly specified otherwise" from PCI spec endian
sentence.
- Refer to notify_off_multiplier in queue_notify_off discussion.
Signed-off-by: Rusty Russell <rusty@au.ibm.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@147 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
The Linux code uses 0x2, so I assume second lowest bit is right...
Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@146 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
We've mixed both together, whereas from a spec-reader point of view,
"driver" and "device" is probably clearer.
CCW part incorporated:
Switch the parts of the virtio-ccw specification that did not already
to device/driver instead of guest/host. For more general discussions,
host/guest is kept (like when talking about guest<->host notifications
in general). This should make things more consistent.
Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com>
Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@145 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Use \urldef to make them expand macros.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@144 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
missing \
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@143 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Tweak output to match oasis requirements.
Make it possible to specify output name through
environment, and set draft stage and version
automatically.
Add script to export all files in a zip archive.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@142 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
htlatex doesn't seem to support -jobname for output
file name, so simply rename file before processing.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@141 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Rename virtio-v1.0-csd01.tex to virtio.tex,
so we don't have to rename before use.
Use --jobname for output.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@140 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
import abstract from abstract.tex
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@139 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
import from abstract.tex
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@138 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
move it out of introduction.tex, use \input
to avoid duplication. Fix a minor typo (the the).
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@137 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
We don't have related work and xml namespaces, so
comment them out.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@136 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Remove an ugly vfill, nicer to have space at bottom of page.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@135 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@134 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Has a typo and it's empty anyway.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@133 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
This seems to be the consensus.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@132 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
We should make it clearer later, for now this should
be enough for the CSD 1.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@131 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Split virtio_ring.h out to a separate file.
Required by OASIS (though not a strict requirement
for non-normative definitions like this one).
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@130 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
required by OASIS
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@129 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@128 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@127 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
This was used to demonstrate appending format, it is
no longer useful.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@126 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
So recent Fedora and some other distros have broken t4ht
packages, making makehtml fail. The correct fix is to put a
working t4ht somewhere in your path.
For example, for Fedora one can get an old copy from here:
http://pkgs.fedoraproject.org/repo/pkgs/tetex-tex4ht/tex4ht-1.0.2008_02_28_2058.tar.gz/dc9d78c8ad22acd4b40dfd2cbbe2b8de/tex4ht-1.0.2008_02_28_2058.tar.gz
after unpacking, t4ht is under ./bin/linux/t4ht, put it on path.
tex4ht.env is under texmf/tex4ht/base/unix/tex4ht.env, put it
in $HOME (you can rename it .tex4ht) or under current directory.
Revert the work-around in makehtml, but keep it around
in a comment for people who want to use it.
alternatively, someone might want to implement auto-detection
of the broken t4ht and apply the work-around automatically.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@125 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
It should be generated from virtiohtml.cfg but
this does not seem to work.
For now import a hard-coded one.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@124 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@123 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
tabularx is required.
Things seem to build without underscore but just in case
let's import it too.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@122 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
rewrite legacy pci device layout using tabularx.
it was too wide for verbatim to lay out reasonably.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@121 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@120 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
make it a hyper-link.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@119 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@118 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
manually import introduction from main text.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@117 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Add a comment about an alternative to
\usepackage{underscore}, in case we'll want to
use it in the future.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@116 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@115 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
We use _ widely, make this legal so we don't
need to escape all uses.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@114 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
This is simply virtio-v1.0-wd01-part1-specification.txt
converted by txt2latex.pl
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@113 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
This doesn't work well if _ is redefined, and is easy to avoid.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@112 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
The result compiles and looks kind of OK.
This reverse-engineers our txt format to generate
the initial latex file.
Tables are included in verbatim sections.
Code is included in listing sections.
Math is escaped with $$.
TODO (possibly manually):
- remove extra sections at the beginning of the document
- format tales using tabular or similar environment
- format lists using itemize/enumerate/description
- prevent hyphenation in the middle of identifiers
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@111 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Instead of using the tocloft package, which seems to collide
with OASIS-style TOC headers, patch the report style. More
hacky, less intrusive...
Signed-off-by: Pawel Moll <pawel.moll@arm.com>
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@110 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
... making them black on the way.
Warning! This is a hack and it depends on the hyperref
package version.
Signed-off-by: Pawel Moll <pawel.moll@arm.com>
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@109 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Signed-off-by: Pawel Moll <pawel.moll@arm.com>
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@108 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
can be corrupt from previous runs.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@107 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@106 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
seems to be needed to resolve cross references.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@105 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Fedora seems to ship a broken t4ht. Skip it.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@104 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
I imported latex templates from the CMIS specifications
and changed s/CMIS/VIRTIO/ everywhere.
The result is very close to one produced by exporting from the
ODF we were supplied, with the exception of the TOC formatting,
where section numbers are in blue instead of black, and major
sections don't have dots leading to page numbers.
I'm guessing this isn't very important, someone with more latex
knowledge can try to figure this out.
Generating html doesn't actually work for me.
It doesn't work for me for CMIS either, so
it's probably just an issue with my local latex setup.
I'm not sure we need html output at all.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@103 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Use consistent "number. name" everywhere.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@102 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@101 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
Make horisontal separators be +-----+ everywhere.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@100 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
|
make sure all listings are indented with a leading tab.
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@99 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
|
