Package: xlibs
Version: 6.8.2.dfsg.1-4
Tags: patch
Severity: minor
Hi,
These corrections for /etc/X11/xkb/README.config are not covered in #315555,
but the patch is (should be) based on a file already incorporating those
changes.
I have not (much) touched the basic linguistic style of the document, but I
agree with Daniel Hulme that the document deserves a general makeover.
#include <disclaimers/non-native-english-speaker>
--- README.config.old 2005-08-08 13:51:18.000000000 +0200
+++ README.config 2005-08-08 14:09:50.000000000 +0200
@@ -7,20 +7,20 @@
Abstract
This document describes how to configure X11R6.8.2 XKB from a
- user's point of view. It converts basic configuration syntax and
- gives also a few examples.
+ user's point of view. It covers basic configuration syntax and
+ also gives a few examples.
1. Overview
The XKB configuration is decomposed into a number of components. Selecting
proper parts and combining them back you can achieve most configurations
you might need. Unless you have a completely atypical keyboard you really
-don't need to touch any of xkb configuration files.
+don't need to touch any of xkb's configuration files.
2. Selecting XKB Configuration
The easiest and the most natural way to specify a keyboard mapping is to
-use rules component. As its name suggests it describes a number of general
+use the rules component. As its name suggests it describes a number of general
rules how to combine all bits and pieces into a valid and useful keyboard
mapping. All you need to do is to select a suitable rules file and then to
feed it with a few parameters that will adjust the keyboard behaviour to ful-
@@ -30,23 +30,23 @@
o XkbRules - files of rules to be used for keyboard mapping composition
- o XkbModel - name of model of your keyboard type
+ o XkbModel - name of the model of your keyboard
o XkbLayout - layout(s) you intend to use
- o XkbVariant - variant(s) of layout you intend to use
+ o XkbVariant - variant(s) of the layout you intend to use
o XkbOptions - extra xkb configuration options
The proper rules file depends on your vendor. In reality, the commonest file
of rules is xorg. For each rules file there is a description file named <ven-
-dor-rules>.lst, for instance xorg.lst which is located in xkb configuration
+dor-rules>.lst, for instance xorg.lst which is located in the xkb configuration
subdirectory rules (for example /etc/X11/xkb/rules).
2.1 Basic Configuration
Let's say you want to configure a PC style American keyboard with 104 keys as
-described in xorg.lst. It can be done by simply writing several lines from
+described in xorg.lst. This can be done by simply writing several lines from
below to you xorg.conf configuration file (previously known as
/etc/X11/XF86Config-4 or /etc/X11/XF86Config):
@@ -59,17 +59,16 @@
Option "XKbOptions" ""
EndSection
-The values of parameters XkbModel and XkbLayout are really not surprising.
-The parameters XkbOptions has been explicitly set to empty set of parameters.
-The parameter XkbVariant has been left out. That means the default variant
-named basic is loaded.
+The values of XkbModel and XkbLayout are really not surprising. XkbOptions
+has been explicitly set to the empty value. The parameter XkbVariant has
+been left out. That means the default variant named basic is loaded.
-Of course, this can be also done at runtime using utility setxkbmap. Shell
+Of course, this can also be done at runtime using utility setxkbmap. Shell
command loading the same keyboard mapping would look like:
setxkbmap -rules xorg -model pc104 -layout us -option ""
-The configuration and the shell command would be very analogical for most
+The configuration and the shell command would be very analogous for most
other layouts (internationalized mappings).
2.2 Advanced Configuration
@@ -81,8 +80,8 @@
keys.
Let's say you want to configure your new Logitech cordless desktop keyboard,
-you intend to use three different layouts at the same time - us, czech and
-german (in this order), and that you are used to Alt-Shift combination for
+you intend to use three different layouts at the same time - US, Czech and
+German (in this order), and that you are used to the Alt-Shift combination for
switching among them.
Then the configuration snippet could look like this:
@@ -96,8 +95,8 @@
Option "XKbOptions" "grp:alt_shift_toggle"
EndSection
-Of course, this can be also done at runtime using utility setxkbmap. Shell
-command loading the same keyboard mapping would look like:
+Of course, this can also be done at runtime using the utility setxkbmap. The
+Shell command loading the same keyboard mapping would look like:
setxkbmap -rules xorg -model logicordless -layout "us,cz,de" \
-option "grp:alt_shift_toggle"
@@ -123,7 +122,7 @@
left out (set to basic), the second is set to bksl (a special variant with an
enhanced definition of the backslash key).
-Analogically, the loading runtime will change to:
+Analogous, the loading runtime will change to:
setxkmap -rules xorg -model logicordless -layout "us,cz,de" \
-variant ",bksl," -option "grp:alt_shift_toggle"
@@ -190,7 +189,7 @@
keymap file which specified the direct xkb configuration. This method has
been obsoleted by previously described rules files which are far more flexi-
ble and allow simpler and more intuitive syntax. It is preserved merely for
-compatibility reasons. Avoid using it if it is possible.
+compatibility reasons. Avoid using it if possible.
$XdotOrg: xc/programs/xkbcomp/README.config,v 1.3.2.2 2005/02/08 00:44:27 kem Exp $
cheers
-- vbi
--
This statement is false.
Attachment:
pgp6D7RYJFzPY.pgp
Description: PGP signature