From owner-svn-doc-all@freebsd.org Thu Dec 17 01:52:35 2015 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 16818A49012; Thu, 17 Dec 2015 01:52:35 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id E23D11938; Thu, 17 Dec 2015 01:52:34 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id tBH1qYJS061346; Thu, 17 Dec 2015 01:52:34 GMT (envelope-from wblock@FreeBSD.org) Received: (from wblock@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id tBH1qYFg061345; Thu, 17 Dec 2015 01:52:34 GMT (envelope-from wblock@FreeBSD.org) Message-Id: <201512170152.tBH1qYFg061345@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: wblock set sender to wblock@FreeBSD.org using -f From: Warren Block Date: Thu, 17 Dec 2015 01:52:33 +0000 (UTC) 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 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 17 Dec 2015 01:52:35 -0000 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 @@ ARCH - The architecture as returned by uname - -m (for example, i386) + The architecture as returned by + uname -m (for example, + i386) @@ -159,8 +160,8 @@ LOCALBASE - The base of the local tree (for example, - /usr/local) + The base of the local tree (for + example, /usr/local) @@ -216,9 +217,9 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD Do Things Rationally The Makefile 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 - .if 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 .if construct instead of a shell if construct, not redefining do-extract if redefining EXTRACT* is enough, and using @@ -228,10 +229,10 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD If a lot of new code is needed to do something, there may already be an implementation of it in - bsd.port.mk. While - hard to read, there are a great many seemingly-hard problems for - which bsd.port.mk already provides a - shorthand solution. + bsd.port.mk. While hard to read, there are + a great many seemingly-hard problems for which + bsd.port.mk already provides a shorthand + solution. @@ -250,9 +251,9 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD NO_PACKAGE=ignores either cc or cxx to the Makefile. - Here is an example of a Makefile respecting - both CC and CXX. - Note the ?=: + Here is an example of a Makefile + respecting both CC and + CXX. Note the ?=: CC?= gcc @@ -288,8 +289,8 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD NO_PACKAGE=ignores cflags to the Makefile. - Here is an example of a Makefile respecting - CFLAGS. Note the + Here is an example of a Makefile + respecting CFLAGS. Note the +=: CFLAGS+= -Wall -Werror @@ -421,19 +422,18 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD FORBIDDEN 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 FORBIDDEN as soon as a + installed (for example, a reputably insecure program or a + program that provides easily exploitable services). Mark + ports as FORBIDDEN 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 - FORBIDDEN for any reason other than - security. + 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 FORBIDDEN + for any reason other than security. @@ -684,10 +684,10 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD xlink:href="https://wiki.ubuntu.com/DashAsBinSh">here. Check that headers are included in the - POSIX or man page recommended way. For example, - sys/types.h is often forgotten, which is - not as much of a problem for &linux; as it is for &os;. - + POSIX or man page recommended way. For + example, sys/types.h is often forgotten, + which is not as much of a problem for &linux; as it is for + &os;.