Bug 484482

Summary:	x11-misc/x2x-1.27-r3 should document the -keymap option
Product:	Gentoo Linux	Reporter:	Henrik Grubbström <grubba>
Component:	Current packages	Assignee:	Philipp Rösner <rndxelement>
Status:	RESOLVED FIXED
Severity:	normal	CC:	jstein, proxy-maint
Priority:	Normal	Keywords:	PullRequest
Version:	unspecified
Hardware:	All
OS:	Linux
See Also:	https://bugs.gentoo.org/show_bug.cgi?id=126939 https://github.com/gentoo/gentoo/pull/23819
Whiteboard:
Package list:		Runtime testing required:	---

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(+)