Linux console tools development discussion
 help / color / mirror / Atom feed
* [kbd] man keymaps
@ 2017-07-23  5:51 kalle
  2017-08-06 12:28 ` Alexey Gladkov
  2017-08-11 12:04 ` Oleg Bulatov
  0 siblings, 2 replies; 4+ messages in thread
From: kalle @ 2017-07-23  5:51 UTC (permalink / raw)
  To: kbd

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?
*it would make sense to explain basic terms at the beginning of the
page, e.g. charset, keysym, key(scan-)code
*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?)?
*'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
*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
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
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
*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.
*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)"?


^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2017-08-11 12:04 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2017-07-23  5:51 [kbd] man keymaps kalle
2017-08-06 12:28 ` Alexey Gladkov
2017-08-06 16:20   ` kalle
2017-08-11 12:04 ` Oleg Bulatov

Linux console tools development discussion

This inbox may be cloned and mirrored by anyone:

	git clone --mirror kbd/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 kbd kbd/ \
	public-inbox-index kbd

Example config snippet for mirrors.
Newsgroup available over NNTP:

AGPL code for this site: git clone