Xen devel - Aug 2013 - [PATCH] xen/docs: Correct documentation for the conswitch parameter

Signed-off-by: Andrew Cooper <andrew.cooper3@citrix.com>
CC: Ian Campbell <Ian.Campbell@citrix.com>
CC: Ian Jackson <Ian.Jackson@eu.citrix.com>

---
I was slightly peeved at looking this up and discovering that it was wrong,
but the history shows I have only myself to blame.
---
 docs/misc/xen-command-line.markdown |    5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/misc/xen-command-line.markdown
b/docs/misc/xen-command-line.markdown
index 13c0306..dedc25e 100644
--- a/docs/misc/xen-command-line.markdown
+++ b/docs/misc/xen-command-line.markdown
@@ -281,7 +281,7 @@ Flag to indicate whether all guest console output should be
copied
 into the console ring buffer.
 
 ### conswitch
-> `= <switch char>[,x]`
+> `= <switch char>[x]`
 
 > Default `conswitch=a`
 
@@ -292,7 +292,8 @@ times.
 The optional trailing `x` indicates that Xen should not automatically
 switch the console input to dom0 during boot.  Any other value,
 including omission, causes Xen to automatically switch to the dom0
-console during dom0 boot.
+console during dom0 boot.  Use `conswitch=ax` to keep the default switch
+character, but for xen to keep the console.
 
 ### cpu\_type
 > `= arch_perfmon`
-- 
1.7.10.4

On 28/08/13 11:19, Andrew Cooper wrote:
> Signed-off-by: Andrew Cooper <andrew.cooper3@citrix.com>
> CC: Ian Campbell <Ian.Campbell@citrix.com>
> CC: Ian Jackson <Ian.Jackson@eu.citrix.com>
Ping?  (CC''d x86 maintainers as well, given the lack of guidance as to
who should/can ack/commit changes like this)

~Andrew
>
> ---
> I was slightly peeved at looking this up and discovering that it was wrong,
> but the history shows I have only myself to blame.
> ---
>  docs/misc/xen-command-line.markdown |    5 +++--
>  1 file changed, 3 insertions(+), 2 deletions(-)
>
> diff --git a/docs/misc/xen-command-line.markdown
b/docs/misc/xen-command-line.markdown
> index 13c0306..dedc25e 100644
> --- a/docs/misc/xen-command-line.markdown
> +++ b/docs/misc/xen-command-line.markdown
> @@ -281,7 +281,7 @@ Flag to indicate whether all guest console output
should be copied
>  into the console ring buffer.
>  
>  ### conswitch
> -> `= <switch char>[,x]`
> +> `= <switch char>[x]`
>  
>  > Default `conswitch=a`
>  
> @@ -292,7 +292,8 @@ times.
>  The optional trailing `x` indicates that Xen should not automatically
>  switch the console input to dom0 during boot.  Any other value,
>  including omission, causes Xen to automatically switch to the dom0
> -console during dom0 boot.
> +console during dom0 boot.  Use `conswitch=ax` to keep the default switch
> +character, but for xen to keep the console.
>  
>  ### cpu\_type
>  > `= arch_perfmon`

On Wed, 2013-09-04 at 18:08 +0100, Andrew Cooper wrote:
> On 28/08/13 11:19, Andrew Cooper wrote:
> > Signed-off-by: Andrew Cooper <andrew.cooper3@citrix.com>
> > CC: Ian Campbell <Ian.Campbell@citrix.com>
> > CC: Ian Jackson <Ian.Jackson@eu.citrix.com>
> 
> Ping?
Sorry, was in my backlog. I''ve thrown it in.
> (CC''d x86 maintainers as well, given the lack of guidance as to
> who should/can ack/commit changes like this)
Including the hypervisor guys is a good idea, at least then they can
object or clarify things.
> 
> ~Andrew
> 
> >
> > ---
> > I was slightly peeved at looking this up and discovering that it was
wrong,
> > but the history shows I have only myself to blame.
> > ---
> >  docs/misc/xen-command-line.markdown |    5 +++--
> >  1 file changed, 3 insertions(+), 2 deletions(-)
> >
> > diff --git a/docs/misc/xen-command-line.markdown
b/docs/misc/xen-command-line.markdown
> > index 13c0306..dedc25e 100644
> > --- a/docs/misc/xen-command-line.markdown
> > +++ b/docs/misc/xen-command-line.markdown
> > @@ -281,7 +281,7 @@ Flag to indicate whether all guest console output
should be copied
> >  into the console ring buffer.
> >  
> >  ### conswitch
> > -> `= <switch char>[,x]`
> > +> `= <switch char>[x]`
> >  
> >  > Default `conswitch=a`
> >  
> > @@ -292,7 +292,8 @@ times.
> >  The optional trailing `x` indicates that Xen should not automatically
> >  switch the console input to dom0 during boot.  Any other value,
> >  including omission, causes Xen to automatically switch to the dom0
> > -console during dom0 boot.
> > +console during dom0 boot.  Use `conswitch=ax` to keep the default
switch
> > +character, but for xen to keep the console.
> >  
> >  ### cpu\_type
> >  > `= arch_perfmon`
>