svn commit: r47412 - in head/en_US.ISO8859-1/books/porters-handbook: plist uses

[Mathieu Arnold]

Author: mat
Date: Mon Sep 14 13:32:29 2015
New Revision: 47412
URL: https://svnweb.freebsd.org/changeset/doc/47412

Log:
  Catch up with r396872, adding @fc and @fontsdir back, and as options to
  USES=fonts.
  
  Sponsored by:	Absolight

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
  head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml	Mon Sep 14 13:32:23 2015	(r47411)
+++ head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml	Mon Sep 14 13:32:29 2015	(r47412)
@@ -326,13 +326,42 @@ etc/orbit.conf-dist
 	after installation and deinstallation.</para>
     </sect2>
 
+    <sect2 xml:id="plist-keywords-fc">
+      <title><literal>@fc</literal>
+	<replaceable>directory</replaceable></title>
+
+      <para>Add a <literal>@dir</literal> entry for the directory
+	passed as an argument, and run <command>fc-cache -fs</command>
+	on that directory after installation and
+	deinstallation.</para>
+    </sect2>
+
     <sect2 xml:id="plist-keywords-fcfontsdir">
       <title><literal>@fcfontsdir</literal>
 	<replaceable>directory</replaceable></title>
 
       <para>Add a <literal>@dir</literal> entry for the
 	directory passed as an argument, and run <command>fc-cache
-	  -s</command>, <command>mkfontscale</command> and
+	  -fs</command>, <command>mkfontscale</command> and
+	<command>mkfontdir</command> on that directory after
+	installation and deinstallation.  Additionally, on
+	deinstallation, it removes the
+	<filename>fonts.scale</filename> and
+	<filename>fonts.dir</filename> cache files if they are
+	empty.  This keyword is equivalent to adding both <link
+	  linkend="plist-keywords-fc"><literal>@fc</literal>
+	  <replaceable>directory</replaceable></link> and <link
+	  linkend="plist-keywords-fontsdir"><literal>@fontsdir</literal>
+	  <replaceable>directory</replaceable></link>.</para>
+    </sect2>
+
+    <sect2 xml:id="plist-keywords-fontsdir">
+      <title><literal>@fontsdir</literal>
+	<replaceable>directory</replaceable></title>
+
+      <para>Add a <literal>@dir</literal> entry for the
+	directory passed as an argument, and run
+	<command>mkfontscale</command> and
 	<command>mkfontdir</command> on that directory after
 	installation and deinstallation.  Additionally, on
 	deinstallation, it removes the

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Mon Sep 14 13:32:23 2015	(r47411)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Mon Sep 14 13:32:29 2015	(r47412)
@@ -8,7 +8,7 @@
 
 <!--
 
-  Document up-to date with r381632 revision of the ports tree.
+  Document up-to date with r396872 revision of the ports tree.
 
   This file documents the values of the USES make variable.  The
   format is easy to grasp from the already-added entries below (or use
@@ -441,16 +441,24 @@
   <sect1 xml:id="uses-fonts">
     <title><literal>fonts</literal></title>
 
-    <para>Possible arguments: (none)</para>
-
-    <para>Adds a runtime dependency on tools needed to register fonts,
-      and add an <literal><link
+    <para>Possible arguments: (none), <literal>fc</literal>,
+      <literal>fcfontsdir</literal> (default),
+      <literal>fontsdir</literal>, <literal>none</literal></para>
+
+    <para>Adds a runtime dependency on tools needed to register fonts.
+      Depending on the argument, add a <literal><link
+	  linkend="plist-keywords-fc">@fc</link> ${FONTSDIR}</literal>
+      line, <literal><link
 	  linkend="plist-keywords-fcfontsdir">@fcfontsdir</link>
-	${FONTSDIR}</literal> para to the plist.
+	${FONTSDIR}</literal> line, <literal><link
+	  linkend="plist-keywords-fontsdir">@fontsdir</link>
+	${FONTSDIR}</literal> line, or no line if the argument is
+      <literal>none</literal>, to the plist.
       <varname>FONTSDIR</varname> defaults to
-      <filename>${PREFIX}/lib/X11/fonts/${FONTNAME}</filename> and
-      <varname>FONTNAME</varname> to
-      <literal>${PORTNAME}</literal>.</para>
+      <filename>${PREFIX}/share/fonts/${FONTNAME}</filename> and
+      <varname>FONTNAME</varname> to <literal>${PORTNAME}</literal>.
+      Add <literal>FONTSDIR</literal> to <varname>PLIST_SUB</varname>
+      and <varname>SUB_LIST</varname></para>
   </sect1>
 
   <sect1 xml:id="uses-fortran">