changeset 28393:0824d92a449d stable

Document fc-cache must be run after installing new fonts (bug #58432) * genpropdoc.m (get_doc): In fontname property description, explain that users on non-Linux systems must update the font cache manually after installing new fonts on their system.
author Pantxo Diribarne <pantxo.diribarne@gmail.com>
date Mon, 01 Jun 2020 23:37:34 +0200
parents 38ebf4885e0f
children a379987a74b0
files doc/interpreter/genpropdoc.m
diffstat 1 files changed, 5 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/doc/interpreter/genpropdoc.m	Mon Jun 01 00:58:03 2020 +0200
+++ b/doc/interpreter/genpropdoc.m	Mon Jun 01 23:37:34 2020 +0200
@@ -124,7 +124,11 @@
   doc_fontname = "Name of font used for text rendering.  When setting \
 this property, the text rendering engine will search for a matching \
 font in your system.  If none is found then text is rendered using a \
-default sans serif font (same as the default @qcode{\"*\"} value).";
+default sans serif font (same as the default @qcode{\"*\"} value).\n\n\
+Programming Note: On systems that don’t use FontConfig natively \
+(all but Linux), the font cache is built when Octave is installed.  \
+You will need to run @code{system (\"fc-cache -fv\")} manually after \
+installing new fonts.";
   doc_fontunits = "Units used to interpret the @qcode{\"fontsize\"} property.";
   doc_fontweight = "Control the variant of the base font used for \
 text rendering.";