diff mbox series

[bug#40120] doc: guix.texi: Add console-font-service-type to Base Services.

Message ID CAKf5CqX7vff8nRYi-KnmTLBBAZU2pMo-zi94m=mBU1aNrRXjrw@mail.gmail.com
State Accepted
Headers show
Series [bug#40120] doc: guix.texi: Add console-font-service-type to Base Services. | expand

Checks

Context Check Description
cbaines/comparison success View comparision
cbaines/git branch success View Git branch
cbaines/applying patch fail View Laminar job

Commit Message

John Soo March 18, 2020, 3:45 p.m. UTC 
Hi guix,

I struggled with the console-font-service-type for a long time (mostly
becase setfont does not state you can specify a path). Documenting it
in the info pages would have helped.

Thanks!

John

Comments

Ludovic Courtès March 21, 2020, 10:42 p.m. UTC | #1 
Hi John,

Thanks for improving the manual!  Some comments:

John Soo <jsoo1@asu.edu> skribis:

> From 6a7204a6396781c1bbc1db1defee362c0a8142f9 Mon Sep 17 00:00:00 2001
> From: John Soo <jsoo1@asu.edu>
> Date: Wed, 18 Mar 2020 08:33:59 -0700
> Subject: [PATCH] doc: guix.texi: Add console-font-service-type to Base
>  Services.
>
> * doc/guix.texi (console-font-service-type): Add it.
                  ^
This should be the name of the section this is added in.

> +@deffn {Scheme Procedure} console-font-service-type @var{tty-font-pairs}

This should be @defvr because it’s a variable, not a procedure (and thus
has no arguments).

Could you change that accordingly?  You can take inspiration from other
service types.

TIA!

Ludo’.
diff mbox series

Patch

From 6a7204a6396781c1bbc1db1defee362c0a8142f9 Mon Sep 17 00:00:00 2001
From: John Soo <jsoo1@asu.edu>
Date: Wed, 18 Mar 2020 08:33:59 -0700
Subject: [PATCH] doc: guix.texi: Add console-font-service-type to Base
 Services.

* doc/guix.texi (console-font-service-type): Add it.
---
 doc/guix.texi | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 28808b0cd5..0626beffac 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -12287,6 +12287,23 @@  symlink:
 Return a service that sets the host name to @var{name}.
 @end deffn
 
+@deffn {Scheme Procedure} console-font-service-type @var{tty-font-pairs}
+Install the given fonts on the specified ttys (fonts are per
+virtual console on the kernel Linux).  The value of this service is a list of
+tty/font pairs.  The font can be the name of a font provided by the @code{kbd}
+package or any valid argument to @command{setfont}, as in this example:
+
+@lisp
+'((\"tty1\" . \"LatGrkCyr-8x16\")
+  (\"tty2\" . (file-append
+                font-tamzen
+                \"/share/kbd/consolefonts/TamzenForPowerline10x20.psf\"))
+  (\"tty3\" . (file-append
+                font-terminus
+                \"/share/consolefonts/ter-132n\"))) ; for HDPI
+@end lisp
+@end deffn
+
 @deffn {Scheme Procedure} login-service @var{config}
 Return a service to run login according to @var{config}, a
 @code{<login-configuration>} object, which specifies the message of the day,
-- 
2.25.1