Xen devel - Dec 2011 - [PATCH] docs: Say in xm(1) that xm is obsolete

Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>

diff -r 3b409f65abae docs/man/xm.pod.1
--- a/docs/man/xm.pod.1	Thu Dec 01 17:26:48 2011 +0000
+++ b/docs/man/xm.pod.1	Thu Dec 01 18:01:35 2011 +0000
@@ -1,6 +1,6 @@
 =head1 NAME
 
-xm - Xen management user interface
+xm - Obsolete xen management user interface
 
 =head1 SYNOPSIS
 
@@ -8,10 +8,14 @@ B<xm> I<subcommand> [I<args>]
 
 =head1 DESCRIPTION
 
-The B<xm> program is the main interface for managing Xen guest
-domains. The program can be used to create, pause, and shutdown
-domains. It can also be used to list current domains, enable or pin
-VCPUs, and attach or detach virtual block devices.
+This program is now superseded by B<xl>, which should be largely
+backwards-compatible with B<sm>.
+
+The B<xm> program is the main interface for managing Xen guest domains
+when the obsolete Xend toolstack is in use. The program can be used to
+create, pause, and shutdown domains. It can also be used to list
+current domains, enable or pin VCPUs, and attach or detach virtual
+block devices.
 
 The basic structure of every B<xm> command is almost always:

On Thu, 2011-12-01 at 18:01 +0000, Ian Jackson wrote:
> Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
> 
> diff -r 3b409f65abae docs/man/xm.pod.1
> --- a/docs/man/xm.pod.1	Thu Dec 01 17:26:48 2011 +0000
> +++ b/docs/man/xm.pod.1	Thu Dec 01 18:01:35 2011 +0000
> @@ -1,6 +1,6 @@
>  =head1 NAME
>  
> -xm - Xen management user interface
> +xm - Obsolete xen management user interface
>  
>  =head1 SYNOPSIS
>  
> @@ -8,10 +8,14 @@ B<xm> I<subcommand> [I<args>]
>  
>  =head1 DESCRIPTION
>  
> -The B<xm> program is the main interface for managing Xen guest
> -domains. The program can be used to create, pause, and shutdown
> -domains. It can also be used to list current domains, enable or pin
> -VCPUs, and attach or detach virtual block devices.
> +This program is now superseded by B<xl>, which should be largely
> +backwards-compatible with B<sm>.
Typo                           ^

o/w Acked-by: Ian Campbell <ian.campbell@citrix.com>
> +
> +The B<xm> program is the main interface for managing Xen guest
domains
> +when the obsolete Xend toolstack is in use. The program can be used to
> +create, pause, and shutdown domains. It can also be used to list
> +current domains, enable or pin VCPUs, and attach or detach virtual
> +block devices.
>  
>  The basic structure of every B<xm> command is almost always:
>  
> 
> _______________________________________________
> Xen-devel mailing list
> Xen-devel@lists.xensource.com
> http://lists.xensource.com/xen-devel

Ian Campbell writes ("Re: [Xen-devel] [PATCH] docs: Say in xm(1) that xm is
obsolete"):
> On Thu, 2011-12-01 at 18:01 +0000, Ian Jackson wrote:
> > +backwards-compatible with B<sm>.
> 
> Typo                           ^
> 
> o/w Acked-by: Ian Campbell <ian.campbell@citrix.com>
Thanks, fixed and applied.

Ian.

On Thu, 2011-12-01 at 18:01 +0000, Ian Jackson wrote:
> Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
> 
> diff -r 3b409f65abae docs/man/xm.pod.1
> --- a/docs/man/xm.pod.1	Thu Dec 01 17:26:48 2011 +0000
> +++ b/docs/man/xm.pod.1	Thu Dec 01 18:01:35 2011 +0000
> @@ -1,6 +1,6 @@
>  =head1 NAME
>  
> -xm - Xen management user interface
> +xm - Obsolete xen management user interface
>  
>  =head1 SYNOPSIS
>  
> @@ -8,10 +8,14 @@ B<xm> I<subcommand> [I<args>]
>  
>  =head1 DESCRIPTION
>  
> -The B<xm> program is the main interface for managing Xen guest
> -domains. The program can be used to create, pause, and shutdown
> -domains. It can also be used to list current domains, enable or pin
> -VCPUs, and attach or detach virtual block devices.
> +This program is now superseded by B<xl>, which should be largely
> +backwards-compatible with B<sm>.
We should remember to make this part of our 4.2 release notes as well.

Ian.
> +
> +The B<xm> program is the main interface for managing Xen guest
domains
> +when the obsolete Xend toolstack is in use. The program can be used to
> +create, pause, and shutdown domains. It can also be used to list
> +current domains, enable or pin VCPUs, and attach or detach virtual
> +block devices.
>  
>  The basic structure of every B<xm> command is almost always:
>  
> 
> _______________________________________________
> Xen-devel mailing list
> Xen-devel@lists.xensource.com
> http://lists.xensource.com/xen-devel