all messages for Guix-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Albin <albin@fripost.org>
To: "Ludovic Courtès" <ludo@gnu.org>, "Alex Kost" <alezost@gmail.com>
Cc: guix-devel@gnu.org
Subject: Re: [PATCH] services: 'console-keymap-service' takes multiple files.
Date: Sat, 16 Apr 2016 04:47:29 +0200	[thread overview]
Message-ID: <5711A7C1.3040601@fripost.org> (raw)
In-Reply-To: <87vb3ir2pp.fsf@gnu.org>

Den 2016-04-15 kl. 23:17, skrev Ludovic Courtès:
> Alex Kost <alezost@gmail.com> skribis:
> 
>> Ludovic Courtès (2016-04-14 00:23 +0300) wrote:
>>
>>> Alex Kost <alezost@gmail.com> skribis:
>>>
>>>> From 8c58974b549479a8e97cf64f21393aa495596e13 Mon Sep 17 00:00:00 2001
>>>> From: Alex Kost <alezost@gmail.com>
>>>> Date: Sat, 9 Apr 2016 00:21:15 +0300
>>>> Subject: [PATCH] services: 'console-keymap-service' takes multiple files.
>>>>
>>>> * gnu/services/base.scm (console-keymap-service-type): Type procedure
>>>> takes a list of files instead of a single file.
>>>> (console-keymap-service): Take 'files' as rest arguments.
>>>> * doc/guix.texi (Base Services): Improve documentation of
>>>> 'console-keymap-service'.
>>>
>>> [...]
>>>
>>>> +Return a service to load console keymaps from @var{files} using
>>>> +@command{loadkeys} command.  Most likely, you want to load some default
>>>> +keymap, which can be done like this:
>>>> +
>>>> +@example
>>>> +(console-keymap-service "dvorak")
>>>> +@end example
>>>
>>> Perhaps you could add the example from the IRC discussion you mentioned
>>> with a short explanation, just below this example?
>>
>> Would the following be OK?
>>
>>
>> @deffn {Scheme Procedure} console-keymap-service @var{files} ...
>> @cindex keyboard layout
>> Return a service to load console keymaps from @var{files} using
>> @command{loadkeys} command.  Most likely, you want to load some default
>> keymap, which can be done like this:
>>
>> @example
>> (console-keymap-service "dvorak")
>> @end example
>>
>> Or, for example, for Swedish keyboards, you may need to combine keymaps:
>> @example
>> (console-keymap-service "se-ir209" "se-fi-ir209")
> 
> Ideally with a few words to explain why this is useful on Swedish
> keyboards (Albin? :-)), but otherwise LGTM!
> 
> Ludo’.
> 

I don't think it's necessary to explain exactly why it's useful here
because it's a simple fact that loading just the first "se-ir209"
doesn't enable a Swedish but some kind of US-Danish freak keymap :-),
which the user will soon discover.  If it doesn't cross your mind that
*two* keymaps may be necessary for using *one* keyboard (how obvious is
that, really?), then you might start to think that perhaps the Guix
folks simply forgot to include the one that you need.  IMHO upstream
should ditch the whole dual keymap thing if it's technically feasible to
do so.

The formulation above looks good to me also, except I think it's clearer
with the formulation "a Swedish keyboard" in this context.


Albin

  reply	other threads:[~2016-04-16  2:47 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-04-08 21:32 [PATCH] services: 'console-keymap-service' takes multiple files Alex Kost
2016-04-09  8:16 ` Alex Kost
2016-04-13 21:23 ` Ludovic Courtès
2016-04-15 16:10   ` Alex Kost
2016-04-15 20:19     ` Albin
2016-04-16  8:24       ` Alex Kost
2016-04-15 21:17     ` Ludovic Courtès
2016-04-16  2:47       ` Albin [this message]
2016-04-16  8:24         ` Alex Kost
2016-04-16 14:41           ` Albin
2016-04-16 22:49             ` Ludovic Courtès
2016-04-17  7:41             ` Alex Kost

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=5711A7C1.3040601@fripost.org \
    --to=albin@fripost.org \
    --cc=alezost@gmail.com \
    --cc=guix-devel@gnu.org \
    --cc=ludo@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/guix.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.