From owner-svn-doc-head@FreeBSD.ORG  Thu Mar 19 19:20:22 2015
Return-Path: <owner-svn-doc-head@FreeBSD.ORG>
Delivered-To: svn-doc-head@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 5EEDA77D;
 Thu, 19 Mar 2015 19:20:22 +0000 (UTC)
Received: from svn.freebsd.org (svn.freebsd.org
 [IPv6:2001:1900:2254:2068::e6a:0])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id 3F1039CD;
 Thu, 19 Mar 2015 19:20:22 +0000 (UTC)
Received: from svn.freebsd.org ([127.0.1.70])
 by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t2JJKM5Y025869;
 Thu, 19 Mar 2015 19:20:22 GMT (envelope-from mat@FreeBSD.org)
Received: (from mat@localhost)
 by svn.freebsd.org (8.14.9/8.14.9/Submit) id t2JJKLUO025866;
 Thu, 19 Mar 2015 19:20:21 GMT (envelope-from mat@FreeBSD.org)
Message-Id: <201503191920.t2JJKLUO025866@svn.freebsd.org>
X-Authentication-Warning: svn.freebsd.org: mat set sender to mat@FreeBSD.org
 using -f
From: Mathieu Arnold <mat@FreeBSD.org>
Date: Thu, 19 Mar 2015 19:20:21 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
 svn-doc-head@freebsd.org
Subject: svn commit: r46359 - in head/en_US.ISO8859-1/books/porters-handbook:
 plist uses
X-SVN-Group: doc-head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-BeenThere: svn-doc-head@freebsd.org
X-Mailman-Version: 2.1.18-1
Precedence: list
List-Id: SVN commit messages for the doc tree for head
 <svn-doc-head.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-head>,
 <mailto:svn-doc-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-head/>
List-Post: <mailto:svn-doc-head@freebsd.org>
List-Help: <mailto:svn-doc-head-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-head>,
 <mailto:svn-doc-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 19 Mar 2015 19:20:22 -0000

Author: mat (ports committer)
Date: Thu Mar 19 19:20:20 2015
New Revision: 46359
URL: https://svnweb.freebsd.org/changeset/doc/46359

Log:
  Catch up with USES and Keywords.
  
  Differential Revision:	https://reviews.freebsd.org/D2099
  Approved by:	brd
  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	Thu Mar 19 17:48:01 2015	(r46358)
+++ head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml	Thu Mar 19 19:20:20 2015	(r46359)
@@ -313,7 +313,17 @@ etc/orbit.conf-dist
 
     <programlisting>@sample(,games,660) etc/config.sample</programlisting>
 
-    <!-- Try and keep the keywords alphanumerically sorted -->
+    <!--
+    Keywords up-to-date with r381632.
+    Try and keep the keywords alphanumerically sorted.
+    -->
+
+    <sect2 xml:id="plist-keywords-desktop-file-utils">
+      <title><literal>@desktop-file-utils</literal></title>
+
+      <para>Will run <command>update-desktop-database -q</command>
+	after installation and deinstallation.</para>
+    </sect2>
 
     <sect2 xml:id="plist-keywords-fc">
       <title><literal>@fc</literal>
@@ -355,6 +365,13 @@ etc/orbit.conf-dist
 	empty.</para>
     </sect2>
 
+    <sect2 xml:id="plist-keywords-glib-schemas">
+      <title><literal>@glib-schemas</literal></title>
+
+      <para>Runs <command>glib-compile-schemas</command> on
+	installation and deinstallation.</para>
+    </sect2>
+
     <sect2 xml:id="plist-keywords-info">
       <title><literal>@info</literal>
 	<replaceable>file</replaceable></title>
@@ -365,6 +382,23 @@ etc/orbit.conf-dist
 	deinstallation.</para>
     </sect2>
 
+    <sect2 xml:id="plist-keywords-kld">
+      <title><literal>@kld</literal>
+	<replaceable>directory</replaceable></title>
+
+      <para>Runs <command>kldxref</command> on the directory
+	on installation and deinstallation.  Additionally, on
+	deinstallation, it will remove the directory if empty.</para>
+    </sect2>
+
+    <sect2 xml:id="plist-keywords-rmtry">
+      <title><literal>@rmtry</literal>
+	<replaceable>file</replaceable></title>
+
+      <para>Will remove the file on deinstallation, and not give an
+	error if the file is not there.</para>
+    </sect2>
+
     <sect2 xml:id="plist-keywords-sample">
       <title><literal>@sample</literal>
 	<replaceable>file</replaceable></title>
@@ -380,6 +414,14 @@ etc/orbit.conf-dist
 	information.</para>
     </sect2>
 
+    <sect2 xml:id="plist-keywords-shared-mime-info">
+      <title><literal>@shared-mime-info</literal>
+	<replaceable>directory</replaceable></title>
+
+      <para>Runs <command>update-mime-database</command> on the
+	directory on installation and deinstallation.</para>
+    </sect2>
+
     <sect2 xml:id="plist-keywords-shell">
       <title><literal>@shell</literal>
 	<replaceable>file</replaceable></title>

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Thu Mar 19 17:48:01 2015	(r46358)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Thu Mar 19 19:20:20 2015	(r46359)
@@ -8,7 +8,7 @@
 
 <!--
 
-  Document up-to date with r364718 revision of the ports tree.
+  Document up-to date with r381632 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
@@ -47,13 +47,16 @@
 	<row xml:id="uses-ada">
 	  <entry><literal>ada</literal></entry>
 
-	  <entry>(none), <literal>47</literal></entry>
+	  <entry>(none), <literal>47</literal>, <literal>49</literal>,
+	    <literal>5</literal></entry>
 
 	  <entry>Depends on an <application>Ada</application>-capable
 	    compiler, and sets <varname>CC</varname> accordingly.
 	    Defaults to a <application>gcc</application> 4.9 based
 	    compiler, use <literal>:47</literal> to use the older
-	    <application>gcc</application> 4.7 based one.</entry>
+	    <application>gcc</application> 4.7 based one and
+	    <literal>:5</literal> to use the newer
+	    <application>gcc</application> 5 based one.</entry>
 	</row>
 
 	<row xml:id="uses-autoreconf">
@@ -80,6 +83,17 @@
 	    not run <command>autoreconf</command>.</entry>
 	</row>
 
+	<row xml:id="uses-blaslapack">
+	  <entry><literal>blaslapack</literal></entry>
+
+	  <entry>(none), <literal>atlas</literal>,
+	    <literal>netlib</literal> (default),
+	    <literal>gotoblas</literal>,
+	    <literal>openblas</literal></entry>
+
+	  <entry>Adds dependencies on Blas / Lapack libraries.</entry>
+	</row>
+
 	<row xml:id="uses-bison">
 	  <entry><literal>bison</literal></entry>
 
@@ -297,10 +311,9 @@
 	    <package role="port">devel/desktop-file-utils</package>.
 	    An extra post-install step will be run without interfering
 	    with any post-install steps already in the port
-	    <filename>Makefile</filename>.  Lines will be inserted
-	    into the plist to run
-	    <application>update-desktop-database</application> on
-	    package install or removal.</entry>
+	    <filename>Makefile</filename>.  A line with <link
+	      linkend="plist-keywords-desktop-file-utils"><literal>@desktop-file-utils</literal></link>
+	    will be added to the plist.</entry>
 	</row>
 
 	<row xml:id="uses-desthack">
@@ -388,6 +401,15 @@
 	    base system.</entry>
 	</row>
 
+	<row xml:id="uses-fakeroot">
+	  <entry><literal>fakeroot</literal></entry>
+
+	  <entry>(none)</entry>
+
+	  <entry>Changes some default behaviour of build systems to
+	    allow installing as a user.</entry>
+	</row>
+
 	<row xml:id="uses-fam">
 	  <entry><literal>fam</literal></entry>
 
@@ -409,6 +431,21 @@
 	    build-time dependency.</entry>
 	</row>
 
+	<row xml:id="uses-fonts">
+	  <entry><literal>fonts</literal></entry>
+
+	  <entry>(none)</entry>
+
+	  <entry>Adds a runtime dependency on tools needed to register
+	    fonts, and add an <literal><link
+		linkend="plist-keywords-fcfontsdir">@fcfontsdir</link>
+	      ${FONTSDIR}</literal> entry to the plist.
+	    <varname>FONTSDIR</varname> defaults to
+	    <filename>${PREFIX}/lib/X11/fonts/${FONTNAME}</filename>
+	    and <varname>FONTNAME</varname> to
+	    <literal>${PORTNAME}</literal>.</entry>
+	</row>
+
 	<row xml:id="uses-fortran">
 	  <entry><literal>fortran</literal></entry>
 
@@ -454,16 +491,43 @@
 	<row xml:id="uses-gettext">
 	  <entry><literal>gettext</literal></entry>
 
+	  <entry>(none)</entry>
+
+	  <entry>Deprecated.  Will include both <link
+	      linkend="uses-gettext-runtime"><literal>gettext-runtime</literal></link>
+	    and <link
+	      linkend="uses-gettext-tools"><literal>gettext-tools</literal></link>.</entry>
+	</row>
+
+	<row xml:id="uses-gettext-runtime">
+	  <entry><literal>gettext-runtime</literal></entry>
+
 	  <entry>(none), <literal>lib</literal> (default),
 	    <literal>build</literal>, <literal>run</literal></entry>
 
-	  <entry>Uses <package role="port">devel/gettext</package>.
-	    By default, with no arguments or with the
+	  <entry>Uses <package
+	      role="port">devel/gettext-runtime</package>.  By
+	    default, with no arguments or with the
 	    <literal>lib</literal> argument, implies a library
 	    dependency on <filename>libintl.so</filename>.
 	    <literal>build</literal> and <literal>run</literal>
 	    implies, respectively a build-time and a run-time
-	    dependency on <filename>xgettext</filename>.</entry>
+	    dependency on <filename>gettext</filename>.</entry>
+	</row>
+
+	<row xml:id="uses-gettext-tools">
+	  <entry><literal>gettext-tools</literal></entry>
+
+	  <entry>(none), <literal>build</literal> (default),
+	    <literal>run</literal></entry>
+
+	  <entry>Uses <package
+	      role="port">devel/gettext-tools</package>.  By default,
+	    with no argument, or with the <literal>build</literal>
+	    argument, a build time dependency on
+	    <filename>msgfmt</filename> is registered.  With the
+	    <literal>run</literal> argument, a run-time dependency is
+	    registered.</entry>
 	</row>
 
 	<row xml:id="uses-gmake">
@@ -682,7 +746,8 @@ GSSAPI_NONE_CONFIGURE_ON=	--without-gssa
 
 	      <listitem>
 		<para>Handle cross-referencing kernel modules upon
-		  installation and deinstallation.</para>
+		  installation and deinstallation, using <link
+		    linkend="plist-keywords-kld"><literal>@kld</literal></link>.</para>
 	      </listitem>
 	    </itemizedlist></entry>
 	</row>
@@ -891,12 +956,8 @@ GSSAPI_NONE_CONFIGURE_ON=	--without-gssa
 		  <filename>Makefile.PL</filename>,
 		  <filename>Build.PL</filename>, or the
 		  Module::Build::Tiny flavor of
-		  <filename>Build.PL</filename> is required.  If there
-		  is a <filename>.packlist</filename> referencing
-		  <varname>${STAGEDIR}</varname>, then
-		  <literal>fixpacklist</literal> must be used to
-		  patch it.  It defaults to
-		  <literal>build run</literal>.</para>
+		  <filename>Build.PL</filename> is required.  It
+		  defaults to <literal>build run</literal>.</para>
 	      </listitem>
 	    </itemizedlist></entry>
 	</row>
@@ -1026,10 +1087,9 @@ GSSAPI_NONE_CONFIGURE_ON=	--without-gssa
 	    from <package role="port">misc/shared-mime-info</package>.
 	    This uses will automatically add a post-install step in
 	    such a way that the port itself still can specify there
-	    own post-install step if needed.  It also insert lines
-	    into the plist for package install and removal to run
-	    <application>update-mime-data</application> with the
-	    correct arguments.</entry>
+	    own post-install step if needed.  It also add an <link
+	      linkend="plist-keywords-shared-mime-info"><literal>@shared-mime-info</literal></link>
+	    entry to the plist.</entry>
 	</row>
 
 	<row xml:id="uses-shebangfix">
@@ -1044,6 +1104,7 @@ GSSAPI_NONE_CONFIGURE_ON=	--without-gssa
 	    in scripts listed in <varname>SHEBANG_FILES</varname>.
 	    Currently <application>Bash</application>,
 	    <application>Java</application>,
+	    <application>Ksh</application>,
 	    <application>Perl</application>,
 	    <application>PHP</application>,
 	    <application>Python</application>,
@@ -1298,6 +1359,16 @@ GSSAPI_NONE_CONFIGURE_ON=	--without-gssa
 	    </itemizedlist></entry>
 	</row>
 
+	<row xml:id="uses-xfce">
+	  <entry><literal>xfce</literal></entry>
+
+	  <entry>(none), <literal>gtk3</literal></entry>
+
+	  <entry>Provide support for <application>Xfce</application>
+	    related ports.  See <xref linkend="using-xfce"/> for
+	    details.</entry>
+	</row>
+
 	<row xml:id="uses-zip">
 	  <entry><literal>zip</literal></entry>