Imported Upstream version 2.13.1
[platform/upstream/fontconfig.git] / doc / fontconfig-user.html
index 1c63901..bbef7de 100644 (file)
@@ -1245,9 +1245,9 @@ CLASS="PROGRAMLISTING"
        Names not including any well known alias are given 'sans-serif'
 -->
 <match target="pattern">
-       <test qual="all" name="family" mode="not_eq"><string>sans-serif</string></test>
-       <test qual="all" name="family" mode="not_eq"><string>serif</string></test>
-       <test qual="all" name="family" mode="not_eq"><string>monospace</string></test>
+       <test qual="all" name="family" compare="not_eq"><string>sans-serif</string></test>
+       <test qual="all" name="family" compare="not_eq"><string>serif</string></test>
+       <test qual="all" name="family" compare="not_eq"><string>monospace</string></test>
        <edit name="family" mode="append_last"><string>sans-serif</string></edit>
 </match>
 
@@ -1309,7 +1309,7 @@ CLASS="PROGRAMLISTING"
        add 'monospace' as the alternative
 -->
 <match target="pattern">
-       <test name="family" mode="eq">
+       <test name="family" compare="eq">
                <string>Courier New</string>
        </test>
        <edit name="family" mode="prepend">
@@ -1317,7 +1317,7 @@ CLASS="PROGRAMLISTING"
        </edit>
 </match>
 <match target="pattern">
-       <test name="family" mode="eq">
+       <test name="family" compare="eq">
                <string>Courier</string>
        </test>
        <edit name="family" mode="prepend">
@@ -1505,6 +1505,13 @@ is used to override the default configuration directory.
 ><P
 ><I
 CLASS="EMPHASIS"
+>FONTCONFIG_SYSROOT</I
+>
+is used to set a default sysroot directory.
+  </P
+><P
+><I
+CLASS="EMPHASIS"
 >FC_DEBUG</I
 >
 is used to output the detailed debugging messages. see <A
@@ -1536,27 +1543,44 @@ CLASS="EMPHASIS"
 >
 is used to control the use of mmap(2) for the cache files if available. this take a boolean value. fontconfig will checks if the cache files are stored on the filesystem that is safe to use mmap(2). explicitly setting this environment variable will causes skipping this check and enforce to use or not use mmap(2) anyway.
   </P
+><P
+><I
+CLASS="EMPHASIS"
+>SOURCE_DATE_EPOCH</I
+>
+is used to ensure <TT
+CLASS="LITERAL"
+>fc-cache(1)</TT
+> generates files in a deterministic manner in order to support reproducible builds. When set to a numeric representation of UNIX timestamp, fontconfig will prefer this value over using the modification timestamps of the input files in order to identify which cache files require regeneration. If <TT
+CLASS="LITERAL"
+>SOURCE_DATE_EPOCH</TT
+> is not set (or is newer than the mtime of the directory), the existing behaviour is unchanged.
+  </P
 ></DIV
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN278"
+NAME="AEN284"
 ></A
 ><H2
 >See Also</H2
 ><P
->fc-cat(1), fc-cache(1), fc-list(1), fc-match(1), fc-query(1)
+>fc-cat(1), fc-cache(1), fc-list(1), fc-match(1), fc-query(1), <A
+HREF="https://reproducible-builds.org/specs/source-date-epoch/"
+TARGET="_top"
+>SOURCE_DATE_EPOCH</A
+>.
   </P
 ></DIV
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN281"
+NAME="AEN288"
 ></A
 ><H2
 >Version</H2
 ><P
->Fontconfig version 2.13.0
+>Fontconfig version 2.13.1
 
            </P
 ></DIV