Date: Fri, 26 Apr 2013 06:20:01 GMT From: Jason Helfman <jgh@FreeBSD.org> To: freebsd-doc@FreeBSD.org Subject: Re: docs/178169: [patch][porters-handbook] update documentation for using gettext Message-ID: <201304260620.r3Q6K17B006974@freefall.freebsd.org>
index | next in thread | raw e-mail
The following reply was made to PR docs/178169; it has been noted by GNATS. From: Jason Helfman <jgh@FreeBSD.org> To: bug-followup@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--help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201304260620.r3Q6K17B006974>