Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 484482 - x11-misc/x2x-1.27-r3 should document the -keymap option
Summary: x11-misc/x2x-1.27-r3 should document the -keymap option
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Philipp Rösner
URL:
Whiteboard:
Keywords: PullRequest
Depends on:
Blocks:
 
Reported: 2013-09-10 14:37 UTC by Henrik Grubbström
Modified: 2022-01-16 01:34 UTC (History)
2 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Henrik Grubbström 2013-09-10 14:37:56 UTC
Keysyms may need remapping when accessing different X-server implementations (as noted in bug #126939). This is implemented by the patch there (incorporated in x2x-1.27-r2), which added a new command-line option (-keysym) to x2x. 

Unfortunately the patch did not contain a corresponding update of the documentation. Eg the usage string does not mention the new option:

Usage: x2x [-to <DISPLAY> | -from <DISPLAY>] options...
       -copyright
       -font <FONTNAME>
       -geometry <GEOMETRY>
       -wait
       -big
       -buttonblock
       -nomouse
       -nopointermap
       -north
       -south
       -east
       -west
       -nosel
       -noautoup
       -resurface
       -shadow <DISPLAY>
       -sticky <sticky key>
       -label <LABEL>
       -buttonmap <button#> "<keysym> ..."

I suggest adding

       -keymap <from-keysym> <to-keysym>

somewhere suitable in the above list, as well as adding a corresponding paragraph to the x2x(1) man-page.


Reproducible: Always

Steps to Reproduce:
See above.




FYI: A typical example of how to use the option is

         -keymap ISO_Level3_Shift Mode_switch

     which maps the AltGr on current Xorg to the AltGr on old (eg Sun) X.
Comment 1 Larry the Git Cow gentoo-dev 2022-01-16 01:34:32 UTC
The bug has been closed via the following commit(s):

https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=0bf7b7a0e6a7ec274beadfea9b10a8243f942276

commit 0bf7b7a0e6a7ec274beadfea9b10a8243f942276
Author:     Philipp Rösner <rndxelement@protonmail.com>
AuthorDate: 2022-01-15 23:26:16 +0000
Commit:     Sam James <sam@gentoo.org>
CommitDate: 2022-01-16 01:33:34 +0000

    x11-misc/x2x: added documentation for keymap option
    
    The patch that implemented custom keysym bindings lacked documentation
    in the usage output and in the man page, so we added this accordingly.
    
    Closes: https://bugs.gentoo.org/484482
    Package-Manager: Portage-3.0.30, Repoman-3.0.3
    Signed-off-by: Philipp Roesner <rndxelement@protonmail.com>
    Closes: https://github.com/gentoo/gentoo/pull/23819
    Signed-off-by: Sam James <sam@gentoo.org>

 x11-misc/x2x/files/x2x_1.30-10-keymap.patch | 35 +++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)