svn commit: r43305 - head/en_US.ISO8859-1/books/porters-handbook

Warren Block wblock at FreeBSD.org
Sun Dec 8 19:43:25 UTC 2013


Author: wblock
Date: Sun Dec  8 19:43:24 2013
New Revision: 43305
URL: http://svnweb.freebsd.org/changeset/doc/43305

Log:
  Remove redundant language including 682 uses of the word "implied",
  change new <package> tags to use role="port", miscellanous fixes.

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/uses.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses.xml	Sun Dec  8 19:22:45 2013	(r43304)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses.xml	Sun Dec  8 19:43:24 2013	(r43305)
@@ -31,10 +31,10 @@
   <entry>(none), <literal>build</literal>, <literal>run</literal>,
     <literal>both</literal></entry>
 
-  <entry>Implies that the port uses <package>devel/bison</package> in
-    one way or another.  By default, with no arguments or with the
+  <entry>Uses <package role="port">devel/bison</package>
+    By default, with no arguments or with the
     <literal>build</literal> argument, it implies
-    <command>bison</command> as a build-time dependency,
+    <command>bison</command> is a build-time dependency,
     <literal>run</literal> implies a run-time dependency, and
     <literal>both</literal> implies both run-time and build-time
     dependencies.</entry>
@@ -47,7 +47,7 @@
 
   <entry>Prevents the port from installing
     <filename>charset.alias</filename>.  This should be installed only
-    by <package>converters/libiconv</package>.
+    by <package role="port">converters/libiconv</package>.
     <varname>CHARSETFIX_MAKEFILEIN</varname> can be set to a path
     relative to <varname>WRKSRC</varname> if
     <filename>charset.alias</filename> is not installed by
@@ -59,7 +59,7 @@
 
   <entry>(none), <literal>outsource</literal></entry>
 
-  <entry>The port will use <application>CMake</application> for
+  <entry>Uses <application>CMake</application> for
     configuring and building.  With the <literal>outsource</literal>
     argument, an out-of-source build will be performed.  For more
     information see <xref linkend="using-cmake"/>.</entry>
@@ -124,9 +124,9 @@
 
   <entry>(none)</entry>
 
-  <entry>Implies that the port uses the
+  <entry>Uses
     <application>update-desktop-database</application> from
-    <package>devel/desktop-file-utils</package>.  An extra
+    <package role="port">devel/desktop-file-utils</package>.  An extra
     post-install step will be run without interfering with any
     post-install steps already in the port
     <filename>Makefile</filename>.  Lines will be inserted into the
@@ -154,7 +154,7 @@
 
   <entry>(none)</entry>
 
-  <entry>The port has files with line endings in DOS format which need
+  <entry>The port has files with line endings in <acronym>DOS</acronym> format which need
     to be converted.  Three variables can be set to control which
     files will be converted.  The default is to convert
     <emphasis>all</emphasis> files, including binaries.
@@ -182,7 +182,7 @@
 
   <entry>(none)</entry>
 
-  <entry>Implies that the port uses <package>devel/fmake</package> as
+  <entry>Uses <package role="port">devel/fmake</package> as a
     build-time dependency.</entry>
 </row>
 
@@ -191,7 +191,7 @@
 
   <entry>(none)</entry>
 
-  <entry>Implies the port will depend on the FUSE library and handle
+  <entry>The port will depend on the FUSE library and handle
     the dependency on the kernel module depending on the version
     of &os;.</entry>
 </row>
@@ -202,11 +202,11 @@
   <entry>(none), <literal>lib</literal>, <literal>build</literal>,
     <literal>run</literal></entry>
 
-  <entry>Implies that the port uses <package>devel/gettext</package>
-    in one way or another.  By default, with no arguments or with the
+  <entry>Uses <package role="port">devel/gettext</package>.
+    By default, with no arguments or with the
     <literal>lib</literal> argument, implies
     <command>gettext</command> with build-time and run-time
-    dependencies, <literal>build</literal> implies a build-time
+    dependencies.  <literal>build</literal> implies a build-time
     dependency, and <literal>run</literal> implies a run-time
     dependency.</entry>
 </row>
@@ -216,7 +216,7 @@
 
   <entry>(none)</entry>
 
-  <entry>Implies that the port uses <package>devel/gmake</package> as
+  <entry>Uses <package role="port">devel/gmake</package> as a
     build-time dependency.</entry>
 </row>
 
@@ -226,15 +226,15 @@
   <entry>(none), <literal>lib</literal>, <literal>build</literal>,
     <literal>patch</literal></entry>
 
-  <entry>Implies that the port uses <command>iconv</command>
+  <entry>Uses <command>iconv</command>
     functions, either from the port
-    <package>converters/libiconv</package> as a build-time and
+    <package role="port">converters/libiconv</package> as a build-time and
     run-time dependency, or from the base system on 10-CURRENT after a
     native <command>iconv</command> was committed in
     <revnumber>254273</revnumber>.  By default, with no arguments or
     with the <literal>lib</literal> argument, implies
     <command>iconv</command> with build-time and run-time
-    dependencies, <literal>build</literal> implies a build-time
+    dependencies.  <literal>build</literal> implies a build-time
     dependency, and <literal>patch</literal> implies a patch-time
     dependency.  For more information see
     <xref linkend="using-iconv"/>.</entry>
@@ -245,7 +245,7 @@
 
   <entry>(none)</entry>
 
-  <entry>Implies that the port uses <package>devel/imake</package> as
+  <entry>Uses <package role="port">devel/imake</package> as
     build-time dependency.</entry>
 </row>
 
@@ -299,11 +299,11 @@
 
   <entry>(none)</entry>
 
-  <entry>Implies that the ports uses
-    <package>devel/open-motif</package> as a library dependency.  End
+  <entry>Uses
+    <package role="port">devel/open-motif</package> as a library dependency.  End
     users can set <varname>WANT_LESSTIF</varname> for the dependency
-    to be on <package>devel/lesstif</package> instead of
-    <package>devel/open-motif</package>.</entry>
+    to be on <package role="port">devel/lesstif</package> instead of
+    <package role="port">devel/open-motif</package>.</entry>
 </row>
 
 <row>
@@ -312,7 +312,7 @@
   <entry>(none), <literal>base</literal>,
     <literal>port</literal></entry>
 
-  <entry>Implies that the port uses
+  <entry>Uses
     <application>ncurses</application>, and causes some useful
     variables to be set.</entry>
 </row>
@@ -333,8 +333,8 @@
 
   <entry>(none)</entry>
 
-  <entry>Implies a dependency on <application>Perl</application>.  The
-    following variables can be set:
+  <entry>Depends on <application>Perl</application>.
+    These variables can be set:
 
     <itemizedlist>
       <listitem>
@@ -384,11 +384,11 @@
   <entry>(none), <literal>build</literal>, <literal>run</literal>,
     <literal>both</literal></entry>
 
-  <entry>Implies that the port uses <package>devel/pkgconf</package>
-    in one way or another.  With no arguments or with the
+  <entry>Uses <package role="port">devel/pkgconf</package>.
+    With no arguments or with the
     <literal>build</literal> argument, it implies
-    <command>pkg-config</command> as a build-time dependency;
-    <literal>run</literal> implies a run-time dependency; and
+    <command>pkg-config</command> as a build-time dependency.
+    <literal>run</literal> implies a run-time dependency and
     <literal>both</literal> implies both run-time and build-time
     dependencies.</entry>
 </row>
@@ -398,10 +398,10 @@
 
   <entry>(none), <literal>ffi</literal></entry>
 
-  <entry>Implies that the port uses <package>lang/pure</package> in
-    one way or another, but largely is used for building related pure
+  <entry>Uses <package role="port">lang/pure</package>.
+    Largely used for building related <application>pure</application>
     ports.  With the <literal>ffi</literal> argument, it implies
-    <package>devel/pure-ffi</package> as a run-time
+    <package role="port">devel/pure-ffi</package> as a run-time
     dependency.</entry>
 </row>
 
@@ -411,8 +411,8 @@
   <entry>(none), <literal>build</literal>, <literal>run</literal>,
     <literal>both</literal>, <literal>vars</literal></entry>
 
-  <entry>Implies that the port uses <package>mail/qmail</package> in
-    one way or another.  With the <literal>build</literal> argument,
+  <entry>Uses <package role="port">mail/qmail</package>.
+    With the <literal>build</literal> argument,
     it implies <command>qmail</command> as a build-time dependency.
     <literal>run</literal> implies a run-time dependency.  Using no
     argument or the <literal>both</literal> argument implies both
@@ -425,7 +425,7 @@
 
   <entry>(none), <literal>norecursive</literal></entry>
 
-  <entry>The port will use <application>QMake</application> for
+  <entry>Uses <application>QMake</application> for
     configuring.  For more information see
     <xref linkend="using-qmake"/>.</entry>
 </row>
@@ -435,7 +435,7 @@
 
   <entry>(none), port</entry>
 
-  <entry>Implies that the port uses
+  <entry>Uses
     <application>readline</application> as library dependency, and
     sets <varname>CPPFLAGS</varname> and <varname>LDFLAGS</varname> as
     necessary.</entry>
@@ -446,9 +446,9 @@
 
   <entry>(none)</entry>
 
-  <entry>Implies that the port uses
+  <entry>Uses
     <application>update-mime-database</application> from
-    <package>misc/shared-mime-info</package>.  This uses will
+    <package role="port">misc/shared-mime-info</package>.  This uses will
     automatically add a post-install step in such a way that the port
     itself still can specify there own post-install step if needed.
     It also insert lines into the plist for package install and
@@ -551,7 +551,7 @@
       </listitem>
     </itemizedlist>
 
-    The following variables can be adjusted:
+    These variables can be adjusted:
 
     <itemizedlist>
       <listitem>
@@ -581,9 +581,9 @@
 
   <entry>(none)</entry>
 
-  <entry>Implies the port uses <package>net-mgmt/zenoss</package> in
-    one way or another, but largely is used for building zenoss
-    related zenpack ports.</entry>
+  <entry>Uses <package role="port">net-mgmt/zenoss</package>.
+    Largely used for building <application>zenoss</application>
+    related <application>zenpack</application> ports.</entry>
 </row>
 
 <row>
@@ -591,8 +591,8 @@
 
   <entry>(none)</entry>
 
-  <entry>Implies that the port uses <package>www/zope</package> in one
-    way or another, but is largely used for building zope related
+  <entry>Uses <package role="port">www/zope</package>.
+    Mostly used for building <application>zope</application> related
     ports.  <varname>ZOPE_VERSION</varname> can be used by a port to
-    indicate that a specific version of zope shall be used.</entry>
+    indicate that a specific version of <application>zope</application> shall be used.</entry>
 </row>


More information about the svn-doc-all mailing list