Date: Tue, 29 Oct 2013 02:03:09 +0000 (UTC) From: Warren Block <wblock@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43069 - head/en_US.ISO8859-1/books/porters-handbook Message-ID: <201310290203.r9T239x5038774@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201310290203.r9T239x5038774>