os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Whitespace-only cleanup, translators please ignore.

Browse source
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
book.xmluses.xml

76
en_US.ISO8859-1/books/porters-handbook/book.xml
View file

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

31
en_US.ISO8859-1/books/porters-handbook/uses.xml
View file

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