WARNING - OLD ARCHIVES

This is an archived copy of the Xen.org mailing list, which we have preserved to ensure that existing links to archives are not broken. The live archive, which contains the latest emails, can be found at http://lists.xen.org/
   
 
 
Xen 
 
Home Products Support Community News
 
   
 

xen-devel

Re: [Xen-devel] [PATCH] xl: Special case tap/aio for disk validation

Ian Campbell writes ("Re: [Xen-devel] [PATCH] xl: Special case tap/aio for disk 
validation"):
> I'm not sure if the canonical place for this sort of thing should be the
> wiki (where it is simple for anyone to update, but where it might get
> out of date or suffer from version skew etc) or in-tree (where we can
> patch as part of the implementation of new features).

There should be primary reference documentation, of every syntax,
public interface, and feature, in-tree.  This should be in plain text
files or perhaps manpages or something equally easy to edit and view.

That way we can require people who add new features to update the
documentation, and users will have the documentation which corresponds
to the code that they have.

> I'd be inclined to suggest we take that wiki page, text-ify it, sanity
> check for updatedness, stick it in the tree and update the wiki to
> reference it. Opinions?

That would be a good start.  NB that there's also the xm-config.5
manpage.  All of this needs to be unified.

Ian.

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxx
http://lists.xensource.com/xen-devel

<Prev in Thread] Current Thread [Next in Thread>