[PATCH 00/18] Feedback: conformance clauses and normative statements.

From
Rusty Russell
Date
2014-02-19T06:45:00+00:00
ID
Thread
[PATCH 00/18] Feedback: conformance clauses and normative statements.
Hi all,
We are supposed to have real conformance clauses, which are supposed to refer to the normative requirements of the text.  So I started trying to identify them, and I ended up with quite a large patchset which separates the explanatory from normative sections.  (I haven't done SCSI yet, but I wanted to get this out today).  I will work more on these.  In particular, it labels all the normative requirements but I want to put each in their own sub(subsub) section for clarity and easy reference.  I think the final result is clearer, but I appreciate comments.  	 https://github.com/rustyrussell/virtio-wip  feedback  Thanks, Rusty.  Rusty Russell (18):
Feedback: Bug TAB-553
Feedback: move new device design section to Appendix.
Feedback: use proper list in introduction.
Feedback: add old draft to normative references.
Feedback: hoist the one legacy-related requirement out of legacy
section.
Feedback: move legacy/transitional definitions into terminology.
Feedback: 2.1 Device Status field: Separate description from
normative.
Feedback: add normative marker.
Feedback: split Basic Facilities feature bits and config space into
normative.
Feedback: Normative split in Basic Facilities of a Virtio Device /
Virtqueues
Feedback: Normative split for Basic Facilities of a Virtio Device /
Virtqueues / Message Framing
Feedback: Separate the rest of chapter 2 into normative vs
explanatory.
PCI: Separate explanatory and normative text.
MMIO: Separate normative and descriptive text.
CCW: Separate normative and descriptive sections.
Feedback: net: separate normative and instructional text.
block: separate normative and descriptive text.
Feedback: console & entropy: separate normative and descriptive texts.
commands.tex
4 +  content.tex
1515 ++++++++++++++++++++++++++++++++

----------------------

headerfile.tex
8 +  introduction.tex
47 +-  main.tex
4 +  newdevice.tex
66 +++  6 files changed, 1020 insertions(+), 624 deletions(-)  create mode 100644 headerfile.tex  create mode 100644 newdevice.tex  --  1.8.3.2