Better wording for comments in config

Fixes https://gitlab.freedesktop.org/fontconfig/fontconfig/-/issues/274

15 files changed, 60 insertions, 60 deletions

diff --git a/conf.d/09-autohint-if-no-hinting.conf b/conf.d/09-autohint-if-no-hinting.conf
index 90d4614..0de5041 100644
--- a/conf.d/09-autohint-if-no-hinting.conf
+++ b/conf.d/09-autohint-if-no-hinting.conf
@@ -6,10 +6,10 @@
   <match target="font">
     <test name="fonthashint"><bool>false</bool></test>
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit name="autohint" mode="append"><bool>true</bool></edit>
   </match>
diff --git a/conf.d/10-autohint.conf b/conf.d/10-autohint.conf
index 7460249..347a14e 100644
--- a/conf.d/10-autohint.conf
+++ b/conf.d/10-autohint.conf
@@ -5,10 +5,10 @@
 <!--  Use the Autohinter --> 
   <match target="pattern">
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit name="autohint" mode="append"><bool>true</bool></edit>
   </match>
diff --git a/conf.d/10-hinting-full.conf b/conf.d/10-hinting-full.conf
index bbba6ff..62a13db 100644
--- a/conf.d/10-hinting-full.conf
+++ b/conf.d/10-hinting-full.conf
@@ -5,10 +5,10 @@
 
   <match target="pattern">
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit name="hintstyle" mode="append"><const>hintfull</const></edit>
   </match>
diff --git a/conf.d/10-hinting-medium.conf b/conf.d/10-hinting-medium.conf
index ea48dd7..da6c3eb 100644
--- a/conf.d/10-hinting-medium.conf
+++ b/conf.d/10-hinting-medium.conf
@@ -5,10 +5,10 @@
 
   <match target="pattern">
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit name="hintstyle" mode="append"><const>hintmedium</const></edit>
   </match>
diff --git a/conf.d/10-hinting-none.conf b/conf.d/10-hinting-none.conf
index c8c554a..4c40ad4 100644
--- a/conf.d/10-hinting-none.conf
+++ b/conf.d/10-hinting-none.conf
@@ -5,10 +5,10 @@
 
   <match target="pattern">
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit name="hintstyle" mode="append"><const>hintnone</const></edit>
   </match>
diff --git a/conf.d/10-hinting-slight.conf b/conf.d/10-hinting-slight.conf
index 4374747..96a81fb 100644
--- a/conf.d/10-hinting-slight.conf
+++ b/conf.d/10-hinting-slight.conf
@@ -5,10 +5,10 @@
 
   <match target="pattern">
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit name="hintstyle" mode="append"><const>hintslight</const></edit>
   </match>
diff --git a/conf.d/10-no-sub-pixel.conf b/conf.d/10-no-sub-pixel.conf
index 782b521..1fb6c98 100644
--- a/conf.d/10-no-sub-pixel.conf
+++ b/conf.d/10-no-sub-pixel.conf
@@ -5,10 +5,10 @@
 <!--  Disable sub-pixel rendering --> 
   <match target="pattern">
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit name="rgba" mode="append"><const>none</const></edit>
   </match>
diff --git a/conf.d/10-sub-pixel-bgr.conf b/conf.d/10-sub-pixel-bgr.conf
index 3039b13..b74d99f 100644
--- a/conf.d/10-sub-pixel-bgr.conf
+++ b/conf.d/10-sub-pixel-bgr.conf
@@ -5,10 +5,10 @@
 <!--  Enable sub-pixel rendering --> 
   <match target="pattern">
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit name="rgba" mode="append"><const>bgr</const></edit>
   </match>
diff --git a/conf.d/10-sub-pixel-rgb.conf b/conf.d/10-sub-pixel-rgb.conf
index 2a7f238..a87470a 100644
--- a/conf.d/10-sub-pixel-rgb.conf
+++ b/conf.d/10-sub-pixel-rgb.conf
@@ -5,10 +5,10 @@
 <!--  Enable sub-pixel rendering --> 
   <match target="pattern">
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit name="rgba" mode="append"><const>rgb</const></edit>
   </match>
diff --git a/conf.d/10-sub-pixel-vbgr.conf b/conf.d/10-sub-pixel-vbgr.conf
index 03cd602..8a03787 100644
--- a/conf.d/10-sub-pixel-vbgr.conf
+++ b/conf.d/10-sub-pixel-vbgr.conf
@@ -5,10 +5,10 @@
 <!--  Enable sub-pixel rendering --> 
   <match target="pattern">
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit name="rgba" mode="append"><const>vbgr</const></edit>
   </match>
diff --git a/conf.d/10-sub-pixel-vrgb.conf b/conf.d/10-sub-pixel-vrgb.conf
index 3d52562..a21d4c7 100644
--- a/conf.d/10-sub-pixel-vrgb.conf
+++ b/conf.d/10-sub-pixel-vrgb.conf
@@ -5,10 +5,10 @@
 <!--  Enable sub-pixel rendering --> 
   <match target="pattern">
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit name="rgba" mode="append"><const>vrgb</const></edit>
   </match>
diff --git a/conf.d/10-unhinted.conf b/conf.d/10-unhinted.conf
index 3744cd5..9290558 100644
--- a/conf.d/10-unhinted.conf
+++ b/conf.d/10-unhinted.conf
@@ -5,10 +5,10 @@
 <!--  Disable hinting --> 
   <match target="pattern">
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit name="hinting" mode="append"><bool>false</bool></edit>
   </match>
diff --git a/conf.d/11-lcdfilter-default.conf b/conf.d/11-lcdfilter-default.conf
index 41dd9a2..6025597 100644
--- a/conf.d/11-lcdfilter-default.conf
+++ b/conf.d/11-lcdfilter-default.conf
@@ -5,10 +5,10 @@
 <!--  Use lcddefault as default for LCD filter -->
   <match target="pattern">
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit mode="append" name="lcdfilter">
       <const>lcddefault</const>
diff --git a/conf.d/11-lcdfilter-legacy.conf b/conf.d/11-lcdfilter-legacy.conf
index f78032a..9cb6d3e 100644
--- a/conf.d/11-lcdfilter-legacy.conf
+++ b/conf.d/11-lcdfilter-legacy.conf
@@ -5,10 +5,10 @@
 <!--  Use lcdlegacy as default for LCD filter -->
   <match target="pattern">
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit mode="append" name="lcdfilter">
       <const>lcdlegacy</const>
diff --git a/conf.d/11-lcdfilter-light.conf b/conf.d/11-lcdfilter-light.conf
index adb6086..1f9231e 100644
--- a/conf.d/11-lcdfilter-light.conf
+++ b/conf.d/11-lcdfilter-light.conf
@@ -5,10 +5,10 @@
 <!--  Use lcdlight as default for LCD filter -->
   <match target="pattern">
     <!--
-      This configuration is available on the major desktop environments.
-      We shouldn't overwrite it with "assign" unconditionally.
-      Most clients may picks up the first value only. so using "append"
-      may simply works to avoid it.
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
     -->
     <edit mode="append" name="lcdfilter">
       <const>lcdlight</const>