Bug 263509

Summary:	FreeBSD Handbook: improve the context for kbdmap(1) ; and use the phrase "keyboard layout"
Product:	Documentation	Reporter:	Graham Perrin <grahamperrin>
Component:	Books & Articles	Assignee:	freebsd-doc (Nobody) <doc>
Status:	Open ---
Severity:	Affects Many People	CC:	doc, fernape, pauamma
Priority:	---	Keywords:	needs-patch
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://github.com/freebsd/freebsd-doc/blob/main/documentation/content/en/books/handbook/l10n/_index.adoc#user-content-setting-console
See Also:	https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=259342 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=263315
Bug Depends on:
Bug Blocks:	263315

Description Graham Perrin freebsd_committer

2022-04-24 09:11:10 UTC

From <https://docs.freebsd.org/en/books/handbook/book/#setting-console> | <https://docs.freebsd.org/en/books/handbook/l10n/#setting-console>: 

> To test keymaps without rebooting, use kbdmap(1).

From that, I could not have guessed that kbdmap _sets_ the chosen keyboard layout. 

Also, for discoverability, please use the plain English phrase "keyboard layout" somewhere in the section. 

Thanks

Comment 1 Graham Perrin freebsd_committer

2022-04-24 09:41:15 UTC

… hmm, things are slightly clearer after testing. 

kbdmap(1) does set, however the setting is not persistent. It's lost at reboot. 

On my everyday computer (configured years ago) I have: 

% sysrc keymap
keymap: /usr/share/syscons/keymaps/uk.iso.kbd
% 

None of the four United Kingdom options in kbdmap produces that map, so (I guess) kbdmap is not wholly useful for testing keymaps without rebooting.

Comment 2 Pau Amma 2022-05-05 04:36:59 UTC

(In reply to Graham Perrin from comment #1)

> keymap: /usr/share/syscons/keymaps/uk.iso.kbd
>
> None of the four United Kingdom options in kbdmap produces that map, so (I
> guess) kbdmap is not wholly useful for testing keymaps without rebooting.

I suspect this is because kbdmap (correctly) looks into /usr/share/vt/keymaps when sysctl kern.vty is set to "vt", and the near-equivalent (diff -u says it uses UTF-8 instead of ISO 8859 for the euro sign) is called /usr/share/vt/keymaps/uk.kbd instead. (This may or may not be an oversight. Maybe use of UTF-8 was the rationale for changing the name.)

Comment 3 Fernando Apesteguía freebsd_committer

2022-10-09 16:13:00 UTC

^Triage: reporter is committer, assign accordingly.

Comment 4 Graham Perrin freebsd_committer

2022-12-30 11:59:39 UTC

Triage, batch edit (just one): 

* for twenty-eight FreeBSD Handbook-related reports that had gained a 
  personal assignee, prior group/list assignee doc@ was 
  missing from the CC list.

Gentle hint: <https://wiki.freebsd.org/Bugzilla/> ▶ do, don't …

Comment 5 Fernando Apesteguía freebsd_committer

2023-08-21 06:25:11 UTC

^Triage: Reporter is committer, assign accordingly

Any committer may commit to any repository with an accepted review from any committer with existing access to that repository.

Committers may obtain review via a Differential in Phabricator, adding the "Contributor Reviewers ($Repository)" group as a Reviewer, reaching out to other committers; directly or via mailing lists, or setting the attachment flag to: maintainer-approval ? <person-youd-like-to-review>