Re: [Xen-devel] [PATCH 2 of 4 v3] blkif.h: Provide more complete documentation of the blkif interface

[Ian Campbell <Ian.Campbell@xxxxxxxxxx>]

On Tue, 2012-02-21 at 21:36 +0000, Konrad Rzeszutek Wilk wrote:
[...]
> > With that in mind, I believe that all of the required information
> > about discard is still present in blkif.h, but perhaps presented
> > differently or moved to different sections.  Can you be more
> > specific about the information that you feel is missing here and
> > in the other places you noted below?
> 
> The original statement about how the backend would determine how
> to expose this information.

Please can you quote the actual text of the statements which you think
are missing and/or should be retained so we know precisely what you are
talking about.

> > The comment block here mirrors the language of all the other feature
> > flags.  Do you believe they should be changed in some way too?
> 
> Well, the desire (mine) is to include as much details (or even more) in the
> spec so that it can be read as a novel if desired.
> 
> But I will defer to Ian - if he is OK then this shouldn't gate
> the acceptance of this patch which is a step forward.

Perhaps details which aren't part of the formal spec, e.g.
implementation tips, details of various OSes implementation choices etc
could be kept elsewhere, e.g. on the wiki?

The problem with including these sorts of things in the spec is that you
then have to get all pedantic about which statements are normative and
which are just quirks or details of a particular valid implementation of
the spec etc.

Ian.


_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxx
http://lists.xen.org/xen-devel