From owner-svn-doc-head@FreeBSD.ORG  Wed Mar  6 19:10:50 2013
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])
 by hub.freebsd.org (Postfix) with ESMTP id 5D382886;
 Wed,  6 Mar 2013 19:10:50 +0000 (UTC) (envelope-from pgj@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org
 [IPv6:2001:1900:2254:2068::e6a:0])
 by mx1.freebsd.org (Postfix) with ESMTP id 4F59CFA3;
 Wed,  6 Mar 2013 19:10:50 +0000 (UTC)
Received: from svn.freebsd.org ([127.0.1.70])
 by svn.freebsd.org (8.14.6/8.14.6) with ESMTP id r26JAo4X037076;
 Wed, 6 Mar 2013 19:10:50 GMT (envelope-from pgj@svn.freebsd.org)
Received: (from pgj@localhost)
 by svn.freebsd.org (8.14.6/8.14.5/Submit) id r26JAnUN037073;
 Wed, 6 Mar 2013 19:10:49 GMT (envelope-from pgj@svn.freebsd.org)
Message-Id: <201303061910.r26JAnUN037073@svn.freebsd.org>
From: Gabor Pali <pgj@FreeBSD.org>
Date: Wed, 6 Mar 2013 19:10:49 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
 svn-doc-head@freebsd.org
Subject: svn commit: r41112 - head/en_US.ISO8859-1/books/porters-handbook
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.14
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: Wed, 06 Mar 2013 19:10:50 -0000

Author: pgj
Date: Wed Mar  6 19:10:49 2013
New Revision: 41112
URL: http://svnweb.freebsd.org/changeset/doc/41112

Log:
  - Add documentation for USES (and its potential values).  Note that now it
    comes with a separate file that could be easily expanded by ports people.
  
  Requested by:	bapt

Added:
  head/en_US.ISO8859-1/books/porters-handbook/uses.xml   (contents, props changed)
Modified:
  head/en_US.ISO8859-1/books/porters-handbook/Makefile
  head/en_US.ISO8859-1/books/porters-handbook/book.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/Makefile
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/Makefile	Wed Mar  6 18:12:47 2013	(r41111)
+++ head/en_US.ISO8859-1/books/porters-handbook/Makefile	Wed Mar  6 19:10:49 2013	(r41112)
@@ -20,6 +20,7 @@ INSTALL_ONLY_COMPRESSED?=
 
 # XML content
 SRCS=  book.xml
+SRCS+= uses.xml
 
 # Use the local DSSSL file
 DSLHTML?= 	${.CURDIR}/freebsd.dsl

Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/book.xml	Wed Mar  6 18:12:47 2013	(r41111)
+++ head/en_US.ISO8859-1/books/porters-handbook/book.xml	Wed Mar  6 19:10:49 2013	(r41112)
@@ -3,7 +3,6 @@
 	"../../../share/xml/freebsd42.dtd" [
 <!ENTITY % entities PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Entity Set//EN" "../../share/xml/entities.ent">
 %entities;
-]>
 
 <!--
      The FreeBSD Documentation Project
@@ -11,6 +10,9 @@
      $FreeBSD$
 -->
 
+<!ENTITY values.uses SYSTEM "uses.xml">
+]>
+
 <book lang='en'>
   <bookinfo>
     <title>FreeBSD Porter's Handbook</title>
@@ -3793,6 +3795,20 @@ ALWAYS_KEEP_DISTFILES=	yes
 	  is the same as <makevar>DEPENDS_TARGET</makevar>.</para>
       </sect2>
 
+      <sect2 id="uses">
+	<title><makevar>USES</makevar></title>
+
+	<para>There several parameters exist for defining different kind
+	  of features and dependencies that the port in question uses.
+	  They can be specified by adding the following line to the
+	  <filename>Makefile</filename> of the port:</para>
+
+	<programlisting>USES= feature[:arguments]</programlisting>
+
+	<para>For the complete list of such values, please see <xref
+	    linkend="uses-values"/>.</para>
+      </sect2>
+
       <sect2 id="use-vars">
 	<title><makevar>USE_<replaceable>*</replaceable></makevar></title>
 
@@ -16861,4 +16877,29 @@ pre-install:
 	about creating has already been submitted.</para>
     </sect1>
   </chapter>
+
+  <chapter id="appendices">
+    <title>Appendices</title>
+
+    <sect1 id="uses-values">
+      <title>Values of <makevar>USES</makevar></title>
+
+      <table frame="none">
+	<title>Values of <makevar>USES</makevar></title>
+
+	<tgroup cols="2">
+	  <thead>
+	    <row>
+	      <entry>Feature</entry>
+	      <entry>Arguments</entry>
+	      <entry>Description</entry>
+	    </row>
+	  </thead>
+	  <tbody>
+	    &values.uses;
+	  </tbody>
+	</tgroup>
+      </table>
+    </sect1>
+  </chapter>
 </book>

Added: head/en_US.ISO8859-1/books/porters-handbook/uses.xml
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses.xml	Wed Mar  6 19:10:49 2013	(r41112)
@@ -0,0 +1,26 @@
+<!--
+
+  The FreeBSD Documentation Project
+
+  $FreeBSD$
+
+  This file documents the values of the USES make variable.  The format is
+  easy to grasp from the already-added entries below (or use this scheme
+  below as a skeleton):
+
+<row>
+  <entry><literal>FEATURE</literal></entry>
+  <entry>ARGUMENTS</entry>
+  <entry>DESCRIPTION</entry>
+</row>
+
+-->
+
+<row>
+  <entry><literal>pathfix</literal></entry>
+  <entry>none</entry>
+  <entry>Look for the <filename>Makefile.in</filename> and
+    <filename>configure</filename> files in the port's associated
+    sources and fix common paths to make sure they respect the &os;
+    hierarchy.</entry>
+</row>