docs/178169: [patch][porters-handbook] update documentation for using gettext

[Jason Helfman]

The following reply was made to PR docs/178169; it has been noted by GNATS.

From: Jason Helfman <jgh at FreeBSD.org>
To: bug-followup at FreeBSD.org
Cc:  
Subject: Re: docs/178169: [patch][porters-handbook] update documentation for
 using gettext
Date: Thu, 25 Apr 2013 23:13:23 -0700

 --envbJBWh7q8WU6mo
 Content-Type: text/plain; charset=us-ascii; format=flowed
 Content-Disposition: inline
 
 Language correction.
 
 -jgh
 
 --
 Jason Helfman
 FreeBSD Committer | http://people.freebsd.org/~jgh | The Power To Serve
 
 --envbJBWh7q8WU6mo
 Content-Type: text/x-diff; charset=us-ascii
 Content-Disposition: attachment; filename="gettext.diff"
 
 Index: porters-handbook/book.xml
 ===================================================================
 --- porters-handbook/book.xml	(revision 41499)
 +++ porters-handbook/book.xml	(working copy)
 @@ -5781,17 +5781,12 @@
        <sect2>
  	<title>Basic Usage</title>
  
 -	<para>If your port requires <literal>gettext</literal>,
 -	  just set <makevar>USE_GETTEXT</makevar> to
 -	  <literal>yes</literal>, and your port will grow the
 -	  dependency on <filename
 -	    role="package">devel/gettext</filename>.  The value of
 -	  <makevar>USE_GETTEXT</makevar> can also specify the required
 -	  version of the <literal>libintl</literal> library, the basic
 -	  part of <literal>gettext</literal>, but using this feature
 -	  is <emphasis>strongly discouraged</emphasis>: Your port
 -	  should work with just the current version of <filename
 -	    role="package">devel/gettext</filename>.</para>
 +	<para>If your port requires <literal>gettext</literal>, just set
 +	  <literal>USES= gettext</literal>, and your
 +	  port will inherit a dependency on <filename
 +	    role="package">devel/gettext</filename>. Other values for
 +	  <literal>gettext</literal> usage are listed in <xref
 +	  linkend="uses-values"/>.</para>
  
  	<para>A rather common case is a port using
  	  <literal>gettext</literal> and <command>configure</command>.
 @@ -5802,7 +5797,7 @@
  	  <envar>CPPFLAGS</envar> and <envar>LDFLAGS</envar> as
  	  follows:</para>
  
 -	<programlisting>USE_GETTEXT=	yes
 +	<programlisting>USES=	gettext
  CPPFLAGS+=	-I${LOCALBASE}/include
  LDFLAGS+=	-L${LOCALBASE}/lib
  
 @@ -5811,7 +5806,7 @@
  	<para>Of course, the code can be more compact if there are no
  	  more flags to pass to <command>configure</command>:</para>
  
 -	<programlisting>USE_GETTEXT=	yes
 +	<programlisting>USES=	gettext
  GNU_CONFIGURE=	yes</programlisting>
        </sect2>
  
 @@ -5832,7 +5827,7 @@
  .include <bsd.port.options.mk>
  
  .if ${PORT_OPTIONS:MNLS}
 -USE_GETTEXT=		yes
 +USES+=			gettext
  PLIST_SUB+=		NLS=""
  .else
  CONFIGURE_ARGS+=	--disable-nls
 Index: porters-handbook/uses.xml
 ===================================================================
 --- porters-handbook/uses.xml	(revision 41499)
 +++ porters-handbook/uses.xml	(working copy)
 @@ -63,6 +63,19 @@
  </row>
  
  <row>
 +  <entry><literal>gettext</literal></entry>
 +  <entry>none, <literal>lib</literal>, <literal>build</literal>,
 +    <literal>run</literal></entry>
 +  <entry>Implies that the port uses <filename
 +      role="package">devel/gettext</filename> in one way or another.  By
 +    default, with no arguments or with the <literal>lib</literal>
 +    argument, implies <command>gettext</command> with build-time and 
 +    run-time dependencies, <literal>build</literal> implies a build-time
 +    dependency, and <literal>run</literal> implies a run-time
 +    dependency.</entry>
 +</row>
 +
 +<row>
    <entry><literal>pathfix</literal></entry>
    <entry>none</entry>
    <entry>Look for the <filename>Makefile.in</filename> and
 
 --envbJBWh7q8WU6mo--