Date: Sat, 20 Jul 2013 01:28:58 +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: r42329 - head/en_US.ISO8859-1/books/fdp-primer/doc-build Message-ID: <201307200128.r6K1SwNn037914@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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 @@ <chapter id="doc-build"> <title>The Documentation Build Process</title> - <para>This chapter covers organization of the - documentation build process - and how &man.make.1; is used to control - it.</para> + <para>This chapter covers organization of the documentation build + process and how &man.make.1; is used to control it.</para> <sect1 id="doc-build-toolset"> <title>The &os; Documentation Build Toolset</title> - <para>These are the tools used to build and install the <acronym>FDP</acronym> documentation.</para> + <para>These are the tools used to build and install the + <acronym>FDP</acronym> documentation.</para> <itemizedlist> <listitem> - <para>The primary build tool is - &man.make.1;, specifically + <para>The primary build tool is &man.make.1;, specifically <application>Berkeley Make</application>.</para> </listitem> @@ -57,16 +55,14 @@ </listitem> <listitem> - <para>&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.</para> + <para>&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.</para> </listitem> <listitem> - <para>&man.install.1; is used - to install the documentation.</para> + <para>&man.install.1; is used to install the + documentation.</para> </listitem> </itemizedlist> </sect1> @@ -116,10 +112,10 @@ COMPAT_SYMLINK = en DOC_PREFIX?= ${.CURDIR}/.. .include "${DOC_PREFIX}/share/mk/doc.project.mk"</programlisting> - <para>The first four non-empty lines define - the &man.make.1; variables - <makevar>SUBDIR</makevar>, <makevar>COMPAT_SYMLINK</makevar>, - and <makevar>DOC_PREFIX</makevar>.</para> + <para>The first four non-empty lines define the &man.make.1; + variables <makevar>SUBDIR</makevar>, + <makevar>COMPAT_SYMLINK</makevar>, and + <makevar>DOC_PREFIX</makevar>.</para> <para>The <makevar>SUBDIR</makevar> statement and <makevar>COMPAT_SYMLINK</makevar> statement show how to @@ -148,24 +144,24 @@ DOC_PREFIX?= ${.CURDIR}/.. point to <filename>en_US.ISO-8859-1</filename>).</para> <para><makevar>DOC_PREFIX</makevar> 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. <makevar>.CURDIR</makevar> is a - &man.make.1; builtin variable with the path - to the current directory.</para> - - <para>The final line includes the &os; Documentation - Project's project-wide &man.make.1; system - file <filename>doc.project.mk</filename> which is the glue - which converts these variables into build instructions.</para> + the &os; Document Project tree. This is not always that easy + to find, and is also easily overridden, to allow for + flexibility. <makevar>.CURDIR</makevar> is a &man.make.1; + builtin variable with the path to the current + directory.</para> + + <para>The final line includes the &os; Documentation Project's + project-wide &man.make.1; system file + <filename>doc.project.mk</filename> which is the glue which + converts these variables into build instructions.</para> </sect2> <sect2 id="doc-make"> <title>Documentation <filename>Makefile</filename>s</title> - <para>These <filename>Makefile</filename>s set - &man.make.1; variables that describe how to - build the documentation contained in that directory.</para> + <para>These <filename>Makefile</filename>s set &man.make.1; + variables that describe how to build the documentation + contained in that directory.</para> <para>Here is an example:</para> @@ -185,10 +181,9 @@ DOC_PREFIX?= ${.CURDIR}/../../.. .include "$(DOC_PREFIX)/share/mk/docproj.docbook.mk"</programlisting> - <para>The <makevar>MAINTAINER</makevar> variable - allows committers to claim - ownership of a document in the &os; Documentation - Project, and take responsibility for maintaining + <para>The <makevar>MAINTAINER</makevar> variable allows + committers to claim ownership of a document in the &os; + Documentation Project, and take responsibility for maintaining it.</para> <para><makevar>DOC</makevar> is the name (sans the @@ -215,8 +210,8 @@ DOC_PREFIX?= ${.CURDIR}/../../.. <title>&os; Documentation Project <application>Make</application> Includes</title> - <para>&man.make.1; includes are best explained by inspection of the code. Here are - the system include files:</para> + <para>&man.make.1; includes are best explained by inspection of + the code. Here are the system include files:</para> <itemizedlist> <listitem> @@ -293,11 +288,10 @@ PRI_LANG?= en_US.ISO8859-1 <title>Conditionals</title> <para>The <literal>.if defined(DOC)</literal> 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. - <literal>defined</literal> is a function which returns - whether the variable given is defined or not.</para> + example of a &man.make.1; conditional which, like in other + programs, defines behavior if some condition is true or if + it is false. <literal>defined</literal> is a function which + returns whether the variable given is defined or not.</para> <para><literal>.if ${DOCFORMAT} == "docbook"</literal>, next, tests whether the <makevar>DOCFORMAT</makevar> variable is @@ -312,8 +306,8 @@ PRI_LANG?= en_US.ISO8859-1 <sect2> <title><filename>doc.subdir.mk</filename></title> - <para>This file is too long to explain in detail. These - notes describe the most important features.</para> + <para>This file is too long to explain in detail. These notes + describe the most important features.</para> <sect3> <title>Variables</title>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201307200128.r6K1SwNn037914>