Whitespace-only cleanup, translators please ignore.

This commit is contained in:
Warren Block 2013-10-29 02:03:09 +00:00
parent 759de0ed29
commit 039428a360
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=43069
2 changed files with 57 additions and 50 deletions
en_US.ISO8859-1/books/porters-handbook

View file

@ -632,8 +632,9 @@ PLIST_DIRS= lib/X11/oneko</programlisting>
</note> </note>
<para>Now that you understand what goes on when the user types <para>Now that you understand what goes on when the user types
<command>make <maketarget>install</maketarget></command>, let us go through the recommended <command>make <maketarget>install</maketarget></command>, let
steps to create the perfect port.</para> us go through the recommended steps to create the perfect
port.</para>
</sect1> </sect1>
<sect1 id="slow-sources"> <sect1 id="slow-sources">
@ -810,12 +811,11 @@ PLIST_DIRS= lib/X11/oneko</programlisting>
<programlisting>post-patch: <programlisting>post-patch:
@${REINPLACE_CMD} -e 's|for Linux|for FreeBSD|g' ${WRKSRC}/README</programlisting> @${REINPLACE_CMD} -e 's|for Linux|for FreeBSD|g' ${WRKSRC}/README</programlisting>
<para>Quite often, software being <para>Quite often, software being ported uses the CR/LF
ported convention for its source files. This may cause problems with
uses the CR/LF convention for its source files. This further patching, compiler warnings, scripts execution (e.g.,
may cause problems with further patching, compiler warnings, <command>/bin/sh^M</command> not found.) To quickly convert
scripts execution (e.g., <command>/bin/sh^M</command> not found.) all files from CR/LF to just LF, add
To quickly convert all files from CR/LF to just LF, add
<literal>USE_DOS2UNIX=yes</literal> to the port <literal>USE_DOS2UNIX=yes</literal> to the port
<filename>Makefile</filename>. A list of files to convert can <filename>Makefile</filename>. A list of files to convert can
be specified:</para> be specified:</para>
@ -3837,9 +3837,9 @@ ALWAYS_KEEP_DISTFILES= yes
<programlisting>USE_GCC=X.Y</programlisting> <programlisting>USE_GCC=X.Y</programlisting>
<para>(where X.Y is version number) would add a dependency on <para>(where X.Y is version number) would add a dependency
gccXY for every port, including <literal>lang/gccXY</literal> on gccXY for every port, including
itself!</para> <literal>lang/gccXY</literal> itself!</para>
</note> </note>
<table frame="none"> <table frame="none">
@ -3870,22 +3870,24 @@ ALWAYS_KEEP_DISTFILES= yes
<row> <row>
<entry><makevar>USE_GCC</makevar></entry> <entry><makevar>USE_GCC</makevar></entry>
<entry>The port requires GCC (<command>gcc</command> or <entry>The port requires GCC (<command>gcc</command>
<command>g++</command>) to build. Some ports need any or <command>g++</command>) to build. Some ports
GCC version, some require modern, recent versions. It need any GCC version, some require modern, recent
is typically set to <literal>any</literal> (in this versions. It is typically set to
case, GCC from base would be used on versions of &os; <literal>any</literal> (in this case, GCC from base
that still have it, or <literal>lang/gcc</literal> port would be used on versions of &os; that still have
would be installed when default C/C++ compiler is Clang); it, or <literal>lang/gcc</literal> port would be
or <literal>yes</literal> (means always use stable, modern installed when default C/C++ compiler is Clang); or
GCC from <literal>lang/gcc</literal> port). The exact <literal>yes</literal> (means always use stable,
version can be also specified, with a value such as modern GCC from <literal>lang/gcc</literal> port).
<literal>4.7</literal>. The minimal required The exact version can be also specified, with a
version can be specified as <literal>4.6+</literal>. value such as <literal>4.7</literal>. The minimal
The GCC from the base system is used when it satisfies required version can be specified as
the requested version, otherwise an appropriate compiler <literal>4.6+</literal>. The GCC from the base
in built from the port, and the <makevar>CC</makevar> system is used when it satisfies the requested
and <makevar>CXX</makevar> variables are adjusted version, otherwise an appropriate compiler in built
from the port, and the <makevar>CC</makevar> and
<makevar>CXX</makevar> variables are adjusted
accordingly.</entry> accordingly.</entry>
</row> </row>
</tbody> </tbody>
@ -4140,6 +4142,7 @@ MASTERDIR= ${.CURDIR}/../xdvi300
<sect1 id="makefile-manpages"> <sect1 id="makefile-manpages">
<title>Man Pages</title> <title>Man Pages</title>
<para>If your port anchors its man tree somewhere other than <para>If your port anchors its man tree somewhere other than
<makevar>PREFIX</makevar>, you can use the <makevar>PREFIX</makevar>, you can use the
<makevar>MANPREFIX</makevar> to set it. Also, if only <makevar>MANPREFIX</makevar> to set it. Also, if only
@ -5122,9 +5125,10 @@ PORTVERSION= 1.0</programlisting>
the same time, you can use the whole the same time, you can use the whole
<makevar>PKGNAME</makevar>.</para> <makevar>PKGNAME</makevar>.</para>
<para>Since only the files listed in <filename>pkg-plist</filename> <para>Since only the files listed in
are installed it is safe to always install <filename>pkg-plist</filename> are installed it is safe to
documentation to <makevar>STAGEDIR</makevar>.</para> always install documentation to
<makevar>STAGEDIR</makevar>.</para>
<programlisting>post-install: <programlisting>post-install:
${MKDIR} ${STAGEDIR}${DOCSDIR} ${MKDIR} ${STAGEDIR}${DOCSDIR}
@ -11525,17 +11529,17 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
<title>Differentiating Operating Systems and OS Versions</title> <title>Differentiating Operating Systems and OS Versions</title>
<para>You may come across code that needs modifications or <para>You may come across code that needs modifications or
conditional compilation based upon what version of &os; Unix it is conditional compilation based upon what version of &os; Unix
running under. The preferred way to tell &os; versions apart it is running under. The preferred way to tell &os; versions
are the <literal>__FreeBSD_version</literal> and apart are the <literal>__FreeBSD_version</literal> and
<literal>__FreeBSD__</literal> <literal>__FreeBSD__</literal> macros defined in <ulink
macros defined in <ulink
url="http://svnweb.freebsd.org/base/head/sys/sys/param.h?view=markup">sys/param.h</ulink>. url="http://svnweb.freebsd.org/base/head/sys/sys/param.h?view=markup">sys/param.h</ulink>.
If this file is not included add the code,</para> If this file is not included add the code,</para>
<programlisting>#include &lt;sys/param.h&gt;</programlisting> <programlisting>#include &lt;sys/param.h&gt;</programlisting>
<para>to the proper place in the <filename>.c</filename> file.</para> <para>to the proper place in the <filename>.c</filename>
file.</para>
<para><literal>__FreeBSD__</literal> is defined in all <para><literal>__FreeBSD__</literal> is defined in all
versions of &os; as their major version number. For versions of &os; as their major version number. For

View file

@ -108,15 +108,18 @@
<entry><literal>iconv</literal></entry> <entry><literal>iconv</literal></entry>
<entry>(none), <literal>lib</literal>, <literal>build</literal>, <entry>(none), <literal>lib</literal>, <literal>build</literal>,
<literal>patch</literal></entry> <literal>patch</literal></entry>
<entry>Implies that the port uses <command>iconv</command> functions, either from the port
<filename role="package">converters/libiconv</filename> as <entry>Implies that the port uses <command>iconv</command>
a build-time and run-time dependency, or from the base system on functions, either from the port
<filename role="package">converters/libiconv</filename> as a
build-time and run-time dependency, or from the base system on
10-CURRENT after a native <command>iconv</command> was committed 10-CURRENT after a native <command>iconv</command> was committed
in <svnref>254273</svnref>. By default, with no arguments or with the in <svnref>254273</svnref>. By default, with no arguments or with
<literal>lib</literal> argument, implies <command>iconv</command> the <literal>lib</literal> argument, implies
with build-time and run-time dependencies, <literal>build</literal> <command>iconv</command> with build-time and run-time
implies a build-time dependency, and <literal>patch</literal> dependencies, <literal>build</literal> implies a build-time
implies a patch-time dependency. For more information see dependency, and <literal>patch</literal> implies a patch-time
dependency. For more information see
<xref linkend="using-iconv"/>.</entry> <xref linkend="using-iconv"/>.</entry>
</row> </row>
@ -131,12 +134,12 @@
<row> <row>
<entry><literal>motif</literal></entry> <entry><literal>motif</literal></entry>
<entry>(none)</entry> <entry>(none)</entry>
<entry>Implies that the ports uses <filename <entry>Implies that the ports uses
role="package">devel/open-motif</filename> as a library <filename role="package">devel/open-motif</filename> as a library
dependency. End users can set <makevar>WANT_LESSTIF</makevar> dependency. End users can set <makevar>WANT_LESSTIF</makevar>
for the dependency to be on <filename for the dependency to be on
role="package">devel/lesstif</filename> instead of <filename <filename role="package">devel/lesstif</filename> instead of
role="package">devel/open-motif</filename>.</entry> <filename role="package">devel/open-motif</filename>.</entry>
</row> </row>
<row> <row>