fc-cache -f --> fc-cache -fv in the manual

fc-cache -f --> fc-cache -fv in the manual

[Joshua Branson]

[-- Attachment #1: Type: text/plain, Size: 494 bytes --]

Hey Guix,

This is a tiny documentation fix.  When I was having trouble a few
days ago getting Icecat to display my fonts, I checked the manual and
ran the command "fc-cache -f".  It did successfully run, but I did not
see any indication that it did anything.  So I ran it repeatedly.

Perhaps we should add the verbose option.  This will signal to users
that the command is updating the font cache.  I also went ahead and
changed command in the translated manuals as well.  

Thanks,

Joshua


[-- Attachment #2: fc-cache -f --> fc-cache -fv --]
[-- Type: text/x-patch, Size: 9702 bytes --]

From 7ee67dcfec6bda2f66fcb1fbb4445444fb41e2e2 Mon Sep 17 00:00:00 2001
From: Joshua Branson <jbranso@dismail.de>
Date: Tue, 10 Sep 2019 11:48:41 -0400
Subject: [PATCH] "fc-cache -f" ought to be "fc-cache -fv".  This way users can
 see if they command is actually doing anything.

---
 doc/guix.texi               | 2 +-
 po/doc/guix-manual.de.po    | 4 ++--
 po/doc/guix-manual.es.po    | 4 ++--
 po/doc/guix-manual.fr.po    | 4 ++--
 po/doc/guix-manual.ru.po    | 4 ++--
 po/doc/guix-manual.zh_CN.po | 2 +-
 6 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 989b3d03bb..257b0ac2aa 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -1724,7 +1724,7 @@ to make sure your TrueType fonts are listed there.
 After installing fonts you may have to refresh the font cache to use
 them in applications.  The same applies when applications installed via
 Guix do not seem to find fonts.  To force rebuilding of the font cache
-run @code{fc-cache -f}.  The @code{fc-cache} command is provided by the
+run @code{fc-cache -fv}.  The @code{fc-cache} command is provided by the
 @code{fontconfig} package.
 
 @subsection X.509 Certificates
diff --git a/po/doc/guix-manual.de.po b/po/doc/guix-manual.de.po
index 7a598cfc64..152395a7e2 100644
--- a/po/doc/guix-manual.de.po
+++ b/po/doc/guix-manual.de.po
@@ -5210,8 +5210,8 @@ msgstr "Font-Cache"
 
 #. type: Plain text
 #: doc/guix.texi:1714
-msgid "After installing fonts you may have to refresh the font cache to use them in applications.  The same applies when applications installed via Guix do not seem to find fonts.  To force rebuilding of the font cache run @code{fc-cache -f}.  The @code{fc-cache} command is provided by the @code{fontconfig} package."
-msgstr "Nach der Installation der Schriftarten müssen Sie unter Umständen den Schriftarten-Zwischenspeicher (Font-Cache) erneuern, um diese in Anwendungen benutzen zu können. Gleiches gilt, wenn mit Guix installierte Anwendungen anscheinend keine Schriftarten finden können. Um das Erneuern des Font-Caches zu erzwingen, führen Sie @code{fc-cache -f} aus. Der Befehl @code{fc-cache} wird vom Paket @code{fontconfig} angeboten."
+msgid "After installing fonts you may have to refresh the font cache to use them in applications.  The same applies when applications installed via Guix do not seem to find fonts.  To force rebuilding of the font cache run @code{fc-cache -fv}.  The @code{fc-cache} command is provided by the @code{fontconfig} package."
+msgstr "Nach der Installation der Schriftarten müssen Sie unter Umständen den Schriftarten-Zwischenspeicher (Font-Cache) erneuern, um diese in Anwendungen benutzen zu können. Gleiches gilt, wenn mit Guix installierte Anwendungen anscheinend keine Schriftarten finden können. Um das Erneuern des Font-Caches zu erzwingen, führen Sie @code{fc-cache -fv} aus. Der Befehl @code{fc-cache} wird vom Paket @code{fontconfig} angeboten."
 
 #. type: code{#1}
 #: doc/guix.texi:1717 doc/guix.texi:23674
diff --git a/po/doc/guix-manual.es.po b/po/doc/guix-manual.es.po
index fd7efc4d0d..a71dc08099 100644
--- a/po/doc/guix-manual.es.po
+++ b/po/doc/guix-manual.es.po
@@ -5329,8 +5329,8 @@ msgstr "caché de tipografías"
 
 #. type: Plain text
 #: doc/guix.texi:1714
-msgid "After installing fonts you may have to refresh the font cache to use them in applications.  The same applies when applications installed via Guix do not seem to find fonts.  To force rebuilding of the font cache run @code{fc-cache -f}.  The @code{fc-cache} command is provided by the @code{fontconfig} package."
-msgstr "Después de instalar tipografías puede tener que refrescar la caché de tipografías para usarlas en las aplicaciones. Lo mismo aplica cuando las aplicaciones instaladas vía Guix no parecen encontrar tipografías. Para forzar la reconstrucción de la caché de tipografías ejecute @code{fc-cache -f}. La orden @code{fc-cache} es proporcionada por el paquete @code{fontconfig}."
+msgid "After installing fonts you may have to refresh the font cache to use them in applications.  The same applies when applications installed via Guix do not seem to find fonts.  To force rebuilding of the font cache run @code{fc-cache -fv}.  The @code{fc-cache} command is provided by the @code{fontconfig} package."
+msgstr "Después de instalar tipografías puede tener que refrescar la caché de tipografías para usarlas en las aplicaciones. Lo mismo aplica cuando las aplicaciones instaladas vía Guix no parecen encontrar tipografías. Para forzar la reconstrucción de la caché de tipografías ejecute @code{fc-cache -fv}. La orden @code{fc-cache} es proporcionada por el paquete @code{fontconfig}."
 
 #. type: code{#1}
 #: doc/guix.texi:1717 doc/guix.texi:23674
diff --git a/po/doc/guix-manual.fr.po b/po/doc/guix-manual.fr.po
index 668c32f0e4..ef8aec0a49 100644
--- a/po/doc/guix-manual.fr.po
+++ b/po/doc/guix-manual.fr.po
@@ -5265,8 +5265,8 @@ msgstr "cache de polices"
 
 #. type: Plain text
 #: doc/guix.texi:1714
-msgid "After installing fonts you may have to refresh the font cache to use them in applications.  The same applies when applications installed via Guix do not seem to find fonts.  To force rebuilding of the font cache run @code{fc-cache -f}.  The @code{fc-cache} command is provided by the @code{fontconfig} package."
-msgstr "Après l'installation des polices vous devrez peut-être rafraîchir le cache des polices pour pouvoir les utiliser dans les applications.  Ça s'applique aussi lorsque les applications installées avec Guix n'ont pas l'air de trouver les polices.  Pour forcer la reconstruction du cache de polices lancez @code{fc-cache -f}.  La commande @code{fc-cache} est fournie par le paquet @code{fontconfig}."
+msgid "After installing fonts you may have to refresh the font cache to use them in applications.  The same applies when applications installed via Guix do not seem to find fonts.  To force rebuilding of the font cache run @code{fc-cache -fv}.  The @code{fc-cache} command is provided by the @code{fontconfig} package."
+msgstr "Après l'installation des polices vous devrez peut-être rafraîchir le cache des polices pour pouvoir les utiliser dans les applications.  Ça s'applique aussi lorsque les applications installées avec Guix n'ont pas l'air de trouver les polices.  Pour forcer la reconstruction du cache de polices lancez @code{fc-cache -fv}.  La commande @code{fc-cache} est fournie par le paquet @code{fontconfig}."
 
 #. type: code{#1}
 #: doc/guix.texi:1717 doc/guix.texi:23674
diff --git a/po/doc/guix-manual.ru.po b/po/doc/guix-manual.ru.po
index 0421ffb0ed..b0a9c0bd16 100644
--- a/po/doc/guix-manual.ru.po
+++ b/po/doc/guix-manual.ru.po
@@ -5222,8 +5222,8 @@ msgstr "кеш шрифтов"
 
 #. type: Plain text
 #: doc/guix.texi:1714
-msgid "After installing fonts you may have to refresh the font cache to use them in applications.  The same applies when applications installed via Guix do not seem to find fonts.  To force rebuilding of the font cache run @code{fc-cache -f}.  The @code{fc-cache} command is provided by the @code{fontconfig} package."
-msgstr "После установки шрифтов, возможно вам потребуется обновить кеш шрифтов, чтобы использовать их в приложениях. Это необходимо делать, когда приложения, установленные с помощью Guix, не находят шрифты. Для того чтобы пересобрать кеш шрифтов, запустите @code{fc-cache -f}. Команда @code{fc-cache} предоставляется пакетом @code{fontconfig}."
+msgid "After installing fonts you may have to refresh the font cache to use them in applications.  The same applies when applications installed via Guix do not seem to find fonts.  To force rebuilding of the font cache run @code{fc-cache -fv}.  The @code{fc-cache} command is provided by the @code{fontconfig} package."
+msgstr "После установки шрифтов, возможно вам потребуется обновить кеш шрифтов, чтобы использовать их в приложениях. Это необходимо делать, когда приложения, установленные с помощью Guix, не находят шрифты. Для того чтобы пересобрать кеш шрифтов, запустите @code{fc-cache -fv}. Команда @code{fc-cache} предоставляется пакетом @code{fontconfig}."
 
 #. type: code{#1}
 #: doc/guix.texi:1717 doc/guix.texi:23674
diff --git a/po/doc/guix-manual.zh_CN.po b/po/doc/guix-manual.zh_CN.po
index c24900da31..f21e02f84d 100644
--- a/po/doc/guix-manual.zh_CN.po
+++ b/po/doc/guix-manual.zh_CN.po
@@ -5195,7 +5195,7 @@ msgstr ""
 
 #. type: Plain text
 #: doc/guix.texi:1714
-msgid "After installing fonts you may have to refresh the font cache to use them in applications.  The same applies when applications installed via Guix do not seem to find fonts.  To force rebuilding of the font cache run @code{fc-cache -f}.  The @code{fc-cache} command is provided by the @code{fontconfig} package."
+msgid "After installing fonts you may have to refresh the font cache to use them in applications.  The same applies when applications installed via Guix do not seem to find fonts.  To force rebuilding of the font cache run @code{fc-cache -fv}.  The @code{fc-cache} command is provided by the @code{fontconfig} package."
 msgstr ""
 
 #. type: code{#1}
-- 
2.23.0

Re: fc-cache -f --> fc-cache -fv in the manual

[Tobias Geerinckx-Rice]

[-- Attachment #1: Type: text/plain, Size: 1345 bytes --]

Joshua,

Joshua Branson 写道：
> This is a tiny documentation fix.  When I was having trouble a 
> few
> days ago getting Icecat to display my fonts, I checked the 
> manual and
> ran the command "fc-cache -f".  It did successfully run, but I 
> did not
> see any indication that it did anything.  So I ran it 
> repeatedly.

Such is the Unix way.  You're supposed to feel the 0 in the air, 
or something.

> Perhaps we should add the verbose option.  This will signal to 
> users
> that the command is updating the font cache.
>
> I also went ahead and changed command in the translated manuals 
> as well.

While that probably works, we don't usually do this and it 
significantly bloats the diff.  Don't bother.

Otherwise (and with a commit message) fine by me!  This will also 
warn about problematic things like

  /var/cache/fontconfig: not cleaning unwritable cache directory

although they will be so buried in the output that nobody will see 
'em.

Does you/anyone know if it would be useful to recommend ‘-rv’ 
instead of ‘-fv’?  I always use ‘-r’: where ‘-f’ rewrites 
all cache files whether or not they are considered out of date, 
‘-r’ also deletes them first, for good measure.  I don't know 
whether it makes a difference in the real world.

Kind regards,

T G-R

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 227 bytes --]

Re: fc-cache -f --> fc-cache -fv in the manual

[Danny Milosavljevic]

[-- Attachment #1: Type: text/plain, Size: 544 bytes --]

Hi T G-R,

On Tue, 10 Sep 2019 19:00:41 +0200
Tobias Geerinckx-Rice <me@tobias.gr> wrote:

> > ran the command "fc-cache -f".  It did successfully run, but I 
> > did not
> > see any indication that it did anything.  So I ran it 
> > repeatedly.  
> 
> Such is the Unix way.  You're supposed to feel the 0 in the air, 
> or something.

To be fair, you can set up the prompt so you can see the status code each time.

I have in my ~/.bashrc:

    export PS1='${?#0} \u@\h \w\$ '

That's a lot less annoying than the default.

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 488 bytes --]

Re: fc-cache -f --> fc-cache -fv in the manual

[Tobias Geerinckx-Rice]

[-- Attachment #1: Type: text/plain, Size: 418 bytes --]

Danny,

Danny Milosavljevic 写道：
>> Such is the Unix way.  You're supposed to feel the 0 in the 
>> air, 
>> or something.
>
> To be fair, you can set up the prompt so you can see the status 
> code each time.

Somewhere in my 90-line PROMPT_COMMAND, there's a line that does 
just that.  I don't mind silence, but it would be nice if fc-cache 
printed warnings by default.

Kind regards,

T G-R

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 227 bytes --]

Re: fc-cache -f --> fc-cache -fv in the manual

[P via Development of GNU Guix and the GNU System distribution.]

‐‐‐‐‐‐‐ Original Message ‐‐‐‐‐‐‐
On Tuesday, September 10, 2019 5:32 PM, Danny Milosavljevic <dannym@scratchpost.org> wrote:

> Hi T G-R,
>
> On Tue, 10 Sep 2019 19:00:41 +0200
> Tobias Geerinckx-Rice me@tobias.gr wrote:
>
> > > ran the command "fc-cache -f". It did successfully run, but I
> > > did not
> > > see any indication that it did anything. So I ran it
> > > repeatedly.
> >
> > Such is the Unix way. You're supposed to feel the 0 in the air,
> > or something.
>
> To be fair, you can set up the prompt so you can see the status code each time.
>
> I have in my ~/.bashrc:
>
> export PS1='${?#0} \u@\h \w\$ '
>
> That's a lot less annoying than the default.

GRML Zsh should be the default tbh, that always prints the result of the last command.

Re: fc-cache -f --> fc-cache -fv in the manual

[Joshua Branson]

Tobias Geerinckx-Rice <me@tobias.gr> writes:

>
> Otherwise (and with a commit message) fine by me!  This will also warn
> about problematic things like
>
>  /var/cache/fontconfig: not cleaning unwritable cache directory
>
> although they will be so buried in the output that nobody will see
> 'em.
>
> Does you/anyone know if it would be useful to recommend ‘-rv’ instead
> of ‘-fv’?  I always use ‘-r’: where ‘-f’ rewrites all cache files
> whether or not they are considered out of date, ‘-r’ also deletes them
> first, for good measure.  I don't know whether it makes a difference
> in the real world.
>

So I went ahead and changed "fc-cache -f" to "fc-cache -frv".  I also
only applied the change for the English manual.  I believe the commit
message is in a proper changelog format.  What do you think?

--
Joshua Branson
Sent from Emacs and Gnus

Re: fc-cache -f --> fc-cache -fv in the manual

[Joshua Branson]

[-- Attachment #1: Type: text/plain, Size: 72 bytes --]

Tobias Geerinckx-Rice <me@tobias.gr> writes:

Here's the actual patch:


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: fc-cache --]
[-- Type: text/x-patch, Size: 1021 bytes --]

From 3836c589f48910cb37d6a04d2bc778004aaf0628 Mon Sep 17 00:00:00 2001
From: Joshua Branson <jbranso@dismail.de>
Date: Wed, 11 Sep 2019 10:16:55 -0400
Subject: [PATCH] doc: add verbose and recursive command flag

* doc/guix.texi (Application Setup): "fc-cache -f" --> "fc-cache -frv"
---
 doc/guix.texi | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 989b3d03bb..a3c5a564c3 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -1724,8 +1724,8 @@ to make sure your TrueType fonts are listed there.
 After installing fonts you may have to refresh the font cache to use
 them in applications.  The same applies when applications installed via
 Guix do not seem to find fonts.  To force rebuilding of the font cache
-run @code{fc-cache -f}.  The @code{fc-cache} command is provided by the
-@code{fontconfig} package.
+run @code{fc-cache -frv}.  The @code{fc-cache} command is provided by
+the @code{fontconfig} package.
 
 @subsection X.509 Certificates
 
-- 
2.23.0


[-- Attachment #3: Type: text/plain, Size: 45 bytes --]


-- 
Joshua Branson
Sent from Emacs and Gnus

Re: fc-cache -f --> fc-cache -fv in the manual

[Tobias Geerinckx-Rice]

[-- Attachment #1: Type: text/plain, Size: 757 bytes --]

Joshua,

Joshua Branson 写道：
> So I went ahead and changed "fc-cache -f" to "fc-cache -frv".  I 
> also
> only applied the change for the English manual.  I believe the 
> commit
> message is in a proper changelog format.  What do you think?

Looks good!  I made only the following tweaks:

- Capital letter after ‘:’ (not English, just our convention).
- Full stops after sentences, and prefer sentences over 
  fragments/symbols.
- It wasn't obvious which ‘command’ the first line was talking 
  about.

As ‘-r’ doesn't mean ‘recursive’ but ‘--really-force’ and 
implies ‘-f’, I adjusted your patch accordingly and pushed it as 
0cd3e99d64081e958919845ddd01ae8d2fb2d692.  Thanks!

Kind regards,

T G-R

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 227 bytes --]