svn commit: r45661 - in head/en_US.ISO8859-1/books/porters-handbook: special uses

[Mathieu Arnold]

Author: mat (ports committer)
Date: Tue Sep 23 14:43:14 2014
New Revision: 45661
URL: http://svnweb.freebsd.org/changeset/doc/45661

Log:
  Document USES=pear.
  
  Sponsored by:	Absolight

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

Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Tue Sep 23 14:42:34 2014	(r45660)
+++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Tue Sep 23 14:43:14 2014	(r45661)
@@ -2655,18 +2655,11 @@ do-install:
 
       <para>Porting PEAR modules is a very simple process.</para>
 
-      <para>Use the variables <varname>FILES</varname>,
-	<varname>TESTS</varname>, <varname>DATA</varname>,
-	<varname>SQLS</varname>, <varname>SCRIPTFILES</varname>,
-	<varname>DOCS</varname> and <varname>EXAMPLES</varname> to
-	list the files to install.  All listed files will
-	be automatically installed into the appropriate locations
-	and added to <filename>pkg-plist</filename>.</para>
-
-      <para>Include
-	<filename>${PORTSDIR}/devel/pear/bsd.pear.mk</filename>
-	on the last line of the
-	<filename>Makefile</filename>.</para>
+      <para>Add <literal>USES=pear</literal> to the port's
+	<filename>Makefile</filename>.  The framework will then
+	automatically install the relevant files at the right place,
+	it will also automatically generate the plist at install
+	time.</para>
 
       <example xml:id="pear-makefile">
 	<title>Example Makefile for PEAR Class</title>
@@ -2678,23 +2671,9 @@ CATEGORIES=	devel www pear
 MAINTAINER=	example at domain.com
 COMMENT=	PEAR Date and Time Zone Classes
 
-BUILD_DEPENDS=	${PEARDIR}/PEAR.php:${PORTSDIR}/devel/pear-PEAR
-RUN_DEPENDS:=	${BUILD_DEPENDS}
+USES=	pear
 
-FILES=		Date.php Date/Calc.php Date/Human.php Date/Span.php     \
-		Date/TimeZone.php
-TESTS=		test_calc.php test_date_methods_span.php testunit.php   \
-		testunit_date.php testunit_date_span.php wknotest.txt   \
-		bug674.php bug727_1.php bug727_2.php bug727_3.php       \
-		bug727_4.php bug967.php weeksinmonth_4_monday.txt       \
-		weeksinmonth_4_sunday.txt weeksinmonth_rdm_monday.txt   \
-		weeksinmonth_rdm_sunday.txt
-DOCS=		TODO
-_DOCSDIR=	.
-
-.include <bsd.port.pre.mk>
-.include "${PORTSDIR}/devel/pear/bsd.pear.mk"
-.include <bsd.port.post.mk></programlisting>
+.include <bsd.port.mk></programlisting>
       </example>
     </sect2>
   </sect1>

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Tue Sep 23 14:42:34 2014	(r45660)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Tue Sep 23 14:43:14 2014	(r45661)
@@ -810,6 +810,19 @@ GSSAPI_NONE_CONFIGURE_ON=	--without-gssa
 	    <filename>Makefile.am</filename> if needed.</entry>
 	</row>
 
+	<row xml:id="uses-pear">
+	  <entry><literal>pear</literal></entry>
+
+	  <entry>(none)</entry>
+
+	  <entry>Adds a dependency on <package
+	      role="port">devel/pear</package>.  It will setup default
+	    behavior for software using the
+	    <application>PHP</application> Extension and Application
+	    Repository.  See <xref linkend="php-pear"/> for more
+	    informations.</entry>
+	</row>
+
 	<row xml:id="uses-perl5">
 	  <entry><literal>perl5</literal></entry>