Bug#79381: x11-xserver-utils: bug almost clsoed, just need a little more doc

[Julien Cristau <jcristau@debian.org>]

On Fri, Jul 22, 2011 at 13:00:09 -0400, Erik Saule wrote:

> Package: x11-xserver-utils
> Version: 7.5+3
> Severity: normal
> 
> 
> Dear Debian developpers and maintainers,
> 
> erayo@ said (in 2001) that xhost was working properly on redhat
> systems while logged in as root. It is not the case in squeeze.
> 
> xhost user@host seems to work (which was I believe fix the complaint
> of the first bug reporter).
> 
> The OPTIONS section of the man page is misleading. I quote:
> 
> "[+]name The given name (the plus sign is optional) is added to the
> list allowed to connect to the X server.  The name can be a host name
> or a user name."
> 
> The important part is "The name can be a host name or a user
> name". This statement also appear in the next line of the man page and
> is incorrect since running "xhost foo" is always interpreted as the
> host foo. Actually even "xhost -help" reports this.
> 
> One can use the complete name syntax to provide a username by running
> "xhost si:localuser:foo".
> 
> I suggest changing the man page to reflect this such as:
> 
> "The name can be a host name or a complete name (see NAMES for more
> details)."
> 
> I also believe adding an example of the syntax "xhost +
> si:localuser:foo" or a hint of its existance in the section NAMES
> would be useful. Adding a sentence such as : "The server interpreted
> addresses can also be used to specify a local user using
> si:localuser:login." before the "For more information on the available
> forms of server interpreted addresses, see the Xsecurity(7) manual
> page." would I believe be useful.
> 
Sounds like useful suggestions to me.  Would you be willing to write a
patch against the manpage and send it to xorg-devel@lists.x.org for
review?

Thanks,
Julien