Red Hat Bugzilla – Bug 118823
man page for Xnest is not verbose enough
Last modified: 2007-11-30 17:10:38 EST
Description of problem:
I banged my head against an access control problem for the Xnest
display. ie I would create the Xnest display with "Xnest :1 &" and
then try "xterm -display :1" and would have access refused.
The man page for Xnest is no help at all.
I did NOT RTFM for Xserver as it suggested (I read the Xnest man page
too quickly). I only found the suggested fix:
"Xnest :1 -ac" on a Debian help group.
When I did Xnest -h the -ac option disappeared off the top of the
screen.... and doing SHIFT-UP does not get me the offscreen stuff
because I use the GNU-screen terminal multiplexer... (sic!)
I finally RTFMed the Xnest man page that suggested RTFMing the Xserver
man page where finally I saw that the -ac and a myriad of other
options are listed....
I would suggest just copy/pasting the Xserver details into the Xnest
man page. It might take 10K more disk space AT MOST.
Version-Release number of selected component (if applicable):
Fedora Core 1
Steps to Reproduce:
Documentation requests of this nature should always be made to the
upstream project. I wont make a change like this in Red Hat
1) It creates duplication of documentation, which must then be kept
in sync every time the documentation is updated, which is largely
prone to human error.
2) It is the type of change that should be done upstream, rather
than by Red Hat or other distributions, so that it is in one
place. Upstream is unlikely to accept such a request for change
due to my point #1 above.
3) Because upstream is unlikely to accept such a change, if I were
to add the change locally in Red Hat packaging, it would increase
the amount of package maintenance overhead as Red Hat would have
to then maintain the modified documentation indefinitely, and
track all changes made to the documentation upstream and merge
the changes in multiple locations in our forked documentation.
4) There is no real major benefit to this change. The documentation
does refer to other documentation which contains the proper
up to date information.
Closing request for enhancement as 'WONTFIX', however feel free to
request these changes upstream at: http://bugs.freedesktop.org
if you would like to get an upstream opinion as well.
Thanks in advance.