debian/README.Debian

   1 Notes about the Debian xkb-data package
   2 =======================================
   3
   4 Support of Apple keyboards
   5 --------------------------
   6
   7 Apple keyboards have been mostly unusable with XKB for years,
   8 and many unofficial files spread around the Internet to fix
   9 this mess.  Fortunately this issue has been fixed now, thanks
  10 to testers on the debian-powerpc mailing list, and changes
  11 have been merged upstream.
  12
  13 The following models are available:
  14  * macintosh_old
  15    For old kernels with ADB keycodes
  16  * ibook powerbook macbook78 macbook79
  17    Laptop, 3rd and 4th levels are obtained by the small Enter key.
  18  * macintosh
  19    Default Macintosh
  20 These models look for symbols in /usr/share/X11/xkb/symbols/macintosh_vndr,
  21 which means that the following layouts can be selected:
  22    ch de dk es fi fr gb is it latam nl no pt se us
  23
  24 PC models can be selected, to have access to more layouts.  Some options
  25 may then be added to have the same behavior as with Macintosh keyboards.
  26 Here is a (non exhaustive) list of relevant options:
  27  * lv3:lwin_switch   Press left Apple-key to choose 3rd level.
  28  * lv3:enter_switch  Press Enter key on keypad to choose 3rd level.
  29  * numpad:mac        Numpad keys work as with Macintosh keyboards.
  30  * apple:badmap      Swap keycodes of two keys when Mac keyboards are
  31                      misdetected by kernel.
  32
  33 Variants have been added to PC layouts to emulate Macintosh layouts.
  34 For instance,
  35
  36     Option     "XkbRules"    "xorg"
  37     Option     "XkbModel"    "ibook"
  38     Option     "XkbLayout"   "fr"
  39
  40 in /etc/X11/xorg.conf can be replaced by
  41
  42     Option     "XkbRules"    "xorg"
  43     Option     "XkbModel"    "pc105"
  44     Option     "XkbLayout"   "fr"
  45     Option     "XkbVariant"  "mac"
  46     Option     "XkbOptions"  "lv3:enter_switch,apple:badmap,numpad:mac"
  47
  48 Denis Barbier <barbier@debian.org>  Thu,  5 Oct 2006 22:51:12 +0200
  49
  50 Cleaning /etc/X11/xkb
  51 ---------------------
  52
  53 Since 0.8-3, all the files in /etc/X11/xkb/ were moved to
  54 /usr/share/X11/xkb/symbols. If you want to clean /etc/X11/xkb/, you need
  55 to run dpkg -P xlibs.
  56
  57 Your 'Fn' key is not working
  58 ----------------------------
  59
  60 On some laptops (Gateway MX6453 for instance), when X starts with
  61 numlock on, the 'Fn' key is toggled the wrong way. Just turn numlock off
  62 to get the 'Fn' key work again.
  63
  64 Mohammed Adnène Trojette <adn+deb@diwi.org>  Thu, 01 May 2008 02:36:13 +0200