diff mbox

[3/3] doc: Describe how to make X server find TrueType fonts.

Message ID 20160701092730.2265-4-alezost@gmail.com
State New
Headers show

Commit Message

Alex Kost July 1, 2016, 9:27 a.m. UTC
* doc/guix.texi (Application Setup): Document how to add TrueType fonts
installed in a Guix profile to the X server font path.
---
 doc/guix.texi | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

Comments

Ludovic Courtès July 2, 2016, 2:38 p.m. UTC | #1
Alex Kost <alezost@gmail.com> skribis:

> * doc/guix.texi (Application Setup): Document how to add TrueType fonts
> installed in a Guix profile to the X server font path.

[...]

> @@ -1192,6 +1193,24 @@ to display fonts, you have to install fonts with Guix as well.
>  Essential font packages include @code{gs-fonts}, @code{font-dejavu}, and
>  @code{font-gnu-freefont-ttf}.
>  
> +However, some programs do not support Fontconfig and rely on the X
> +server to recognize a font.

What about: “Older programs such as @command{xterm} do not use
Fontconfig and instead rely on server-side font rendering.”?

> Such programs require to specify a full
> +name of a font using XLFD (X Logical Font Description), like this:
> +
> +@example
> +-*-dejavu sans-medium-r-normal-*-*-100-*-*-*-*-*-1
> +@end example
> +
> +To be able to use such full names for the TrueType fonts installed in
> +your Guix profile, you need to extend the font path of the X server:
> +
> +@example
> +xset +fp ~/.guix-profile/share/fonts/truetype
> +@end example
> +
> +After that, you can run @code{xlsfonts} (from @code{xlsfonts} package)
> +to make sure your TrueType fonts are listed there.

OK.

>  To display text written in Chinese languages, Japanese, or Korean in
>  graphical applications, consider installing
>  @code{font-adobe-source-han-sans} or @code{font-wqy-zenhei}.  The former

I would move the new text below the paragraph about Chinese languages
(the paragraph about Chinese languages is about client-side rendering.)

Thanks!

Ludo’.
Alex Kost July 2, 2016, 7:22 p.m. UTC | #2
Ludovic Courtès (2016-07-02 17:38 +0300) wrote:

> Alex Kost <alezost@gmail.com> skribis:
>
>> * doc/guix.texi (Application Setup): Document how to add TrueType fonts
>> installed in a Guix profile to the X server font path.
>
> [...]
>
>> @@ -1192,6 +1193,24 @@ to display fonts, you have to install fonts
>> with Guix as well.
>>  Essential font packages include @code{gs-fonts}, @code{font-dejavu}, and
>>  @code{font-gnu-freefont-ttf}.
>>  
>> +However, some programs do not support Fontconfig and rely on the X
>> +server to recognize a font.
>
> What about: “Older programs such as @command{xterm} do not use
> Fontconfig and instead rely on server-side font rendering.”?

Sure.

[...]
>>  To display text written in Chinese languages, Japanese, or Korean in
>>  graphical applications, consider installing
>>  @code{font-adobe-source-han-sans} or @code{font-wqy-zenhei}.  The former
>
> I would move the new text below the paragraph about Chinese languages
> (the paragraph about Chinese languages is about client-side rendering.)

Right, will do, thanks!
diff mbox

Patch

diff --git a/doc/guix.texi b/doc/guix.texi
index 62c0d34..0e7b698 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -13,6 +13,7 @@ 
 Copyright @copyright{} 2012, 2013, 2014, 2015, 2016 Ludovic Courtès@*
 Copyright @copyright{} 2013, 2014, 2016 Andreas Enge@*
 Copyright @copyright{} 2013 Nikita Karetnikov@*
+Copyright @copyright{} 2014, 2015, 2016 Alex Kost@*
 Copyright @copyright{} 2015, 2016 Mathieu Lirzin@*
 Copyright @copyright{} 2014 Pierre-Antoine Rault@*
 Copyright @copyright{} 2015 Taylan Ulrich Bayırlı/Kammer@*
@@ -1192,6 +1193,24 @@  to display fonts, you have to install fonts with Guix as well.
 Essential font packages include @code{gs-fonts}, @code{font-dejavu}, and
 @code{font-gnu-freefont-ttf}.
 
+However, some programs do not support Fontconfig and rely on the X
+server to recognize a font.  Such programs require to specify a full
+name of a font using XLFD (X Logical Font Description), like this:
+
+@example
+-*-dejavu sans-medium-r-normal-*-*-100-*-*-*-*-*-1
+@end example
+
+To be able to use such full names for the TrueType fonts installed in
+your Guix profile, you need to extend the font path of the X server:
+
+@example
+xset +fp ~/.guix-profile/share/fonts/truetype
+@end example
+
+After that, you can run @code{xlsfonts} (from @code{xlsfonts} package)
+to make sure your TrueType fonts are listed there.
+
 To display text written in Chinese languages, Japanese, or Korean in
 graphical applications, consider installing
 @code{font-adobe-source-han-sans} or @code{font-wqy-zenhei}.  The former