Debian Bug report logs - #582650
xserver-xephyr: [man] Incomplete manual page, missing lot of options

Toggle useless messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Jari Aalto <jari.aalto@cante.net>

To: Debian Bug Tracking System <submit@bugs.debian.org>

Subject: xserver-xephyr: [man] Incomplete manual page, missing lot of options

Date: Sat, 22 May 2010 17:04:58 +0300

Package: xserver-xephyr
Version: 2:1.7.7-1
Severity: normal


Manual page reads:

   OPTIONS
       -screen widthxheight
               sets the screen size.

       -parent id

               uses exiting window id .  If a -screen argument follows
               a -parent argument, this screen is embedded into the
               given window.

       -host-cursor

               set 'cursor acceleration': The host's cursor is
               reused. This is only really there to aid debugging by
               avoiding server paints for the cursor. Performance
               improvement is negligible.

There are many more options. Please bring manual page up to date. Or
if some of these are already referred elsewhere in the documentation,
mention it in the manpage.

    $ Xephyr -h
    nrecognized option: -h
    use: X [:<display>] [option]
    -a #                   default pointer acceleration (factor)
    -ac                    disable access control restrictions
    -audit int             set audit trail level
    -auth file             select authorization file
    -br                    create root window with black background
    +bs                    enable any backing store support
    -bs                    disable any backing store support
    -c                     turns off key-click
    c #                    key-click volume (0-100)
    -cc int                default color visual class
    -nocursor              disable the cursor
    -core                  generate core dump on fatal error
    -dpi int               screen resolution in dots per inch
    -dpms                  disables VESA DPMS monitor control
    -deferglyphs [none|all|16] defer loading of [no|all|16-bit] glyphs
    -f #                   bell base (0-100)
    -fc string             cursor font
    -fn string             default font name
    -fp string             default font path
    -help                  prints message with these options
    -I                     ignore all remaining arguments
    -ld int                limit data space to N Kb
    -lf int                limit number of open files to N
    -ls int                limit stack space to N Kb
    -logo                  enable logo in screen saver
    nologo                 disable logo in screen saver
    -nolisten string       don't listen on protocol
    -noreset               don't reset after last client exists
    -reset                 reset after last client exists
    -p #                   screen-saver pattern duration (minutes)
    -pn                    accept failure to listen on all ports
    -nopn                  reject failure to listen on all ports
    -r                     turns off auto-repeat
    r                      turns on auto-repeat 
    -render [default|mono|gray|color] set render color alloc policy
    -retro                 start with classic stipple and cursor
    -s #                   screen-saver timeout (minutes)
    -t #                   default pointer threshold (pixels/t)
    -terminate             terminate at server reset
    -to #                  connection time out
    -tst                   disable testing extensions
    ttyxx                  server started from init on /dev/ttyxx
    v                      video blanking for screen-saver
    -v                     screen-saver without video blanking
    -wm                    WhenMapped default backing-store
    -wr                    create root window with white background
    -maxbigreqsize         set maximal bigrequest size 
    +xinerama              Enable XINERAMA extension
    -xinerama              Disable XINERAMA extension
    -dumbSched             Disable smart scheduling, enable old behavior
    -schedInterval int     Set scheduler interval in msec
    +extension name        Enable extension
    -extension name        Disable extension
    -query host-name       contact named host for XDMCP
    -broadcast             broadcast for XDMCP
    -multicast [addr [hops]] IPv6 multicast for XDMCP
    -indirect host-name    contact named host for indirect XDMCP
    -port port-num         UDP port number to send messages to
    -from local-address    specify the local address to connect from
    -once                  Terminate server after one session
    -class display-class   specify display class to send in manage
    -cookie xdm-auth-bits  specify the magic cookie for XDMCP
    -displayID display-id  manufacturer display ID for request
    [+-]accessx [ timeout [ timeout_mask [ feedback [ options_mask] ] ] ]
			   enable/disable accessx key sequences
    -ardelay               set XKB autorepeat delay
    -arinterval            set XKB autorepeat interval

    TinyX Device Dependent Usage:
    -screen WIDTH[/WIDTHMM]xHEIGHT[/HEIGHTMM][@ROTATION][X][Y][xDEPTH/BPP{,DEPTH/BPP}[xFREQ]]  Specify screen characteristics
    -rgba rgb/bgr/vrgb/vbgr/none   Specify subpixel ordering for LCD panels
    -mouse driver [,n,,options]    Specify the pointer driver and its options (n is the number of buttons)
    -keybd driver [,,options]      Specify the keyboard driver and its options
    -zaphod          Disable cursor scre


-- System Information:
Debian Release: squeeze/sid
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.32-3-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_DK.UTF-8, LC_CTYPE=en_DK.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages xserver-xephyr depends on:
ii  libaudit0                    1.7.13-1+b1 Dynamic library for security audit
ii  libc6                        2.10.2-6    Embedded GNU C Library: Shared lib
ii  libdrm2                      2.4.18-5    Userspace interface to kernel DRM 
ii  libgcrypt11                  1.4.5-2     LGPL Crypto library - runtime libr
ii  libgl1-mesa-glx [libgl1]     7.7.1-1     A free implementation of the OpenG
ii  libpixman-1-0                0.16.4-1    pixel-manipulation library for X a
ii  libselinux1                  2.0.94-1    SELinux runtime shared libraries
ii  libudev0                     153-2       libudev shared library
ii  libx11-6                     2:1.3.3-3   X11 client-side library
ii  libxau6                      1:1.0.5-2   X11 authorisation library
ii  libxdmcp6                    1:1.0.3-2   X11 Display Manager Control Protoc
ii  libxext6                     2:1.1.1-3   X11 miscellaneous extension librar
ii  libxfont1                    1:1.4.1-2   X11 font rasterisation library
ii  libxv1                       2:1.0.5-1   X11 Video extension library
ii  xserver-common               2:1.7.7-1   common files used by various X ser

Versions of packages xserver-xephyr recommends:
ii  libgl1-mesa-dri               7.7.1-1    A free implementation of the OpenG
ii  xbase-clients                 1:7.5+6    miscellaneous X clients - metapack

xserver-xephyr suggests no packages.

-- no debconf information

Message #10 received at 582650-done@bugs.debian.org (full text, mbox, reply):

From: Julien Cristau <jcristau@debian.org>

To: Jari Aalto <jari.aalto@cante.net>, 582650-done@bugs.debian.org

Subject: Re: Bug#582650: xserver-xephyr: [man] Incomplete manual page, missing lot of options

Date: Sat, 22 May 2010 16:16:54 +0200

[Message part 1 (text/plain, inline)]

On Sat, May 22, 2010 at 17:04:58 +0300, Jari Aalto wrote:

> There are many more options. Please bring manual page up to date. Or
> if some of these are already referred elsewhere in the documentation,
> mention it in the manpage.
> 
SEE ALSO
       X(7), Xserver(1)

Cheers,
Julien

[signature.asc (application/pgp-signature, inline)]

Message #15 received at 582650@bugs.debian.org (full text, mbox, reply):

From: Jari Aalto <jari.aalto@cante.net>

To: control@bugs.debian.org, 582650@bugs.debian.org

Subject: Bug#582650 reopen

Date: Sat, 22 May 2010 17:41:11 +0300

[Message part 1 (text/plain, inline)]

reopen 582650
owner 582650 !
thanks

>  There are many more options. Please bring manual page up to date. Or
> > if some of these are already referred elsewhere in the documentation,
> > mention it in the manpage.
> >
> SEE ALSO
>        X(7), Xserver(1)

The "see also" section is used to refer to related software. It is not
customary to treated as and extension of "OPTIONS".

The manual would better explicitly say that Xephyr supports all the
options of X(7) and Xserver(1) if this is the case. Please find the
attached patch below.

Jari

[0001-Xephyr.1-OPTIONS-Mention-that-standard-options-are-a.patch (text/x-diff, inline)]

From 9effb1ca9b7b9d0147aa5c01861fd42106a0db52 Mon Sep 17 00:00:00 2001
From: Jari Aalto <jari.aalto@cante.net>
Date: Sat, 22 May 2010 17:40:43 +0300
Subject: [PATCH] Xephyr.1: (OPTIONS): Mention that standard options are accepted
Organization: Private
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit


Signed-off-by: Jari Aalto <jari.aalto@cante.net>
---
 Xephyr.1 |    2 ++
 1 files changed, 2 insertions(+), 0 deletions(-)

diff --git a/Xephyr.1 b/Xephyr.1
index 88c98ed..a612135 100644
--- a/Xephyr.1
+++ b/Xephyr.1
@@ -39,6 +39,8 @@ uses the host X server window as "framebuffer" via fast SHM XImages.
 It also has support for "visually" debugging what the server is
 painting.
 .SH OPTIONS
+The server accepts all the standard options of X(7), Xserver(1) and the
+following additional options:
 .TP 8
 .BI -screen " width" x height
 sets the screen size.
-- 
1.7.0

Message #24 received at 582650@bugs.debian.org (full text, mbox, reply):

From: Julien Cristau <jcristau@debian.org>

To: Jari Aalto <jari.aalto@cante.net>, 582650@bugs.debian.org

Subject: Re: Bug#582650: reopen

Date: Sun, 6 Jun 2010 20:01:07 +0200

[Message part 1 (text/plain, inline)]

On Sat, May 22, 2010 at 17:41:11 +0300, Jari Aalto wrote:

> The manual would better explicitly say that Xephyr supports all the
> options of X(7) and Xserver(1) if this is the case. Please find the
> attached patch below.
> 
X(7) doesn't talk about standard options, Xserver(1) does, so it's
probably enough to mention that.

Please provide a patch that applies to
git://anongit.freedesktop.org/xorg/xserver and send it to
xorg-devel@lists.x.org, according to
http://wiki.x.org/wiki/Development/Documentation/SubmittingPatches

Note that the section for the Xserver man page should be
__appmansuffix__ in the source file (hw/kdrive/ephyr/Xephyr.man.pre),
it's replaced at build time.

Thanks,
Julien

[signature.asc (application/pgp-signature, inline)]

Message #33 received at 582650@bugs.debian.org (full text, mbox, reply):

From: Jari Aalto <jari.aalto@cante.net>

To: Julien Cristau <jcristau@debian.org>

Cc: 582650@bugs.debian.org, xorg-devel@lists.x.org

Subject: [PATCH] Xephyr.man.pre: In OPTIONS mention that Xserver(1) are also accepted

Date: Mon, 07 Jun 2010 11:37:59 +0300

Signed-off-by: Jari Aalto <jari.aalto@cante.net>
---
 hw/kdrive/ephyr/Xephyr.man.pre |    2 ++
 1 files changed, 2 insertions(+), 0 deletions(-)


    Cf. http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=582650


    Julien Cristau <jcristau@debian.org> writes:

    > On Sat, May 22, 2010 at 17:41:11 +0300, Jari Aalto wrote:
    >
    >> The manual would better explicitly say that Xephyr supports all the
    >> options of X(7) and Xserver(1) if this is the case. Please find the
    >> attached patch below.
    >> 
    > X(7) doesn't talk about standard options, Xserver(1) does, so it's
    > probably enough to mention that.
    >
    > Please provide a patch that applies to
    > git://anongit.freedesktop.org/xorg/xserver and send it to
    > xorg-devel@lists.x.org, according to
    > http://wiki.x.org/wiki/Development/Documentation/SubmittingPatches
    >
    > Note that the section for the Xserver man page should be
    > __appmansuffix__ in the source file (hw/kdrive/ephyr/Xephyr.man.pre),
    > it's replaced at build time.

    Below. Thanks,
    Jari

diff --git a/hw/kdrive/ephyr/Xephyr.man.pre b/hw/kdrive/ephyr/Xephyr.man.pre
index eb80b96..3aece2a 100644
--- a/hw/kdrive/ephyr/Xephyr.man.pre
+++ b/hw/kdrive/ephyr/Xephyr.man.pre
@@ -39,6 +39,8 @@ uses the host X server window as "framebuffer" via fast SHM XImages.
 It also has support for "visually" debugging what the server is
 painting.
 .SH OPTIONS
+The server accepts all the standard options of Xserver(__appmansuffix__)
+and the following additional options:
 .TP 8
 .BI -screen " width" x height
 sets the screen size.
-- 
1.7.1

Message #38 received at 582650@bugs.debian.org (full text, mbox, reply):

From: Alan Coopersmith <alan.coopersmith@oracle.com>

To: Jari Aalto <jari.aalto@cante.net>

Cc: Julien Cristau <jcristau@debian.org>, xorg-devel@lists.x.org, 582650@bugs.debian.org

Subject: Re: [PATCH] Xephyr.man.pre: In OPTIONS mention that Xserver(1) are also accepted

Date: Mon, 07 Jun 2010 07:17:45 -0700

Jari Aalto wrote:
> diff --git a/hw/kdrive/ephyr/Xephyr.man.pre b/hw/kdrive/ephyr/Xephyr.man.pre
> index eb80b96..3aece2a 100644
> --- a/hw/kdrive/ephyr/Xephyr.man.pre
> +++ b/hw/kdrive/ephyr/Xephyr.man.pre
> @@ -39,6 +39,8 @@ uses the host X server window as "framebuffer" via fast SHM XImages.
>  It also has support for "visually" debugging what the server is
>  painting.
>  .SH OPTIONS
> +The server accepts all the standard options of Xserver(__appmansuffix__)
> +and the following additional options:
>  .TP 8
>  .BI -screen " width" x height
>  sets the screen size.

Thanks for the patch.
Reviewed-by: Alan Coopersmith <alan.coopersmith@oracle.com>

-- 
	-Alan Coopersmith-        alan.coopersmith@oracle.com
	 Oracle Solaris Platform Engineering: X Window System

Message #43 received at 582650@bugs.debian.org (full text, mbox, reply):

From: Cyril Brulebois <kibi@debian.org>

To: xorg-devel@lists.x.org

Cc: alan.coopersmith@oracle.com, 582650@bugs.debian.org, Cyril Brulebois <kibi@debian.org>, Jari Aalto <jari.aalto@cante.net>

Subject: [PATCH] Xephyr: Mention Xserver's options are also accepted.

Date: Mon, 28 Feb 2011 00:26:41 +0100

Originally reported in the Debian BTS:
  http://bugs.debian.org/582650

Signed-off-by: Jari Aalto <jari.aalto@cante.net>
Signed-off-by: Cyril Brulebois <kibi@debian.org>
---
 hw/kdrive/ephyr/man/Xephyr.man |    2 ++
 1 files changed, 2 insertions(+), 0 deletions(-)

Apparently already rb'd by Alan, but probably forgotten at some point:
  http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=582650#38

Sending again, refreshed against master.

diff --git a/hw/kdrive/ephyr/man/Xephyr.man b/hw/kdrive/ephyr/man/Xephyr.man
index 8e7bfd5..12c9f58 100644
--- a/hw/kdrive/ephyr/man/Xephyr.man
+++ b/hw/kdrive/ephyr/man/Xephyr.man
@@ -39,6 +39,8 @@ uses the host X server window as "framebuffer" via fast SHM XImages.
 It also has support for "visually" debugging what the server is
 painting.
 .SH OPTIONS
+The server accepts all the standard options of Xserver(__appmansuffix__)
+and the following additional options:
 .TP 8
 .BI -screen " width" x height
 sets the screen size.
-- 
1.7.4.1

Message #48 received at 582650@bugs.debian.org (full text, mbox, reply):

From: Peter Hutterer <peter.hutterer@who-t.net>

To: Cyril Brulebois <kibi@debian.org>

Cc: xorg-devel@lists.x.org, Jari Aalto <jari.aalto@cante.net>, 582650@bugs.debian.org

Subject: Re: [PATCH] Xephyr: Mention Xserver's options are also accepted.

Date: Mon, 28 Feb 2011 09:52:16 +1000

On Mon, Feb 28, 2011 at 12:26:41AM +0100, Cyril Brulebois wrote:
> Originally reported in the Debian BTS:
>   http://bugs.debian.org/582650
> 
> Signed-off-by: Jari Aalto <jari.aalto@cante.net>
> Signed-off-by: Cyril Brulebois <kibi@debian.org>
> ---
>  hw/kdrive/ephyr/man/Xephyr.man |    2 ++
>  1 files changed, 2 insertions(+), 0 deletions(-)
> 
> Apparently already rb'd by Alan, but probably forgotten at some point:
>   http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=582650#38
> 
> Sending again, refreshed against master.
> 
> diff --git a/hw/kdrive/ephyr/man/Xephyr.man b/hw/kdrive/ephyr/man/Xephyr.man
> index 8e7bfd5..12c9f58 100644
> --- a/hw/kdrive/ephyr/man/Xephyr.man
> +++ b/hw/kdrive/ephyr/man/Xephyr.man
> @@ -39,6 +39,8 @@ uses the host X server window as "framebuffer" via fast SHM XImages.
>  It also has support for "visually" debugging what the server is
>  painting.
>  .SH OPTIONS
> +The server accepts all the standard options of Xserver(__appmansuffix__)
> +and the following additional options:
>  .TP 8
>  .BI -screen " width" x height
>  sets the screen size.
> -- 
> 1.7.4.1

Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net>

 
Cheers,
  Peter

Message #53 received at 582650-done@bugs.debian.org (full text, mbox, reply):

From: Julien Cristau <jcristau@debian.org>

To: Jari Aalto <jari.aalto@cante.net>, 582650-done@bugs.debian.org

Subject: Re: Bug#582650: xserver-xephyr: [man] Incomplete manual page, missing lot of options

Date: Sun, 30 Sep 2012 12:26:36 +0200

[Message part 1 (text/plain, inline)]

Version: 2:1.11.0-1

On Sat, May 22, 2010 at 17:04:58 +0300, Jari Aalto wrote:

> Package: xserver-xephyr
> Version: 2:1.7.7-1
> Severity: normal
> 
> 
> Manual page reads:
> 
>    OPTIONS
>        -screen widthxheight
>                sets the screen size.
> 
>        -parent id
> 
>                uses exiting window id .  If a -screen argument follows
>                a -parent argument, this screen is embedded into the
>                given window.
> 
>        -host-cursor
> 
>                set 'cursor acceleration': The host's cursor is
>                reused. This is only really there to aid debugging by
>                avoiding server paints for the cursor. Performance
>                improvement is negligible.
> 
> There are many more options. Please bring manual page up to date. Or
> if some of these are already referred elsewhere in the documentation,
> mention it in the manpage.
> 
The manpage was changed upstream in 1.11 rc2, closing.

Cheers,
Julien

[signature.asc (application/pgp-signature, inline)]

Send a report that this bug log contains spam.