svn commit: r43069 - head/en_US.ISO8859-1/books/porters-handbook
Warren Block
wblock at FreeBSD.org
Tue Oct 29 02:03:10 UTC 2013
Author: wblock
Date: Tue Oct 29 02:03:09 2013
New Revision: 43069
URL: http://svnweb.freebsd.org/changeset/doc/43069
Log:
Whitespace-only cleanup, translators please ignore.
Modified:
head/en_US.ISO8859-1/books/porters-handbook/book.xml
head/en_US.ISO8859-1/books/porters-handbook/uses.xml
Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/book.xml Tue Oct 29 01:38:53 2013 (r43068)
+++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Tue Oct 29 02:03:09 2013 (r43069)
@@ -632,8 +632,9 @@ PLIST_DIRS= lib/X11/oneko</programlistin
</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</programlistin
<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: <http://www.freebsd.org/po
<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 <sys/param.h></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
Modified: head/en_US.ISO8859-1/books/porters-handbook/uses.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses.xml Tue Oct 29 01:38:53 2013 (r43068)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses.xml Tue Oct 29 02:03:09 2013 (r43069)
@@ -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>
More information about the svn-doc-all
mailing list