Xen devel - Oct 2005 - [PATCH] Add Initial Man Pages for xm and xmdomain.cfg

Here''s a first stab at man pages for xm and xmdomain.cfg. Sean
submitted
this patch over the summer. I''ve just added a xm man page to it. Both
man pages are rough and need more work. 

Sean''s original post:

http://lists.xensource.com/archives/html/xen-devel/2005-08/txtOQiiLcE26t.txt

Thanks,

Dan


Signed-off-by: Sean Dague <sean@dague.net>
Signed-off-by: Daniel Stekloff <dsteklof@us.ibm.com>




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

It''s good to see man pages appearing for other tools!

I''d still suggest considering a script for generating the command help 
though: e.g. have a "skeleton" man page but use a script (maybe just a
shell script) to allow quick regeneration of the command descriptions (by 
just running xm help over everything and formatting the results).

We can still check a pre-generated manpage into hg and ship it readymade; 
it''s just that relying on developers to update the documentation tends
not
to work ;-)

Cheers,
Mark

On Oct 29 2005, Daniel Stekloff wrote:
>
>Here''s a first stab at man pages for xm and xmdomain.cfg. Sean
submitted
>this patch over the summer. I''ve just added a xm man page to it.
Both
>man pages are rough and need more work. 
>
>Sean''s original post:
>
>  
>
http://lists.xensource.com/archives/html/xen-devel/2005-08/txtOQiiLcE26t.txt
>
>Thanks,
>
>Dan
>
>
>Signed-off-by: Sean Dague <sean@dague.net>
>Signed-off-by: Daniel Stekloff <dsteklof@us.ibm.com>
>
>
>
_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xensource.com
http://lists.xensource.com/xen-devel

On Sat, Oct 29, 2005 at 05:29:43PM +0100, M.A. Williamson
wrote:
> It''s good to see man pages appearing for other tools!
> 
> I''d still suggest considering a script for generating the command
help
> though: e.g. have a "skeleton" man page but use a script (maybe
just a
> shell script) to allow quick regeneration of the command descriptions (by 
> just running xm help over everything and formatting the results).
> 
> We can still check a pre-generated manpage into hg and ship it readymade; 
> it''s just that relying on developers to update the documentation
tends not
> to work ;-)
I still disagree. :)

If we get this man page stub into the Xen tree, I''ll start working on
it
again.  My lack of motivation for this has been not having it there.  This
is something easy to do in 10-20 minute bites between (or during) meetings.
;)

	-Sean

-- 
__________________________________________________________________

Sean Dague                                       Mid-Hudson Valley
sean at dague dot net                            Linux Users Group
http://dague.net                                 http://mhvlug.org

There is no silver bullet.  Plus, werewolves make better neighbors
than zombies, and they tend to keep the vampire population down.
__________________________________________________________________


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

>> We can still check a pre-generated manpage into hg and ship it 
>> readymade; it''s just that relying on developers to update the 
>> documentation tends not to work ;-)
>
>I still disagree. :)
>
>If we get this man page stub into the Xen tree, I''ll start working
on it
>again.  My lack of motivation for this has been not having it there.  This
>is something easy to do in 10-20 minute bites between (or during) meetings.
>;)
OK, if someone can maintain the docs without going insane, that''s also
an
acceptable solution ;-) As a general rule and for the sake of your sanity I 
think we should make "doesn''t break the documentation" a
patch-acceptance
criterion :-)

Cheers,
Mark

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

Hi,

 I''m trying to booy Xen3.0 with Fedora core 4. I treid
different things as per dev-list archive +
FedoraXenQuickstart tutorial etc.

The error message I get is 
 
  
 
   Root-NFS: No NFS server available
   VFS: Unable to mount root fs via NFS, trying floppy
   VFS: Insert root floppy and press ENTER
 
I''m using Fedora Core 4 on a Pentium III machine

My menu.lst file is 

default=0
timeout=5
splashimage=(hd0,0)/grub/splash.xpm.gz
hiddenmenu
title Xen 3.0 / XenLinux 2.6
        root(hd0,0)
        kernel /xen-3.0.gz dom0_mem=131072
        module /vmlinuz-2.6-xen0 ro
root=/dev/VolGroup00/LogVol00  console=tty0
       

title Fedora Core (2.6.11-1.1369_FC4)
        root (hd0,0)
        kernel /vmlinuz-2.6.11-1.1369_FC4 ro
root=/dev/VolGroup00/LogVol00 rhgb quiet
        initrd /initrd-2.6.11-1.1369_FC4.img

If I add initrd line
        title Xen 3.0 / XenLinux 2.6
        root(hd0,0)
        kernel /xen-3.0.gz dom0_mem=131072
        module /vmlinuz-2.6-xen0 ro
root=/dev/VolGroup00/LogVol00  console=tty0
        initrd /initrd-2.6-xen0.img

It doesn''t even start booting, it says "kernel has to
be loaded before initrd"

What am I doing wrong?








	
		
__________________________________ 
Yahoo! Mail - PC Magazine Editors'' Choice 2005 
http://mail.yahoo.com

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

On Sat, 2005-10-29 at 20:13 +0100, M.A. Williamson
wrote:
> >> We can still check a pre-generated manpage into hg and ship it 
> >> readymade; it''s just that relying on developers to update
the
> >> documentation tends not to work ;-)
> >
> >I still disagree. :)
> >
> >If we get this man page stub into the Xen tree, I''ll start
working on it
> >again.  My lack of motivation for this has been not having it there. 
This
> >is something easy to do in 10-20 minute bites between (or during)
meetings.
> >;)
> 
> OK, if someone can maintain the docs without going insane, that''s
also an
> acceptable solution ;-) As a general rule and for the sake of your sanity I
> think we should make "doesn''t break the documentation" a
patch-acceptance
> criterion :-)

Does the patch break the documentation build? I applied it to a clean
tree and made that tree to test it. I didn''t see any errors and the
docs
seemed to be made ok. I''m sorry if it broke documentation. Please let
me
know if I need to fix something.

Sorry,

Dan


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

> Does the patch break the documentation build?
No!  I wasn''t criticising your patch; I think it''s great to
have more man
pages in there.

I just meant that developers in general have a very strong tendancy to come 
along and break manpages (and other docs) by changing what the code actually 
does...  A "don''t make the docs wrong" policy on patches
would keep us
honest ;-)

Cheers,
Mark
> I applied it to a clean 
> tree and made that tree to test it. I didn''t see any errors and
the docs
> seemed to be made ok. I''m sorry if it broke documentation. Please
let me
> know if I need to fix something.
>
> Sorry,
>
> Dan
_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xensource.com
http://lists.xensource.com/xen-devel