hi,
i''m a real Xen user since version 2.0.7 and i still believe on the
power
and charme from Xen. I used Xen for my costumers, for my own and I''m
proud to tell everybody about Xen, what they can do with the hypervisor
and i''ve written severals German HOWTOs. But, where the sun is, the
shadow isn''t far away: Xen lacks absolutely on actual docs. The
ManPages
are still not updated (many FIXME), not all parameters are listed in
(5), for example
cpu_cap and cpu_weight? How can i define it in a DomU config? (i know
it, now)
another example:
"dom0-min-mem" is listed, but where is "enable-dom0-ballooning
yes" ?
Take a look, what you have with "xm help" and what you get in the
manpage.
At this time, i have to read the sourcecode, to know, what this means.
Xen has so many features, but without good manpages, nobody knows about
them. Also the ("make -C docs") the documentation in the Xen source
code, is more for developers (and still to old too), than for new users.
They better searching with Google for HowTos.
So, why it is so hard to take some time for a good documentation,
instead of developing new features, where nobody knows,that they exists,
if they don''t read the source code or the mailinglists?
cu denny
_______________________________________________
Xen-users mailing list
Xen-users@lists.xensource.com
http://lists.xensource.com/xen-users
Hi Denny, On Fri, 2008-11-21 at 16:57 +0100, Denny Schierz wrote:> hi, > > i''m a real Xen user since version 2.0.7 and i still believe on the power > and charme from Xen. I used Xen for my costumers, for my own and I''m > proud to tell everybody about Xen, what they can do with the hypervisor > and i''ve written severals German HOWTOs. But, where the sun is, the > shadow isn''t far away: Xen lacks absolutely on actual docs. The ManPages > are still not updated (many FIXME), not all parameters are listed in > (5), for exampleThe wiki is also horribly out of date. There are two major obstacles when documenting Xen: 1 - Xen is still a rapidly moving target 2 - Many versions of Xen are still in production use So documentation describing Xenstore, configuration paramaters and other things might have to remain backwards compatible. Some things have to be marked as "Xen 3.3 Only", while others "Xen 3.0 Or Prior". I have been going through the wiki looking for various FIXMEs and addressing them, while preparing some new pages to add (for instance, documenting exported sysfs attributes and statistics). Its funny, because I was just searching for an ''official'' Xen documentation project to join in hopes of combining efforts with others doing the same. I really don''t know if its worth trying to keep the documentation backwards compatible all the way to 3.0 and if not, which version should be the cut off point? 3.0.2 perhaps? Cheers, --Tim _______________________________________________ Xen-users mailing list Xen-users@lists.xensource.com http://lists.xensource.com/xen-users
Denny Schierz wrote:> So, why it is so hard to take some time for a good documentation, > instead of developing new features, where nobody knows,that they exists, > if they don''t read the source code or the mailinglists? > > cu dennyIt''s so easy to criticize... Hey, this is open source man! Instead, why don''t you register to the Xen-devel list, and send a patch against the manpages to them? I''m sure they would accept your documentation contribution!!! Thomas _______________________________________________ Xen-users mailing list Xen-users@lists.xensource.com http://lists.xensource.com/xen-users