[gtk-vnc] Add comment about where each keymap datasource came from

[Daniel P. Berrange <dberrange src gnome org>]

commit e9ceaf0e409beaf492ee4237df69c946824588a5
Author: Daniel P. Berrange <berrange redhat com>
Date:   Fri Aug 20 17:05:05 2010 +0100

    Add comment about where each keymap datasource came from
    
    To assist in people identifying/resolving mistakes, add a note
    about where each data source from keymaps.csv came from. Most
    are from Linux kernel source data tables, a few were manually
    matched up (Xwin/OS-X)
    
    * src/keymap-gen.pl: Record data sources for keymaps.csv

 src/keymap-gen.pl |   22 ++++++++++++++++++++++
 1 files changed, 22 insertions(+), 0 deletions(-)
---
diff --git a/src/keymap-gen.pl b/src/keymap-gen.pl
index 56aca46..fd96bdf 100644
--- a/src/keymap-gen.pl
+++ b/src/keymap-gen.pl
@@ -16,6 +16,28 @@ my %namecolumns = (
     win32 => 10,
     );
 
+# Base data sources:
+#
+#  linux:     Linux: linux/input.h                                  (master set)
+#    osx:      OS-X: Carbon/HIToolbox/Events.h                      (manually mapped)
+# atset1:  AT Set 1: linux/drivers/input/keyboard/atkbd.c           (atkbd_set2_keycode + atkbd_unxlate_table)
+# atset2:  AT Set 2: linux/drivers/input/keyboard/atkbd.c           (atkbd_set2_keycode)
+# atset3:  AT Set 3: linux/drivers/input/keyboard/atkbd.c           (atkbd_set3_keycode)
+#     xt:        XT: linux/drivers/input/keyboard/xt.c              (xtkbd_keycode)
+#  xtkbd: Linux RAW: linux/drivers/char/keyboard.c                  (x86_keycodes)
+#    usb:   USB HID: linux/drivers/hid/usbhid/usbkbd.c              (usb_kbd_keycode)
+#  win32:     Win32: mingw32/winuser.h                              (manually mapped)
+# xwinxt:   XWin XT: xorg-server/hw/xwin/{winkeybd.c,winkeynames.h} (xt + manually transcribed)
+# xkbdxt:   XKBD XT: xf86-input-keyboard/src/at_scancode.c          (xt + manually transcribed)
+#
+# Derived data sources
+#
+#    xorgevdev: Xorg +  evdev: linux + an offset
+#      xorgkbd: Xorg +    kbd: xkbdxt + an offset
+#  xorgxquartz: Xorg +   OS-X: osx + an offset
+#     xorgxwin: Xorg + Cygwin: xwinxt + an offset
+#          rfb:   XT over RFB: xtkbd + special re-encoding of high bit
+
 my @basemaps = qw(linux osx atset1 atset2 atset3 xt xtkbd usb win32 xwinxt xkbdxt);
 my @derivedmaps = qw(xorgevdev xorgkbd xorgxquartz xorgxwin rfb);
 my @maps = (@basemaps, @derivedmaps);