From owner-svn-doc-head@FreeBSD.ORG Tue Oct 29 02:03:10 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 711318F7; Tue, 29 Oct 2013 02:03:10 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 5D9B12F88; Tue, 29 Oct 2013 02:03:10 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r9T23Abo038779; Tue, 29 Oct 2013 02:03:10 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r9T239x5038774; Tue, 29 Oct 2013 02:03:09 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201310290203.r9T239x5038774@svn.freebsd.org> From: Warren Block Date: Tue, 29 Oct 2013 02:03:09 +0000 (UTC) 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 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 29 Oct 2013 02:03:10 -0000 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 Now that you understand what goes on when the user types - make install, let us go through the recommended - steps to create the perfect port. + make install, let + us go through the recommended steps to create the perfect + port. @@ -810,12 +811,11 @@ PLIST_DIRS= lib/X11/onekopost-patch: @${REINPLACE_CMD} -e 's|for Linux|for FreeBSD|g' ${WRKSRC}/README - 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., /bin/sh^M not found.) - To quickly convert all files from CR/LF to just LF, add + 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., + /bin/sh^M not found.) To quickly convert + all files from CR/LF to just LF, add USE_DOS2UNIX=yes to the port Makefile. A list of files to convert can be specified: @@ -3837,9 +3837,9 @@ ALWAYS_KEEP_DISTFILES= yes USE_GCC=X.Y - (where X.Y is version number) would add a dependency on - gccXY for every port, including lang/gccXY - itself! + (where X.Y is version number) would add a dependency + on gccXY for every port, including + lang/gccXY itself! @@ -3870,22 +3870,24 @@ ALWAYS_KEEP_DISTFILES= yes USE_GCC - The port requires GCC (gcc or - g++) to build. Some ports need any - GCC version, some require modern, recent versions. It - is typically set to any (in this - case, GCC from base would be used on versions of &os; - that still have it, or lang/gcc port - would be installed when default C/C++ compiler is Clang); - or yes (means always use stable, modern - GCC from lang/gcc port). The exact - version can be also specified, with a value such as - 4.7. The minimal required - version can be specified as 4.6+. - 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 CC - and CXX variables are adjusted + The port requires GCC (gcc + or g++) to build. Some ports + need any GCC version, some require modern, recent + versions. It is typically set to + any (in this case, GCC from base + would be used on versions of &os; that still have + it, or lang/gcc port would be + installed when default C/C++ compiler is Clang); or + yes (means always use stable, + modern GCC from lang/gcc port). + The exact version can be also specified, with a + value such as 4.7. The minimal + required version can be specified as + 4.6+. 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 CC and + CXX variables are adjusted accordingly. @@ -4140,6 +4142,7 @@ MASTERDIR= ${.CURDIR}/../xdvi300 Man Pages + If your port anchors its man tree somewhere other than PREFIX, you can use the MANPREFIX to set it. Also, if only @@ -5122,9 +5125,10 @@ PORTVERSION= 1.0 the same time, you can use the whole PKGNAME. - Since only the files listed in pkg-plist - are installed it is safe to always install - documentation to STAGEDIR. + Since only the files listed in + pkg-plist are installed it is safe to + always install documentation to + STAGEDIR. post-install: ${MKDIR} ${STAGEDIR}${DOCSDIR} @@ -11525,17 +11529,17 @@ Reference: <http://www.freebsd.org/po Differentiating Operating Systems and OS Versions 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 __FreeBSD_version and - __FreeBSD__ - macros defined in __FreeBSD_version and + __FreeBSD__ macros defined in sys/param.h. If this file is not included add the code, #include <sys/param.h> - to the proper place in the .c file. + to the proper place in the .c + file. __FreeBSD__ 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 @@ iconv (none), lib, build, patch - Implies that the port uses iconv functions, either from the port - converters/libiconv as - a build-time and run-time dependency, or from the base system on + + Implies that the port uses iconv + functions, either from the port + converters/libiconv as a + build-time and run-time dependency, or from the base system on 10-CURRENT after a native iconv was committed - in 254273. By default, with no arguments or with the - lib argument, implies iconv - with build-time and run-time dependencies, build - implies a build-time dependency, and patch - implies a patch-time dependency. For more information see + in 254273. By default, with no arguments or with + the lib argument, implies + iconv with build-time and run-time + dependencies, build implies a build-time + dependency, and patch implies a patch-time + dependency. For more information see . @@ -131,12 +134,12 @@ motif (none) - Implies that the ports uses devel/open-motif as a library - dependency. End users can set WANT_LESSTIF - for the dependency to be on devel/lesstif instead of devel/open-motif. + Implies that the ports uses + devel/open-motif as a library + dependency. End users can set WANT_LESSTIF + for the dependency to be on + devel/lesstif instead of + devel/open-motif.