From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on sa.local.altlinux.org X-Spam-Level: X-Spam-Status: No, score=-1.0 required=5.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED, FREEMAIL_FROM,NML_ADSP_CUSTOM_MED autolearn=no autolearn_force=no version=3.4.1 Date: Sun, 6 Aug 2017 14:28:48 +0200 From: Alexey Gladkov To: Linux console tools development discussion Message-ID: <20170806122848.GB28006@comp-core-i7-2640m-0182e6.fortress> References: <0b2c4b49-1f28-d87a-205b-0c5c07b79e9c@projektwerkstatt.de> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <0b2c4b49-1f28-d87a-205b-0c5c07b79e9c@projektwerkstatt.de> Cc: kalle Subject: Re: [kbd] man keymaps X-BeenThere: kbd@lists.altlinux.org X-Mailman-Version: 2.1.12 Precedence: list Reply-To: Linux console tools development discussion List-Id: Linux console tools development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 06 Aug 2017 12:27:04 -0000 Archived-At: List-Archive: On Sun, Jul 23, 2017 at 07:51:38AM +0200, kalle wrote: > hello, > I have some improvement proposals or unclear points (where explanation > could be improved) for the man 5 keymaps page. > *It would make sense to explain the term 'charset' somewhere > what for is the code produced by a keysym ? How is it related to > character encoding? Good. > *it would make sense to explain basic terms at the beginning of the > page, e.g. charset, keysym, key(scan-)code ok. > *keysym: what does the term stand for? why 'symbol'? what does 'keyboard > actions' mean? is keyboard induced action possibly better? how is this > set of actions related to the specific kernel (driver?)? what do you mean by "specific kernel driver" ? > *'outputting character codes' -> explain more precisely what is meant > here by 'character codes' > *first the term 'keysyms' should be explained in detail, before > explaining special keysyms as modifiers are, e.g. the section "keysyms > can be given in decimal, octal" should be before the modifier part why ? > *the modifier-part is in my opinion badly explained - I roughly propose > the following: > to every key there are 2^8=256 (?) possibilities/modes of outputting > symbols (defined by the kernel driver?) > The 2^8 modes can be represented by eight binary digits, or interpreted > as a binary number with 8 (?) digits, e.g. 010000101. The first digit > standing , the last one for units of 2^0=1, in this example > 0*2^7+0*2^6+0*2^5+0*2^4+0*2^3+1*2^2+0*2^1+1*2^0=133. This description confuses even me. I believe that it is as described modifiers are now quite clear. > The different digits are called modifiers, since by combination of all > their different states (0 or 1) they are able to produce 256 (?) modes, > where the default one is when all modifiers are off (=0) so 00000000 > binary is also 0 decimal number. These modifiers are keysyms thus their > state can be changed by typing some keys and out of historical > development have been given following names: > > modifier name power of 2 decimal value > > Shift 0 1 > AltGr Alternate Graph 1 2 > ics > Control 2 4 > Alt 3 8 > ShiftL left Shift key 4 16 > ShiftR right Shift key 5 32 > CtrlL left Control key6 64 > CtrlR right Control k.7 128 > CapsShift 8 256 You want to make a describe the binary arithmetic for noobs ? > *I don't understand the example of the part starting with "Note that you > should be very careful[…]",because it tells that the Control modifier > stays switched on, until it is produced again by typing in the same key. I think this paragraph is quite clear in manpage. It describes what can happen if the keymap is wrong. > *To the sentence "these are actually being defined" add "by the map > specification line, see above" > *to "it has a special meaning" add: "to loadkeys (1)"? Patches are welcome! :) -- Rgrds, legion