en-US/Devel-Tools.xml

Karsten Wade quaid at fedoraproject.org
Fri Apr 3 02:57:30 UTC 2009


 en-US/Devel-Tools.xml |  306 +++++++++++++++++++++++++-------------------------
 1 file changed, 153 insertions(+), 153 deletions(-)

New commits:
commit 36043179d341696cc146062dd5d7357217b27656
Author: Karsten Wade <kwade at calliope.phig.org>
Date:   Thu Apr 2 19:57:10 2009 -0700

    little style guide fixes and some xml fixes throughout

diff --git a/en-US/Devel-Tools.xml b/en-US/Devel-Tools.xml
index 7b568eb..7fd69ef 100644
--- a/en-US/Devel-Tools.xml
+++ b/en-US/Devel-Tools.xml
@@ -384,12 +384,12 @@
 	<term>doxygen</term>
 	<listitem>
 	  <para>
-	    <package>doxygen</package> 1.5.8 includes a completely
-	    rewritten doxywizard, enhanced extension mapping, support
-	    for Vietnamese and better support for Turkish. In addition
-	    there are numerous bug fixes as outlined in <ulink
-	    type="http"
-	    url="http://www.stack.nl/~dimitri/doxygen/changelog.html">http://www.stack.nl/~dimitri/doxygen/changelog.html</ulink>.
+	    The new <package>doxygen</package> 1.5.8 includes a
+	    completely rewritten <command>doxywizard</command>,
+	    enhanced extension mapping, support for Vietnamese and
+	    better support for Turkish. In addition there are numerous
+	    bug fixes as outlined in <ulink type="http"
+	    url="http://www.stack.nl/~dimitri/doxygen/changelog.html"/>.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -399,26 +399,25 @@
 	<listitem>
 	  <para>
 	    Version 2.7 of <package>highlight</package> includes (from
-	    <ulink type="http"
-	    url="http://www.andre-simon.de/">http://www.andre-simon.de/</ulink>):
-	    <itemizedlist>
-	      <listitem>
-		<para>
-		  improved XML- and VHDL highlighting
-		</para>
-	      </listitem>
-
-	      <listitem>
-		<para>
-		  added support for Clojure 
-		</para>
-	      </listitem>
-	      <listitem>
-		<para>
-		added wrapping arrows in LaTeX output </para>
-	      </listitem>
-	    </itemizedlist>
+	    <ulink type="http" url="http://www.andre-simon.de/"/>):
 	  </para>
+	  <itemizedlist>
+	    <listitem>
+	      <para>
+		improved XML- and VHDL highlighting
+	      </para>
+	    </listitem>
+	    
+	    <listitem>
+	      <para>
+		added support for Clojure 
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+	      added wrapping arrows in LaTeX output </para>
+	    </listitem>
+	  </itemizedlist>
 	</listitem>
       </varlistentry>
 
@@ -430,7 +429,7 @@
 	    reference card, better support for HTML, and support for
 	    multibyte character sets. For full details, see the
 	    project site: <ulink type="http"
-	    url="http://www.gnu.org/software/texinfo/">http://www.gnu.org/software/texinfo/</ulink>.
+	    url="http://www.gnu.org/software/texinfo/"/>.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -448,9 +447,9 @@
 	<listitem>
 	  <para>
 	    Release 22.3 of <package>emacs</package> is primarily
-	    concerned with cleaning out old/obsolete features. See the
+	    concerned with cleaning out old/obsolete features. Refer to the
 	    NEWS file (<ulink type="http"
-	    url="http://www.gnu.org/software/emacs/NEWS.22.3">http://www.gnu.org/software/emacs/NEWS.22.3</ulink>)
+	    url="http://www.gnu.org/software/emacs/NEWS.22.3"/>)
 	    for full details.
 	  </para>
 	</listitem>
@@ -461,8 +460,8 @@
 	<listitem>
 	  <para>
 	    Fedora 11 includes version 4.3.0 of the
-	    <package>eric</package> Python IDE. See <ulink type="http"
-	    url="http://eric-ide.python-projects.org/eric-news.html">http://eric-ide.python-projects.org/eric-news.html</ulink>
+	    <package>eric</package> Python IDE. Refer to <ulink type="http"
+	    url="http://eric-ide.python-projects.org/eric-news.html"/>
 	    for full details.
 	  </para>
 	</listitem>
@@ -472,9 +471,9 @@
 	<term>ipython</term>
 	<listitem>
 	  <para>
-	    ipython 0.9.1 is included, an update from 0.8.4. This is a
-	    major release. See <ulink type="http"
-	    url="http://ipython.scipy.org/announcements/ann-ipython-0.9.txt">http://ipython.scipy.org/announcements/ann-ipython-0.9.txt</ulink>
+	    The <package>ipython</package> 0.9.1 version is included, an update from 0.8.4. This is a
+	    major release. Refer to <ulink type="http"
+	    url="http://ipython.scipy.org/announcements/ann-ipython-0.9.txt"/>
 	    for the full story.
 	  </para>
 	</listitem>
@@ -484,10 +483,10 @@
 	<term>monodevelop</term>
 	<listitem>
 	  <para>
-	    <package>monodevelop</package> 1.9.2 includes a large
+	    The updated <package>monodevelop</package> 1.9.2 includes a large
 	    number of new features. You can review these features at
 	    <ulink type="http"
-	    url="http://monodevelop.com/Release_notes_for_MonoDevelop_2.0_Beta_1">http://monodevelop.com/Release_notes_for_MonoDevelop_2.0_Beta_1</ulink>.
+	    url="http://monodevelop.com/Release_notes_for_MonoDevelop_2.0_Beta_1"/>.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -513,14 +512,14 @@
 	<term>mantis</term>
 	<listitem>
 	  <para>
-	    <package>mantis</package> has been upgraded to
+	    The <package>mantis</package> package has been upgraded to
 	    1.1.6. "This release fixes once and for all the caching
 	    troubles from previous stable releases, some access
 	    permissions bugs, and a few various other issues. This
 	    release also improves the existing source control
 	    integration by allowing remote checkins." For a complete
-	    list of all other changes see <ulink type="http"
-	    url="http://www.mantisbt.org/">http://www.mantisbt.org/</ulink>.
+	    list of all other changes refer to <ulink type="http"
+	    url="http://www.mantisbt.org/"/>.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -541,10 +540,11 @@
 	<term>trac-mercurial-plugin</term>
 	<listitem>
 	  <para>
-	    <package>trac-mercurial-plugin</package> 0.11.0.7 works
-	    with the trac 0.11 release, and provides added features
-	    including quickjump to a tag or branch, blame support, and
-	    custom property renderers.
+	    The <package>trac-mercurial-plugin</package> 0.11.0.7
+	    package works with the <package>trac</package>
+	    0.11 release, and provides added features including
+	    quickjump to a tag or branch, blame support, and custom
+	    property renderers.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -579,7 +579,7 @@
 	<term>automake</term>
 	<listitem>
 	  <para>
-	    <package>automake</package> 1.10.2 improvements: 
+	    Improvements in <package>automake</package> 1.10.2 include: 
 	    <itemizedlist>
 	      <listitem>
 		<para>
@@ -587,10 +587,10 @@
 		  <itemizedlist>
 		    <listitem>
 		      <para>
-			<command>distcheck</command> works with
+			The <command>distcheck</command> command works with
 			Libtool 2.x even when
-			<command>LT_OUTPUT</command> is used, as
-			config.lt is removed correctly now.
+			<envar>LT_OUTPUT</envar> is used, as
+			<option>config.lt</option> is removed correctly now.
 		      </para>
 		    </listitem>
 		  </itemizedlist>
@@ -608,8 +608,8 @@
 		    </listitem>
 		    <listitem>
 		      <para>
-			When <command>automake
-			--add-missing</command>command> causes the
+			When the <command>automake
+			--add-missing</command> command causes the
 			COPYING file to be installed, it will also
 			warn that the license file should be added to
 			source control.
@@ -628,10 +628,10 @@
 	<term>cmake</term>
 	<listitem>
 	  <para>
-	    cmake has been upgraded to version 2.6.3. This update
+	    The <package>cmake</package> has been upgraded to version 2.6.3. This update
 	    includes many bug fixes. For a complete list visit <ulink
 	    type="http"
-	    url="http://www.cmake.org/files/v2.6/CMakeChangeLog-2.6.3">http://www.cmake.org/files/v2.6/CMakeChangeLog-2.6.3</ulink>.
+	    url="http://www.cmake.org/files/v2.6/CMakeChangeLog-2.6.3"/>.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -655,34 +655,33 @@
 	    <itemizedlist>
 	      <listitem>
 		<para>
-		  Pygtk version 2.8 now required
+		  <package>Pygtk</package> version 2.8 now required.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  Port to gtk.UIManager
+		  Port to <classname>gtk.UIManager</classname>.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  Handle spaces in svn paths
+		  Handle spaces in Subversion paths.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  Command-line auto-compare all option on startup
-		  (Ondrej Novy)
+		  Command-line auto-compare all option on startup.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  Command-line can launch several comparisons
+		  Command-line can launch several comparisons.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
 		  Several UI tweaks (better focus behavior, better
-		  defaults)
+		  defaults.)
 		</para>
 	      </listitem>
 	    </itemizedlist>
@@ -713,12 +712,12 @@
 	<term>bzr</term>
 	<listitem>
 	  <para>
-	    <package>bzr</package> has been upgraded to 1.12 which
+	    The <package>bzr</package> package has been upgraded to 1.12 which
 	    includes a large number of new features and bug fixes over
-	    the 1.7 version in Fedora 10. The <package>bzr</package>
+	    the 1.7 version in Fedora 10. The <command>bzr</command>
 	    user is encouraged to visit the project's webpage at
 	    <ulink type="http"
-	    url="http://www.bazaar-vcs.org/">http://www.bazaar-vcs.org/</ulink>
+	    url="http://www.bazaar-vcs.org/"/>
 	    to review these improvements.
 	  </para>
 	</listitem>
@@ -728,10 +727,10 @@
 	<term>cvs2svn</term>
 	<listitem>
 	  <para>
-	    <package>cvs2svn</package> has been updated to 2.2.0. In
+	    The <package>cvs2svn</package> package has been updated to 2.2.0. In
 	    addition to bugfixes, there are a large number of new
 	    features. Visit <ulink type="http"
-	    url="http://cvs2svn.tigris.org/source/browse/cvs2svn/tags/2.2.0/CHANGES">http://cvs2svn.tigris.org/source/browse/cvs2svn/tags/2.2.0/CHANGES</ulink>
+	    url="http://cvs2svn.tigris.org/source/browse/cvs2svn/tags/2.2.0/CHANGES"/>
 	    for the details.
 	  </para>
 	</listitem>
@@ -743,8 +742,8 @@
 	  <para>
 	    Version 2.2.0 of <package>darcs</package> includes a
 	    number of new features in addition to a number of
-	    bugfixes. See the changelog at <ulink type="http"
-	    url="http://allmydata.org/trac/darcs-2/browser/NEWS">http://allmydata.org/trac/darcs-2/browser/NEWS</ulink>.
+	    bugfixes. Refer to the changelog at <ulink type="http"
+	    url="http://allmydata.org/trac/darcs-2/browser/NEWS"/>.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -790,21 +789,22 @@
 	<term>git</term>
 	<listitem>
 	  <para>
-	    <package>git</package> has been updated to 1.6.2. In
+	    The <package>git</package> package has been updated to 1.6.2. In
 	    addition to other changes, the Fedora packages now follow
 	    upstream defaults and install the majority of
 	    <command>git-*</command> commands outside the default
-	    PATH. If you have scripts that call
+	    <envar>PATH</envar>. If you have scripts that call
 	    <command>git-*</command> binaries, you are encouraged to
 	    change them to use the <command>git foo</command>
 	    style. If this is not feasible, you can adjust your
-	    PATH. Git provides a convenient method to do this:
-	    <screen>
-	      PATH=$(git --exec-path):$PATH
-	    </screen>
-	    It is worth noting that <package>git</package> hooks are
+	    <envar>PATH</envar>. Git provides a convenient method to do this:
+	  </para>
+	  <screen>
+	    PATH=$(git --exec-path):$PATH
+	  </screen>
+	  <para>It is worth noting that <package>git</package> hooks are
 	    run with <command>$(git --exec-path)</command> in their
-	    PATH.
+	    <envar>PATH</envar>.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -814,9 +814,9 @@
 	<listitem>
 	  <para>
 	    Version 1.1.2 is included in Fedora 11 with a large number
-	    of new features. See the release notes for mercurial at
-	    <ulink type="http"
-	    url="http://www.selenic.com/mercurial/wiki/index.cgi/WhatsNew">http://www.selenic.com/mercurial/wiki/index.cgi/WhatsNew</ulink>.
+	    of new features. Refer to the release notes for
+	    <package>mercurial</package> at <ulink type="http"
+	    url="http://www.selenic.com/mercurial/wiki/index.cgi/WhatsNew"/>.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -825,7 +825,9 @@
 	<term>monotone</term>
 	<listitem>
 	  <para>
-	    <package>monotone</package> 0.42 includes the following changes: 
+	    In addition to a number of bugfixes, the new
+	    <package>monotone</package> 0.42 includes the following
+	    changes:
 	    <itemizedlist>
 	      <listitem>
 		<para>
@@ -839,16 +841,16 @@
 	      </listitem>
 	      <listitem>
 		<para>
-		  The French, Brazilian-Portuguese and Japanese
+		  The French, Brazilian-Portuguese, and Japanese
 		  translations were outdated and thus have been
 		  removed from the distribution. In case you care
 		  about them and want them back, drop us a note at
 		  <ulink type="mailto"
-		  url="mailto:monotone-devel at nongnu.org">monotone-devel at nongnu.org</ulink>.
+		  url="mailto:monotone-devel at nongnu.org"/>.
 		</para>
 	      </listitem>
 	    </itemizedlist>
-	    and the following new features: 
+	    ... and the following new features: 
 	    <itemizedlist>
 	      <listitem>
 		<para>
@@ -880,26 +882,27 @@
 	      </listitem>
 	      <listitem>
 		<para>
-		  New <command>automate lua</command> command with
-		  which <package>lua</package> functions, like
-		  <package>monotone</package> hooks, can be called
-		  over automate. This is particularly useful to get
-		  user defaults, like ignorable files, branch keys and
-		  passwords, which are managed through one or more
-		  monotonerc files.
+		  New <command>automate lua</command> command to call
+		  <package>lua</package> functions over
+		  <command>automate</command>, similar to
+		  <package>monotone</package> hooks. This is
+		  particularly useful to get user defaults, like
+		  ignorable files, branch keys and passwords, which
+		  are managed through one or more
+		  <filename>monotonerc</filename> files.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
 		  New <command>automate read_packets</command> command
-		  which reads data packets like public keys similar to
+		  that reads data packets like public keys similar to
 		  <command>mtn read</command>.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  <command>merge</command> and
-		  <command>propagate</command> accept user commit
+		  The <command>merge</command> and
+		  <command>propagate</command> commands accept user commit
 		  messages; the <command>merge rev rev</command> or
 		  <command>propagate branch branch</command> message
 		  will be prefixed to the user
@@ -908,7 +911,6 @@
 		</para>
 	      </listitem>
 	    </itemizedlist>
-	    as well as a number of bugfixes.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -921,103 +923,103 @@
 	    <itemizedlist>
 	      <listitem>
 		<para>
-		  allow prop commits on dirs with modified children
+		  Allow prop commits on dirs with modified children.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  make Cyrus auth implementation always prefer
-		  EXTERNAL to ANONYMOUS
+		  Make Cyrus auth implementation always prefer
+		  EXTERNAL to ANONYMOUS.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  do not create mergeinfo for wc-wc moves or copies 
+		  Do not create mergeinfo for wc-wc moves or copies 
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  do not autoupgrade old BDB filesystems to 1.5 or 1.4
+		  Do not autoupgrade old BDB filesystems to 1.5 or 1.4
 		  format
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  return mergeinfo to prior state during reverse
+		  Return mergeinfo to prior state during reverse
 		  merges
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  remove mergeinfo deleted by merge
+		  Remove mergeinfo deleted by merge
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  make proxy slaves pass through txn GET and PROPFIND
+		  Make proxy slaves pass through txn GET and PROPFIND
 		  requests
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  merge can now use targets with inconsistent
+		  Merge can now use targets with inconsistent
 		  newlines2
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  don't allow empty-string changelists
+		  Don't allow empty-string changelists
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  remove false positive <command>ra_neon</command>
+		  Remove false positive <command>ra_neon</command>
 		  mergeinfo errors
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  improve performance of <command>svn merge
+		  Improve performance of <command>svn merge
 		  --reintegrate</command>
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  fixed: foreign merges keep UUID of foreign
+		  Fixed: foreign merges keep UUID of foreign
 		  repository
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  fixed: properly encode diff headers used in conflict
+		  Fixed: properly encode diff headers used in conflict
 		  resolution
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  fixed: segfault in <command>svn cp --parents</command>
+		  Fixed: segfault in <command>svn cp --parents</command>
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  fixed: mergeinfo for '...' maps to empty revision
+		  Fixed: mergeinfo for '...' maps to empty revision
 		  range
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  fixed: segfault in BDB backend node-origins cache
+		  Fixed: segfault in BDB backend node-origins cache
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  fixed: broken merge if target's history includes
+		  Fixed: broken merge if target's history includes
 		  resurrections
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  fixed: invalid mergeinfo created on a subtree during
+		  Fixed: invalid mergeinfo created on a subtree during
 		  merge
 		</para>
 	      </listitem>
@@ -1030,17 +1032,17 @@
 	<term>svn2cl</term>
 	<listitem>
 	  <para>
-	    <package>svn2cl</package> has been updated to
+	    The <package>svn2cl</package> package has been updated to
 	    0.11. Changes since release 0.10:
 	    <itemizedlist>
 	      <listitem>
 		<para>
-		  small portability improvements 
+		  Small portability improvements.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  fix for OpenBSD's ksh 
+		  Fix for OpenBSD's ksh.
 		</para>
 	      </listitem>
 	    </itemizedlist>
@@ -1084,7 +1086,7 @@
 		  If your SVN repository has a structure that's
 		  functionally similar to trunk, branches, and tags
 		  but with different names, you can tell TkCVS about
-		  it by setting variables in tkcvs_def.tcl:
+		  it by setting variables in <filename>tkcvs_def.tcl</filename>:
 		  <itemizedlist>
 		    <listitem><para>cvscfg(svn_trunkdir)</para></listitem>
 		    <listitem><para>cvscfg(svn_branchdir)</para></listitem>
@@ -1111,8 +1113,7 @@
 	  <para>
 	    The AMQP specification has been updated to 1.0.738618
 	    reflecting recent work on the specification.  Project
-	    site: <ulink type="http"
-	    url="http://www.amqp.org">http://www.amqp.org</ulink>.
+	    site: <ulink type="http" url="http://www.amqp.org"/>.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -1122,10 +1123,10 @@
 	<term>binutils</term>
 	<listitem>
 	  <para>
-	    <package>binutils</package> has been updated to
-	    2.19.51.0.2. This is a minor update, see <ulink
+	    The <package>binutils</package> package has been updated to
+	    2.19.51.0.2. This is a minor update, refer to <ulink
 	    type="http"
-	    url="http://sources.redhat.com/binutils">http://sources.redhat.com/binutils</ulink>.
+	    url="http://sources.redhat.com/binutils"/>.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -1135,11 +1136,11 @@
 	<term>coccinelle (spatch)</term>
 	<listitem>
 	  <para>
-	    <package>coccinelle</package> enables semantic patches to
+	    The <package>coccinelle</package> package enables semantic patches to
 	    be written for C code, particularly Linux kernel patches.
 	  </para>
 	  <para>
-	    See the LWN article about semantic patching (<ulink
+	    Refer to the LWN article about semantic patching (<ulink
 	    type="http"
 	    url="http://lwn.net/Articles/315686/">http://lwn.net/Articles/315686/</ulink>)
 	    and the Coccinelle home page (<ulink type="http"
@@ -1158,31 +1159,31 @@
 	    <itemizedlist>
 	      <listitem>
 		<para>
-		  modify <command>cpp</command> command to redirect
-		  stderr to /dev/null if <command>-q</command> option
+		  Modified <command>cpp</command> command to redirect
+		  stderr to <filename>/dev/null</filename> if <command>-q</command> option
 		  is given, for consistency with the non-cpp mode
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  add <command>configure --disable-leaks</command>
+		  Added <command>configure --disable-leaks</command>
 		  option.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  use configure macro
+		  Use configure macro
 		  <command>CF_XOPEN_SOURCE</command> macro to make
-		  mkstemp() prototyped on Linux.
+		  <methodname>mkstemp()</methodname> prototyped on Linux.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  remove isascii() usage. 
+		  Removed <methodname>isascii()</methodname> usage. 
 		</para>
 	      </listitem>
 	    </itemizedlist>
-	    <ulink type="http" url="http://freshmeat.net/projects/cproto/">http://freshmeat.net/projects/cproto/</ulink> 
+	    <ulink type="http" url="http://freshmeat.net/projects/cproto/"/>
 	  </para>
 	</listitem>
       </varlistentry>
@@ -1192,12 +1193,12 @@
 	<term>elfutils</term>
 	<listitem>
 	  <para>
-	    <package>elfutils</package> has been updated to 0.140
+	    The <package>elfutils</package> package has been updated to 0.140
 	    (from 0.137). In addition to a number of bug fixes, it
 	    adds Intel SSE4 disassembler support and automatic
-	    decompression of ELF files. For the full story, see the
+	    decompression of ELF files. For the full story, refer to the
 	    NEWS file at <ulink type="http"
-	    url="http://fedorahosted.org/elfutils/browser/NEWS">http://fedorahosted.org/elfutils/browser/NEWS</ulink>.
+	    url="http://fedorahosted.org/elfutils/browser/NEWS"/>.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -1210,9 +1211,9 @@
 	    Fedora 11 includes <package>libtool</package> 2.2.6, which
 	    is a complete rewrite of the version 1.5 in Fedora 10. The
 	    upstream project has released a number of interim versions
-	    which were not reflected in Fedora. For a complete
-	    history, see <ulink type="http"
-	    url="http://www.gnu.org/software/libtool/news.html">http://www.gnu.org/software/libtool/news.html</ulink>.
+	    that were not reflected in Fedora. For a complete
+	    history, refer to <ulink type="http"
+	    url="http://www.gnu.org/software/libtool/news.html"/>.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -1222,7 +1223,7 @@
 	<term>livecd-tools</term>
 	<listitem>
 	  <para>
-	    <package>livecd-tools</package> version 021 includes a
+	    The <package>livecd-tools</package> version 021 includes a
 	    number of bug fixes and corrects some oversights,
 	    including support for ext4 filesystems and creating large
 	    ISOs using UDF.
@@ -1237,7 +1238,7 @@
 	  <para>
 	    Version 2.6.8 of <package>mcrypt</package> is largely a
 	    source code cleanup and should not affect
-	    functionality. See the NEWS file for details.
+	    functionality. Refer to the NEWS file for details.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -1248,14 +1249,13 @@
 	<listitem>
 	  <para>
 	    <package>scons</package> 1.2.0 is a minor upgrade to
-	    1.0.0. See <ulink type="http"
-	    url="http://www.scons.org/CHANGES.txt">http://www.scons.org/CHANGES.txt</ulink>
-	    for a detailed list of changes.
+	    1.0.0. Refer to <ulink type="http"
+	    url="http://www.scons.org/CHANGES.txt"/> for a detailed
+	    list of changes.
 	  </para>
 	</listitem>
       </varlistentry>
 
-
       <varlistentry>
 	<term>srecord</term>
 	<listitem>
@@ -1279,10 +1279,10 @@
 	      </listitem>
 	      <listitem>
 		<para>
-		  The <command>-minimum</command> and
-		  <command>-maximum</command> options have been
-		  renamed <command>-minimum-address</command> and
-		  <command>-maximum-address</command>, to avoid a
+		  The <option>-minimum</option> and
+		  <option>-maximum</option> options have been renamed
+		  <option>-minimum-address</option> and
+		  <option>-maximum-address</option>, to avoid a
 		  command line grammar syntax problem.
 		</para>
 	      </listitem>
@@ -1296,7 +1296,7 @@
 	<term>swig</term>
 	<listitem>
 	  <para>
-	    <package>swig</package> is a package which connects
+	    The <package>swig</package> package connects
 	    C/C++/Objective C to some high-level programming
 	    languages. Fedora 11 includes version 1.3.38 with a number
 	    of changes:
@@ -1304,29 +1304,29 @@
 	      <listitem>
 		<para>
 		  Enhancement to directors to wrap all protected
-		  members
+		  members.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  Optimization feature for objects returned by value
+		  Optimization feature for objects returned by value.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
 		  A few bugs fixes in the PHP, Java, Ruby, R, C#,
-		  Python, Lua and Perl modules
+		  Python, Lua, and Perl modules.
 		</para>
 	      </listitem>
 	      <listitem>
 		<para>
-		  Other minor generic bug fixes
+		  Other minor generic bug fixes.
 		</para>
 	      </listitem>
 	    </itemizedlist>
 
-	    Project site: (<ulink type="http"
-	    url="http://swig.sourceforge.net/">http://swig.sourceforge.net/</ulink>)
+	    Project site: <ulink type="http"
+	    url="http://swig.sourceforge.net/"/>
 	  </para>
 	</listitem>
       </varlistentry>
@@ -1336,9 +1336,9 @@
 	<term>translate-toolkit</term>
 	<listitem>
 	  <para>
-	    <package>translate-toolkit</package> has been updated to
-	    1.3.0. There are a large number of changes which affect
-	    specific languages. See the ChangeLog file for full
+	    The <package>translate-toolkit</package> has been updated to
+	    1.3.0. There are a large number of changes that affect
+	    specific languages. Refer to the ChangeLog file for full
 	    details.
 	  </para>
 	</listitem>





More information about the Fedora-docs-commits mailing list