feedback: minor wording cleanups

We already mention requirement for natural width
accesses for non device specific configuration.
Don't repeat this in legacy section.

Further, mention virtio pci structure in
preamble to help link sections together.

Cc: Arun Subbarao <asubbarao@lnxw.com>
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>

Conflicts:
	content.tex
PCI: better document driver and device requirements

Feedback:
10) 4.1.3.1.2 Queue Vector Configuration
Some of the information from section 8.4 needs to be moved to
here, for example that the device may have an MSI-X table size
other than 2048.
Otherwise, this reads as though the MSI-X table must always have
2048 entries.

11) Please explicitly describe the device behavior when writing
a vector value beyond the MSI-X table size.

Address these comments.

Cc: Arun Subbarao <asubbarao@lnxw.com>
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
Feedback: TAB-557 Spelling errors, etc.

Reported-by: Patrick Durusau <patrick@durusau.net>
Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
Feedback: TAB-555 Bad sub-sectioning

Reported-by: Patrick Durusau <patrick@durusau.net>
Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
Feedback: Bug TAB-553

Haven't marked them non-normative yet, but it makes sense to put the header
in an appendix.

Reported-by: Patrick Durusau <patrick@durusau.net>
Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
Feedback: move new device design section to Appendix.

It's non-normative.

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
Feedback: use proper list in introduction.

Also avoid extra spacing before footnote markers.

Reported-by: Patrick Durusau <patrick@durusau.net>
Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
Feedback: add old draft to normative references.

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
Feedback: hoist the one legacy-related requirement out of legacy section.

This requirement applies to any system which *did* have legacy drivers.

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
Feedback: move legacy/transitional definitions into terminology.

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
Feedback: 2.1 Device Status field: Separate description from normative.

Start with explanation, progress to normative requirements.

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
Feedback: add normative marker.

From http://docs.oasis-open.org/templates/TCHandbook/ConformanceGuidelines.html:
   Normative statements MUST be referenceable so that a statement may be
   referenced from another part of a specification, but more importantly
   so they can be referenced from Conformance Clauses.

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
Feedback: split Basic Facilities feature bits and config space into normative.

Split text into descriptive and normative.

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
Feedback: Normative split in Basic Facilities of a Virtio Device / Virtqueues

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
Feedback: Normative split for Basic Facilities of a Virtio Device / Virtqueues / Message Framing

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
Feedback: Separate the rest of chapter 2 into normative vs explanatory.

The big change here is in introducing new subsections for interrupt and notification
suppression, and moving all requirements into them.

The example processing loop is also moved into a note, to show clearly
that it's not normative.

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
PCI: Separate explanatory and normative text.

Rather than treat selectors 0 and 1 as special, the wording for features
is made more general (though still the same effect).

I split the interrupt handler into a separate subsection: it was
misleading because it didn't handle configuration interrupts until
the next section.  It's also non-normative.

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
MMIO: Separate normative and descriptive text.

The section on initialization is now non-normative.

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
CCW: Separate normative and descriptive sections.

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>
Feedback: net: separate normative and instructional text.

Signed-off-by: Rusty Russell <rusty@au1.ibm.com>