Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 14 Aug 2014 13:13:23 +0000 (UTC)
From:      Mathieu Arnold <mat@FreeBSD.org>
To:        doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org
Subject:   svn commit: r45455 - in head/en_US.ISO8859-1/books/porters-handbook: makefiles pkg-files plist porting-dads quick-porting slow-porting special uses
Message-ID:  <201408141313.s7EDDNoU090148@svn.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: mat (ports committer)
Date: Thu Aug 14 13:13:23 2014
New Revision: 45455
URL: http://svnweb.freebsd.org/changeset/doc/45455

Log:
  Whitespace-only fixes, indentation and wrapping long lines.
  Translators, please ignore.
  
  Sponsored by:	Absolight
  Differential Revision: https://phabric.freebsd.org/605

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
  head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
  head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
  head/en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml
  head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml
  head/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml
  head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
  head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Thu Aug 14 13:10:48 2014	(r45454)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Thu Aug 14 13:13:23 2014	(r45455)
@@ -3546,10 +3546,9 @@ OPT5_DESC=	Describe OPT5
 OPT6_DESC=	Describe OPT6</programlisting>
 
 	<para><filename>ports/Mk/bsd.options.desc.mk</filename>
-	    has descriptions for many common
-	    <varname>OPTIONS</varname>.  While often useful, they
-	    should be overridden if the description is insufficient
-	    for the port.</para>
+	  has descriptions for many common <varname>OPTIONS</varname>.
+	  While often useful, they should be overridden if the
+	  description is insufficient for the port.</para>
 
 	<tip>
 	  <para>When describing options, view it from the
@@ -3823,8 +3822,8 @@ SUB_LIST+=	OPT1="@comment " NO_OPT1=""
 	  <varname>USE_<replaceable>KEY</replaceable></varname>
 	  variable will be set to <replaceable>value</replaceable>.
 	  If <replaceable>value</replaceable> has spaces in it,
-	  replace them with commas, they will be changed back to spaces
-	  during processing.  For example:</para>
+	  replace them with commas, they will be changed back to
+	  spaces during processing.  For example:</para>
 
 	<programlisting>OPTIONS_DEFINE=	OPT1
 OPT1_USE=	mysql=yes xorg=x11,xextproto,xext,xrandr</programlisting>
@@ -3884,7 +3883,7 @@ CONFIGURE_ARGS+=	--disable-test
 	  on the status of the option
 	  <literal><replaceable>OPT</replaceable></literal>.  An
 	  optional argument can be specified with an
-	  <literal>=</literal> symbol. This argument is only appended
+	  <literal>=</literal> symbol.  This argument is only appended
 	  to the
 	  <literal>--with-<replaceable>opt</replaceable></literal>
 	  configure option.  For example:</para>

Modified: head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml	Thu Aug 14 13:10:48 2014	(r45454)
+++ head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml	Thu Aug 14 13:13:23 2014	(r45455)
@@ -12,8 +12,8 @@
   <title>The <filename>pkg-*</filename> Files</title>
 
   <para>There are some tricks we have not mentioned yet about the
-    <filename>pkg-<replaceable>*</replaceable></filename> files that come in handy
-    sometimes.</para>
+    <filename>pkg-<replaceable>*</replaceable></filename> files that
+    come in handy sometimes.</para>
 
   <sect1 xml:id="porting-message">
     <title><filename>pkg-message</filename></title>
@@ -84,16 +84,20 @@
 
   <sect1 xml:id="pkg-names">
     <title xml:id="porting-pkgfiles">Changing the Names of
-      <filename>pkg-<replaceable>*</replaceable></filename> Files</title>
+      <filename>pkg-<replaceable>*</replaceable></filename>
+      Files</title>
 
-    <para>All the names of <filename>pkg-<replaceable>*</replaceable></filename> files are
+    <para>All the names of
+      <filename>pkg-<replaceable>*</replaceable></filename> files are
       defined using variables so you can change them in your
       <filename>Makefile</filename> if need be.  This is especially
-      useful when you are sharing the same <filename>pkg-<replaceable>*</replaceable></filename>
-      files among several ports or have to write to one of the above
-      files (see <link linkend="porting-wrkdir">writing to places
-	other than <varname>WRKDIR</varname></link> for why it is a
-      bad idea to write directly into the <filename>pkg-<replaceable>*</replaceable></filename>
+      useful when you are sharing the same
+      <filename>pkg-<replaceable>*</replaceable></filename> files
+      among several ports or have to write to one of the above files
+      (see <link linkend="porting-wrkdir">writing to places other than
+	<varname>WRKDIR</varname></link> for why it is a bad idea to
+      write directly into the
+      <filename>pkg-<replaceable>*</replaceable></filename>
       subdirectory).</para>
 
     <para>Here is a list of variable names and their default values.

Modified: head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml	Thu Aug 14 13:10:48 2014	(r45454)
+++ head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml	Thu Aug 14 13:13:23 2014	(r45455)
@@ -28,16 +28,18 @@
       <literal>4.9</literal>).  <literal>%%PERL_VERSION%%</literal>
       and <literal>%%PERL_VER%%</literal> is the full version number
       of <command>perl</command> (e.g., <literal>5.8.9</literal>).
-      Several other <literal>%%<replaceable>VARS</replaceable>%%</literal> related to port's
-      documentation files are described in
-      <link linkend="install-documentation">the relevant
+      Several other
+      <literal>%%<replaceable>VARS</replaceable>%%</literal> related
+      to port's documentation files are described in <link
+	linkend="install-documentation">the relevant
 	section</link>.</para>
 
     <para>If you need to make other substitutions, you can set the
       <varname>PLIST_SUB</varname> variable with a list of
-      <literal><replaceable>VAR</replaceable>=<replaceable>VALUE</replaceable></literal> pairs and instances of
-      <literal>%%<replaceable>VAR</replaceable>%%</literal> will be substituted with
-      <replaceable>VALUE</replaceable> in the
+      <literal><replaceable>VAR</replaceable>=<replaceable>VALUE</replaceable></literal>
+      pairs and instances of
+      <literal>%%<replaceable>VAR</replaceable>%%</literal> will be
+      substituted with <replaceable>VALUE</replaceable> in the
       <filename>pkg-plist</filename>.</para>
 
     <para>For instance, if you have a port that installs many files
@@ -97,11 +99,12 @@ OPTIONS_SUB=	yes</programlisting>
       <filename>PLIST</filename> contents.  Names listed in
       <varname>PLIST_FILES</varname>, <varname>PLIST_DIRS</varname>,
       and <varname>PLIST_DIRSTRY</varname> are subject to
-      <literal>%%<replaceable>VAR</replaceable>%%</literal> substitution as described above.
-      Except for that, names from <varname>PLIST_FILES</varname> will
-      appear in the final packing list unchanged, while
-      <literal>@dirrm</literal> and <literal>@dirrmtry</literal> will
-      be prepended to names from <varname>PLIST_DIRS</varname> and
+      <literal>%%<replaceable>VAR</replaceable>%%</literal>
+      substitution as described above.  Except for that, names from
+      <varname>PLIST_FILES</varname> will appear in the final packing
+      list unchanged, while <literal>@dirrm</literal> and
+      <literal>@dirrmtry</literal> will be prepended to names from
+      <varname>PLIST_DIRS</varname> and
       <varname>PLIST_DIRSTRY</varname>, respectively.  To take effect,
       <varname>PLIST_FILES</varname>, <varname>PLIST_DIRS</varname>,
       and <varname>PLIST_DIRSTRY</varname> must be set before
@@ -294,14 +297,14 @@ etc/orbit.conf-dist
       can get it wrong.</para>
 
     <para>User configuration files should be installed as
-      <filename><replaceable>filename</replaceable>.sample</filename>, as it is described in
-      <xref linkend="plist-config"/>.  The
+      <filename><replaceable>filename</replaceable>.sample</filename>,
+      as it is described in <xref linkend="plist-config"/>.  The
       <filename>info/dir</filename> file should not be listed and
       appropriate <filename>install-info</filename> lines should be
-      added as noted in the
-      <link linkend="makefile-info">info files</link> section.  Any
-      libraries installed by the port should be listed as specified in
-      the <link linkend="porting-shlibs">shared libraries</link>
+      added as noted in the <link linkend="makefile-info">info
+	files</link> section.  Any libraries installed by the port
+      should be listed as specified in the <link
+	linkend="porting-shlibs">shared libraries</link>
       section.</para>
   </sect1>
 

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 Aug 14 13:10:48 2014	(r45454)
+++ head/en_US.ISO8859-1/books/porters-handbook/porting-dads/chapter.xml	Thu Aug 14 13:13:23 2014	(r45455)
@@ -36,9 +36,9 @@
 	xlink:href="&url.books.handbook;/ports-using.html#PORTS-CD">
 	installing ports from a CDROM</link> for an example of
       building ports from a read-only tree).  If you need to modify
-      one of the <filename>pkg-<replaceable>*</replaceable></filename> files, do so by
-      <link linkend="pkg-names">redefining a variable</link>,
-      not by writing over it.</para>
+      one of the <filename>pkg-<replaceable>*</replaceable></filename>
+      files, do so by <link linkend="pkg-names">redefining a
+	variable</link>, not by writing over it.</para>
   </sect1>
 
   <sect1 xml:id="porting-wrkdirprefix">
@@ -48,10 +48,12 @@
       Most ports do not have to worry about this.  In particular, if
       you are referring to a <varname>WRKDIR</varname> of another
       port, note that the correct location is
-      <filename>WRKDIRPREFIXPORTSDIR/<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename> not
-      <filename>PORTSDIR/<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename> or
-      <filename>.CURDIR/../../<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename> or some
-      such.</para>
+      <filename>WRKDIRPREFIXPORTSDIR/<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename>
+      not
+      <filename>PORTSDIR/<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename>
+      or
+      <filename>.CURDIR/../../<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename>
+      or some such.</para>
 
     <para>Also, if you are defining <varname>WRKDIR</varname>
       yourself, make sure you prepend
@@ -386,9 +388,9 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD
       <itemizedlist>
 	<listitem>
 	  <para><varname>BROKEN</varname> is reserved for ports that
-	    currently do not compile, install, deinstall, or run correctly.
-	    It should be used for ports where the problem is believed
-	    to be temporary.</para>
+	    currently do not compile, install, deinstall, or run
+	    correctly.  It should be used for ports where the problem
+	    is believed to be temporary.</para>
 
 	  <para>If instructed, the build cluster will still attempt
 	    to try to build them to see if the underlying problem has

Modified: head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml	Thu Aug 14 13:10:48 2014	(r45454)
+++ head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml	Thu Aug 14 13:13:23 2014	(r45455)
@@ -21,9 +21,10 @@
 
   <note>
     <para>The following steps assume that the software compiled
-      out-of-the-box.  In other words, absolutely no changes were required
-      for the application to work on a &os; system.  If anything had to be
-      changed, refer to <xref linkend="slow-porting"/>.</para>
+      out-of-the-box.  In other words, absolutely no changes were
+      required for the application to work on a &os; system.  If
+      anything had to be changed, refer to <xref
+	linkend="slow-porting"/>.</para>
   </note>
 
   <note>
@@ -208,8 +209,8 @@ PLIST_DIRS=	lib/X11/oneko</programlistin
       </note>
 
       <para>The price for this way of listing a port's files and
-	directories is that then command sequences
-	described in &man.pkg-create.8; cannot be used.  Therefore, it is suitable
+	directories is that then command sequences described in
+	&man.pkg-create.8; cannot be used.  Therefore, it is suitable
 	only for simple ports and makes them even simpler.  At the
 	same time, it has the advantage of reducing the number of
 	files in the ports collection.  Please consider using this
@@ -294,7 +295,8 @@ PLIST_DIRS=	lib/X11/oneko</programlistin
       </step>
 
       <step>
-	<para><command>pkg add <replaceable>package-filename</replaceable></command></para>
+	<para><command>pkg add
+	    <replaceable>package-filename</replaceable></command></para>
       </step>
 
       <step>

Modified: head/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml	Thu Aug 14 13:10:48 2014	(r45454)
+++ head/en_US.ISO8859-1/books/porters-handbook/slow-porting/chapter.xml	Thu Aug 14 13:13:23 2014	(r45455)
@@ -59,8 +59,8 @@
 	<para>The <buildtarget>patch</buildtarget> target is run.
 	  First, any patches defined in <varname>PATCHFILES</varname>
 	  are applied.  Second, if any patch files named
-	  <filename>patch-<replaceable>*</replaceable></filename> are found in
-	  <varname>PATCHDIR</varname> (defaults to the
+	  <filename>patch-<replaceable>*</replaceable></filename> are
+	  found in <varname>PATCHDIR</varname> (defaults to the
 	  <filename>files</filename> subdirectory), they are applied
 	  at this time in alphabetical order.</para>
       </step>
@@ -170,8 +170,8 @@
 
     <para>Get the original sources (normally) as a compressed tarball
       (<filename>foo.tar.gz</filename> or
-      <filename><replaceable>foo</replaceable>.tar.bz2</filename>) and copy it into
-      <varname>DISTDIR</varname>.  Always use
+      <filename><replaceable>foo</replaceable>.tar.bz2</filename>) and
+      copy it into <varname>DISTDIR</varname>.  Always use
       <emphasis>mainstream</emphasis> sources when and where you
       can.</para>
 
@@ -344,7 +344,7 @@
       <note>
 	<para>Manual patch creation is usually not necessary.
 	  Automatic patch generation as described earlier in this
-	  section is the preferred method. However, manual patching
+	  section is the preferred method.  However, manual patching
 	  may be required occasionally.</para>
       </note>
 
@@ -369,8 +369,8 @@
 
       <screen>&prompt.user; <userinput>diff -u -N <replaceable>newfile</replaceable>.orig <replaceable>newfile</replaceable> &gt; patch-<replaceable>pathname-newfile</replaceable></userinput></screen>
 
-      <para>Do not add <literal>&dollar;FreeBSD&dollar;</literal> RCS strings in
-	patches.  When patches are added to the
+      <para>Do not add <literal>&dollar;FreeBSD&dollar;</literal> RCS
+	strings in patches.  When patches are added to the
 	<application>Subversion</application> repository with
 	<command>svn add</command>, the
 	<literal>fbsd:nokeywords</literal> property is set to

Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Thu Aug 14 13:10:48 2014	(r45454)
+++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Thu Aug 14 13:13:23 2014	(r45455)
@@ -810,8 +810,9 @@ CMAKE_SOURCE_PATH=	&dollar;{WRKSRC}/subp
 	libtool (search for a file named ltmain.sh) need to have
 	<literal>USES=libtool</literal>.  Also, if a port has
 	<literal>USE_AUTOTOOLS=libtoolize</literal> it probably also
-	needs <literal>USES=libtool</literal>.  See the <link linkend="uses-libtool">USES=libtool</link>
-	section in <xref linkend="uses"/> for more details.</para>
+	needs <literal>USES=libtool</literal>.  See the <link
+	  linkend="uses-libtool">USES=libtool</link> section in <xref
+	  linkend="uses"/> for more details.</para>
 
     </sect2>
 
@@ -1342,9 +1343,10 @@ USE_XORG=	x11 xpm</programlisting>
 	<title>Updating Desktop Database</title>
 
 	<para>If a port has a MimeType entry in its
-	  <filename><replaceable>portname</replaceable>.desktop</filename>, the desktop database
-	  must be updated after install and deinstall.  To do this,
-	  define <varname>USES</varname>= desktop-file-utils.</para>
+	  <filename><replaceable>portname</replaceable>.desktop</filename>,
+	  the desktop database must be updated after install and
+	  deinstall.  To do this, define <varname>USES</varname>=
+	  desktop-file-utils.</para>
       </sect3>
 
       <sect3 xml:id="desktop-entries-macro">
@@ -1352,9 +1354,10 @@ USE_XORG=	x11 xpm</programlisting>
 	  <varname>DESKTOP_ENTRIES</varname> Macro</title>
 
 	<para>Desktop entries can be easily created for applications
-	  by using the <varname>DESKTOP_ENTRIES</varname> variable. A
-	  file named <filename><replaceable>name</replaceable>.desktop</filename> will be
-	  created, installed, and added to the
+	  by using the <varname>DESKTOP_ENTRIES</varname> variable.  A
+	  file named
+	  <filename><replaceable>name</replaceable>.desktop</filename>
+	  will be created, installed, and added to the
 	  <filename>pkg-plist</filename> automatically.  Syntax
 	  is:</para>
 

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Thu Aug 14 13:10:48 2014	(r45454)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Thu Aug 14 13:13:23 2014	(r45455)
@@ -987,13 +987,14 @@ GSSAPI_NONE_CONFIGURE_ON=	--without-gssa
 
 	  <entry>(none), <literal>Z</literal>, <literal>bz2</literal>,
 	    <literal>bzip2</literal>, <literal>lzma</literal>,
-	    <literal>tbz</literal>, <literal>tgz</literal>, <literal>txz</literal>,
-	    <literal>xz</literal></entry>
+	    <literal>tbz</literal>, <literal>tgz</literal>,
+	    <literal>txz</literal>, <literal>xz</literal></entry>
 
 	  <entry>Set <varname>EXTRACT_SUFX</varname> to
 	    <literal>.tar</literal>, <literal>.tar.Z</literal>,
-	    <literal>.tar.bz2</literal>, <literal>.tar.bz2</literal>, <literal>.tar.lzma</literal>,
-	    <literal>.tbz</literal>, <literal>.tgz</literal>, <literal>.txz</literal> or
+	    <literal>.tar.bz2</literal>, <literal>.tar.bz2</literal>,
+	    <literal>.tar.lzma</literal>, <literal>.tbz</literal>,
+	    <literal>.tgz</literal>, <literal>.txz</literal> or
 	    <literal>.tar.xz</literal> respectively.</entry>
 	</row>
 



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201408141313.s7EDDNoU090148>