Whitespace fixes, translators can ignore.

Sponsored by:	Absolight

en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml

@@ -27,8 +27,8 @@
       numeric revision of the operating system (for example,
       <literal>4.9</literal>).  <literal>%%PERL_VERSION%%</literal>
       and <literal>%%PERL_VER%%</literal> is the full version number
-      of <command>perl</command> (for example, <literal>5.8.9</literal>).
+      of <command>perl</command> (for example,
-      Several other
+      <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
@@ -54,8 +54,8 @@ PLIST_SUB=	OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>
     <para>in the <filename>Makefile</filename> and use
       <literal>%%OCTAVE_VERSION%%</literal> wherever the version shows
       up in <filename>pkg-plist</filename>.  When
-      the port is upgraded, it will not be necessary to edit dozens (or in some
+      the port is upgraded, it will not be necessary to edit dozens
-      cases, hundreds) of lines in
+      (or in some cases, hundreds) of lines in
       <filename>pkg-plist</filename>.</para>
 
     <para>If files are installed conditionally on the options
@@ -113,7 +113,8 @@ OPTIONS_SUB=	yes</programlisting>
 
     <para>From time to time, using <varname>OPTIONS_SUB</varname>
       is not enough.  In those cases, adding a specific
-      <literal><replaceable>TAG</replaceable></literal> to <varname>PLIST_SUB</varname>
+      <literal><replaceable>TAG</replaceable></literal> to
+      <varname>PLIST_SUB</varname>
       inside the <filename>Makefile</filename> with a special
       value of <literal>@comment</literal>, makes package tools to
       ignore the line.  For instance, if some files are only installed
@@ -175,9 +176,9 @@ PLIST_SUB+=	X11I386="@comment "
       <filename>PREFIX/etc</filename> (or elsewhere) do
       <emphasis>not</emphasis> list them in
       <filename>pkg-plist</filename>.  That will cause
-      <command>pkg delete</command> to remove files that have been carefully
+      <command>pkg delete</command> to remove files that have been
-      edited by the user, and a re-installation will wipe them
+      carefully edited by the user, and a re-installation will wipe
-      out.</para>
+      them out.</para>
 
     <para>Instead, install sample files with a
       <filename><replaceable>filename</replaceable>.sample</filename>
@@ -259,8 +260,9 @@ PLIST_SUB+=	X11I386="@comment "
       the package list changes drastically based upon optional
       features of the port (and thus maintaining a static package list
       is infeasible), or ports which change the package list based
-      upon the version of dependent software used.  For example, ports which
+      upon the version of dependent software used.  For example, ports
-      generate docs with <application>Javadoc</application>.</para>
+      which generate docs with
+      <application>Javadoc</application>.</para>
   </sect1>
 
   <sect1 xml:id="plist-autoplist">
@@ -635,8 +637,8 @@ PLIST_SUB+=	X11I386="@comment "
 	  <replaceable>command</replaceable> (Deprecated)</title>
 
 	<para>Execute <replaceable>command</replaceable> as part of
-	  the installation or deinstallation process.  Please use <xref
+	  the installation or deinstallation process.  Please use
-	    linkend="plist-keywords-base-exec"/> instead.</para>
+	  <xref linkend="plist-keywords-base-exec"/> instead.</para>
       </sect3>
 
       <sect3 xml:id="plist-keywords-base-dirrm">
@@ -706,12 +708,12 @@ PLIST_SUB+=	X11I386="@comment "
       <sect3 xml:id="plist-keywords-attributes">
 	<title><literal>attributes</literal></title>
 
-	    <para>Changes the owner, group, or mode used by the
+	<para>Changes the owner, group, or mode used by the keyword.
-	      keyword.  Contains an associative array where the
+	  Contains an associative array where the possible keys are
-	      possible keys are <literal>owner</literal>,
+	  <literal>owner</literal>, <literal>group</literal>, and
-	      <literal>group</literal>, and <literal>mode</literal>.
+	  <literal>mode</literal>.  The values are, respectively, a
-	      The values are, respectively, a user name, a group name,
+	  user name, a group name, and a file mode.  For
-	      and a file mode.  For example:</para>
+	  example:</para>
 
 	<programlisting>attributes: { owner: "games", group: "games", mode: 0555 }</programlisting>
       </sect3>
@@ -727,8 +729,7 @@ PLIST_SUB+=	X11I386="@comment "
 	    <term><literal>setprefix</literal></term>
 
 	    <listitem>
-		  <para>Set the prefix for the next plist
+	      <para>Set the prefix for the next plist entries.</para>
-		    entries.</para>
 	    </listitem>
 	  </varlistentry>
 
@@ -736,8 +737,8 @@ PLIST_SUB+=	X11I386="@comment "
 	    <term><literal>dir</literal></term>
 
 	    <listitem>
-		  <para>Register a directory to be created on
+	      <para>Register a directory to be created on install and
-		    install and removed on deinstall.</para>
+		removed on deinstall.</para>
 	    </listitem>
 	  </varlistentry>
 
@@ -745,8 +746,8 @@ PLIST_SUB+=	X11I386="@comment "
 	    <term><literal>dirrm</literal></term>
 
 	    <listitem>
-		  <para>Register a directory to be deleted on
+	      <para>Register a directory to be deleted on deinstall.
-		    deinstall.  Deprecated.</para>
+		Deprecated.</para>
 	    </listitem>
 	  </varlistentry>
 
@@ -771,8 +772,7 @@ PLIST_SUB+=	X11I386="@comment "
 	    <term><literal>setmode</literal></term>
 
 	    <listitem>
-		  <para>Set the mode for the next plist
+	      <para>Set the mode for the next plist entries.</para>
-		    entries.</para>
 	    </listitem>
 	  </varlistentry>
 
@@ -780,8 +780,7 @@ PLIST_SUB+=	X11I386="@comment "
 	    <term><literal>setowner</literal></term>
 
 	    <listitem>
-		  <para>Set the owner for the next plist
+	      <para>Set the owner for the next plist entries.</para>
-		    entries.</para>
 	    </listitem>
 	  </varlistentry>
 
@@ -789,8 +788,7 @@ PLIST_SUB+=	X11I386="@comment "
 	    <term><literal>setgroup</literal></term>
 
 	    <listitem>
-		  <para>Set the group for the next plist
+	      <para>Set the group for the next plist entries.</para>
-		    entries.</para>
 	    </listitem>
 	  </varlistentry>
 
@@ -798,9 +796,8 @@ PLIST_SUB+=	X11I386="@comment "
 	    <term><literal>comment</literal></term>
 
 	    <listitem>
-		  <para>Does not do anything, equivalent to not
+	      <para>Does not do anything, equivalent to not entering
-		    entering an <literal>action</literal>
+		an <literal>action</literal> section.</para>
-		    section.</para>
 	    </listitem>
 	  </varlistentry>
 
@@ -825,8 +822,8 @@ PLIST_SUB+=	X11I386="@comment "
 
 	<programlisting>@foo some.content other.content</programlisting>
 
-	    <para><literal>%1</literal> and <literal>%2</literal>
+	<para><literal>%1</literal> and <literal>%2</literal> will
-	      will contain:</para>
+	  contain:</para>
 
 	<programlisting>some.content
 other.content</programlisting>
@@ -848,14 +845,14 @@ other.content</programlisting>
 	  <literal>post-upgrade</literal></title>
 
 	<para>These keywords contains a &man.sh.1; script to be
-	      executed before or after installation, deinstallation,
+	  executed before or after installation, deinstallation, or
-	      or upgrade of the package.  In addition to the usual
+	  upgrade of the package.  In addition to the usual
 	  <literal>@exec</literal>
 	  <literal>%<replaceable>foo</replaceable></literal>
 	  placeholders described in <xref
-		linkend="plist-keywords-base-exec"/>, there is a new
+	    linkend="plist-keywords-base-exec"/>, there is a new one,
-	      one, <literal>%@</literal>, which represents the
+	  <literal>%@</literal>, which represents the argument of the
-	      argument of the keyword.</para>
+	  keyword.</para>
       </sect3>
 
       <sect3 xml:id="plist-keywords-examples">
@@ -867,9 +864,9 @@ other.content</programlisting>
 
 	  <para>This keyword does two things, it adds a
 	    <literal>@dirrmtry
-	    <replaceable>directory</replaceable></literal> line to the
+	      <replaceable>directory</replaceable></literal> line to
-	  packing list, and echoes the fact that the directory is
+	    the packing list, and echoes the fact that the directory
-	  removed when deinstalling the package.</para>
+	    is removed when deinstalling the package.</para>
 
 	  <programlisting>actions: [dirrmtry]
 post-deinstall: &lt;&lt;EOD
@@ -878,17 +875,17 @@ EOD</programlisting>
 	</example>
 
 	<example xml:id="plist-keywords-sample-example">
-	<title>Real Life Example, How <literal>@sample</literal>
+	  <title>Real Life Example, How <literal>@sample</literal> is
-	  is Implemented</title>
+	    Implemented</title>
 
 	  <para>This keyword does three things.  It adds the first
-	  <replaceable>filename</replaceable> passed as an argument to
+	    <replaceable>filename</replaceable> passed as an argument
-	  <literal>@sample</literal> to the packing list, it adds to
+	    to <literal>@sample</literal> to the packing list, it adds
-	  the <literal>post-install</literal> script instructions to
+	    to the <literal>post-install</literal> script instructions
-	  copy the sample to the actual configuration file if it does
+	    to copy the sample to the actual configuration file if it
-	  not already exist, and it adds to the
+	    does not already exist, and it adds to the
-	  <literal>post-deinstall</literal> instructions to remove the
+	    <literal>post-deinstall</literal> instructions to remove
-	  configuration file if it has not been modified.</para>
+	    the configuration file if it has not been modified.</para>
 
 	  <programlisting>actions: [file(1)]
 arguments: true