Date: Thu, 17 Dec 2015 01:52:33 +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: r47878 - head/en_US.ISO8859-1/books/porters-handbook/porting-dads Message-ID: <201512170152.tBH1qYFg061345@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: wblock Date: Thu Dec 17 01:52:33 2015 New Revision: 47878 URL: https://svnweb.freebsd.org/changeset/doc/47878 Log: Whitespace-only fixes, translators please ignore. Modified: head/en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml Thu Dec 17 01:46:51 2015 (r47877) +++ head/en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml Thu Dec 17 01:52:33 2015 (r47878) @@ -132,8 +132,9 @@ <tbody> <row> <entry><varname>ARCH</varname></entry> - <entry>The architecture as returned by <command>uname - -m</command> (for example, <literal>i386</literal>)</entry> + <entry>The architecture as returned by + <command>uname -m</command> (for example, + <literal>i386</literal>)</entry> </row> <row> @@ -159,8 +160,8 @@ <row> <entry><varname>LOCALBASE</varname></entry> - <entry>The base of the <quote>local</quote> tree (for example, - <literal>/usr/local</literal>)</entry> + <entry>The base of the <quote>local</quote> tree (for + example, <literal>/usr/local</literal>)</entry> </row> <row> @@ -216,9 +217,9 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD <title>Do Things Rationally</title> <para>The <filename>Makefile</filename> should do things in a - simple and reasonable manner. Making it a couple of lines shorter or - more readable is always better. Examples include using a make - <literal>.if</literal> construct instead of a shell + simple and reasonable manner. Making it a couple of lines + shorter or more readable is always better. Examples include + using a make <literal>.if</literal> construct instead of a shell <literal>if</literal> construct, not redefining <buildtarget>do-extract</buildtarget> if redefining <varname>EXTRACT*</varname> is enough, and using @@ -228,10 +229,10 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD <para>If a lot of new code is needed to do something, there may already be an implementation of it in - <filename>bsd.port.mk</filename>. While - hard to read, there are a great many seemingly-hard problems for - which <filename>bsd.port.mk</filename> already provides a - shorthand solution.</para> + <filename>bsd.port.mk</filename>. While hard to read, there are + a great many seemingly-hard problems for which + <filename>bsd.port.mk</filename> already provides a shorthand + solution.</para> </sect1> <sect1 xml:id="dads-cc"> @@ -250,9 +251,9 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD <literal>NO_PACKAGE=ignores either cc or cxx</literal> to the <filename>Makefile</filename>.</para> - <para>Here is an example of a <filename>Makefile</filename> respecting - both <varname>CC</varname> and <varname>CXX</varname>. - Note the <literal>?=</literal>:</para> + <para>Here is an example of a <filename>Makefile</filename> + respecting both <varname>CC</varname> and + <varname>CXX</varname>. Note the <literal>?=</literal>:</para> <programlisting>CC?= gcc</programlisting> @@ -288,8 +289,8 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD <literal>NO_PACKAGE=ignores cflags</literal> to the <filename>Makefile</filename>.</para> - <para>Here is an example of a <filename>Makefile</filename> respecting - <varname>CFLAGS</varname>. Note the + <para>Here is an example of a <filename>Makefile</filename> + respecting <varname>CFLAGS</varname>. Note the <literal>+=</literal>:</para> <programlisting>CFLAGS+= -Wall -Werror</programlisting> @@ -421,19 +422,18 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD <para><varname>FORBIDDEN</varname> is used for ports that contain a security vulnerability or induce grave concern regarding the security of a &os; system with a given port - installed (for example, a reputably insecure program or a program - that provides easily exploitable services). Mark ports - as <varname>FORBIDDEN</varname> as soon as a + installed (for example, a reputably insecure program or a + program that provides easily exploitable services). Mark + ports as <varname>FORBIDDEN</varname> as soon as a particular piece of software has a vulnerability and there - is no released upgrade. Ideally upgrade ports - as soon as possible when a security vulnerability is - discovered so as to reduce the number of vulnerable &os; - hosts (we like being known for being secure), however - sometimes there is a noticeable time gap between - disclosure of a vulnerability and an updated release of - the vulnerable software. Do not mark a port - <varname>FORBIDDEN</varname> for any reason other than - security.</para> + is no released upgrade. Ideally upgrade ports as soon as + possible when a security vulnerability is discovered so as + to reduce the number of vulnerable &os; hosts (we like + being known for being secure), however sometimes there is + a noticeable time gap between disclosure of a + vulnerability and an updated release of the vulnerable + software. Do not mark a port <varname>FORBIDDEN</varname> + for any reason other than security.</para> </listitem> <listitem> @@ -684,10 +684,10 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD xlink:href="https://wiki.ubuntu.com/DashAsBinSh">here</link>.</para>; <para>Check that headers are included in the - <acronym>POSIX</acronym> or man page recommended way. For example, - <filename>sys/types.h</filename> is often forgotten, which is - not as much of a problem for &linux; as it is for &os;.</para> - + <acronym>POSIX</acronym> or man page recommended way. For + example, <filename>sys/types.h</filename> is often forgotten, + which is not as much of a problem for &linux; as it is for + &os;.</para> </sect1> <sect1 xml:id="dads-misc">
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201512170152.tBH1qYFg061345>