From owner-svn-doc-all@FreeBSD.ORG Sat Jul 20 01:28:58 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 63622BD0; Sat, 20 Jul 2013 01:28:58 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 53E0AB29; Sat, 20 Jul 2013 01:28:58 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6K1Sw8T037915; Sat, 20 Jul 2013 01:28:58 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6K1SwNn037914; Sat, 20 Jul 2013 01:28:58 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307200128.r6K1SwNn037914@svn.freebsd.org> From: Warren Block Date: Sat, 20 Jul 2013 01:28:58 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42329 - head/en_US.ISO8859-1/books/fdp-primer/doc-build 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.14 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: Sat, 20 Jul 2013 01:28:58 -0000 Author: wblock Date: Sat Jul 20 01:28:57 2013 New Revision: 42329 URL: http://svnweb.freebsd.org/changeset/doc/42329 Log: Whitespace-only fixes. Translators, please ignore. Modified: head/en_US.ISO8859-1/books/fdp-primer/doc-build/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/doc-build/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/doc-build/chapter.xml Sat Jul 20 01:21:45 2013 (r42328) +++ head/en_US.ISO8859-1/books/fdp-primer/doc-build/chapter.xml Sat Jul 20 01:28:57 2013 (r42329) @@ -34,20 +34,18 @@ The Documentation Build Process - This chapter covers organization of the - documentation build process - and how &man.make.1; is used to control - it. + This chapter covers organization of the documentation build + process and how &man.make.1; is used to control it. The &os; Documentation Build Toolset - These are the tools used to build and install the FDP documentation. + These are the tools used to build and install the + FDP documentation. - The primary build tool is - &man.make.1;, specifically + The primary build tool is &man.make.1;, specifically Berkeley Make. @@ -57,16 +55,14 @@ - &man.gzip.1; is used to create - compressed versions of the document. - &man.bzip2.1; archives are also supported. - &man.tar.1; is used for package - building. + &man.gzip.1; is used to create compressed versions of + the document. &man.bzip2.1; archives are also supported. + &man.tar.1; is used for package building. - &man.install.1; is used - to install the documentation. + &man.install.1; is used to install the + documentation. @@ -116,10 +112,10 @@ COMPAT_SYMLINK = en DOC_PREFIX?= ${.CURDIR}/.. .include "${DOC_PREFIX}/share/mk/doc.project.mk" - The first four non-empty lines define - the &man.make.1; variables - SUBDIR, COMPAT_SYMLINK, - and DOC_PREFIX. + The first four non-empty lines define the &man.make.1; + variables SUBDIR, + COMPAT_SYMLINK, and + DOC_PREFIX. The SUBDIR statement and COMPAT_SYMLINK statement show how to @@ -148,24 +144,24 @@ DOC_PREFIX?= ${.CURDIR}/.. point to en_US.ISO-8859-1). DOC_PREFIX is the path to the root of - the &os; Document Project tree. This is not always that - easy to find, and is also easily overridden, to allow for - flexibility. .CURDIR is a - &man.make.1; builtin variable with the path - to the current directory. - - The final line includes the &os; Documentation - Project's project-wide &man.make.1; system - file doc.project.mk which is the glue - which converts these variables into build instructions. + the &os; Document Project tree. This is not always that easy + to find, and is also easily overridden, to allow for + flexibility. .CURDIR is a &man.make.1; + builtin variable with the path to the current + directory. + + The final line includes the &os; Documentation Project's + project-wide &man.make.1; system file + doc.project.mk which is the glue which + converts these variables into build instructions. Documentation <filename>Makefile</filename>s - These Makefiles set - &man.make.1; variables that describe how to - build the documentation contained in that directory. + These Makefiles set &man.make.1; + variables that describe how to build the documentation + contained in that directory. Here is an example: @@ -185,10 +181,9 @@ DOC_PREFIX?= ${.CURDIR}/../../.. .include "$(DOC_PREFIX)/share/mk/docproj.docbook.mk" - The MAINTAINER variable - allows committers to claim - ownership of a document in the &os; Documentation - Project, and take responsibility for maintaining + The MAINTAINER variable allows + committers to claim ownership of a document in the &os; + Documentation Project, and take responsibility for maintaining it. DOC is the name (sans the @@ -215,8 +210,8 @@ DOC_PREFIX?= ${.CURDIR}/../../.. &os; Documentation Project <application>Make</application> Includes - &man.make.1; includes are best explained by inspection of the code. Here are - the system include files: + &man.make.1; includes are best explained by inspection of + the code. Here are the system include files: @@ -293,11 +288,10 @@ PRI_LANG?= en_US.ISO8859-1 Conditionals The .if defined(DOC) line is an - example of a &man.make.1; conditional - which, like in other programs, defines behavior if some - condition is true or if it is false. - defined is a function which returns - whether the variable given is defined or not. + example of a &man.make.1; conditional which, like in other + programs, defines behavior if some condition is true or if + it is false. defined is a function which + returns whether the variable given is defined or not. .if ${DOCFORMAT} == "docbook", next, tests whether the DOCFORMAT variable is @@ -312,8 +306,8 @@ PRI_LANG?= en_US.ISO8859-1 <filename>doc.subdir.mk</filename> - This file is too long to explain in detail. These - notes describe the most important features. + This file is too long to explain in detail. These notes + describe the most important features. Variables