[PATCH] Replace a few "literal" tags with "firstterm".

[email protected] ("Robert P. J. Day") Sun, 28 Feb 2010 07:07:03 -0500 (EST)
Newsgroups php.pear.doc
Message-ID <alpine.LFD.2.00.1002280703330.3472@localhost>
A number of early phrases that are currently tagged as "literal" are
more properly (semantically) tagged as "firstterm".

Signed-off-by: Robert P. J. Day <[email protected]>

---

  this is just the first part of the re-tagging of literals to
firstterms where appropriate.  more submissions coming as i work my
way further into the manual, but i'll at least try to do it a section
at a time.


Index: en/guide/users/concepts/filerole.xml
===================================================================
--- en/guide/users/concepts/filerole.xml	(revision 295576)
+++ en/guide/users/concepts/filerole.xml	(working copy)
@@ -4,8 +4,8 @@
  <info><title>File roles</title></info>

  <para>
-  Pyrus and The PEAR Installer categorize file types by their <literal>role</literal>.
-  A file role is equivalent to the web's concept of <literal>MIME type</literal>,
+  Pyrus and The PEAR Installer categorize file types by their <firstterm>role</firstterm>.
+  A file role is equivalent to the web's concept of <firstterm>MIME type</firstterm>,
   a concept that allows web browsers to determine how a file should be displayed
   or processed.  A file role allows Pyrus and the PEAR Installer to determine
   where a file should be installed, the conditions under which the role can be
Index: en/guide/users/concepts/maintainer.xml
===================================================================
--- en/guide/users/concepts/maintainer.xml	(revision 295576)
+++ en/guide/users/concepts/maintainer.xml	(working copy)
@@ -4,9 +4,9 @@
  <info><title>Maintainers and maintainer roles</title></info>

  <para>
-  PEAR and PEAR2 calls its developers <literal>maintainers</literal>, and
+  PEAR and PEAR2 call their developers <firstterm>maintainers</firstterm>, and
   classifies maintainers by their level of contribution to a package, or
-  their <literal>role</literal>.  In addition, each maintainer must choose a
+  their <firstterm>role</firstterm>.  In addition, each maintainer must choose a
   handle which can be used to refer
   to them in package.xml and in bug reports.  A handle is an alphanumeric
   word with all lower-cased letters such as <literal>cellog</literal>
@@ -15,8 +15,8 @@
   to log into the website.
  </para>
  <para>
-  Developer roles are <literal>lead</literal>, <literal>developer</literal>,
-  <literal>contributor</literal> and <literal>helper</literal>.  Only lead
+  Developer roles are <firstterm>lead</firstterm>, <firstterm>developer</firstterm>,
+  <firstterm>contributor</firstterm> and <firstterm>helper</firstterm>.  Only lead
   maintainers have the permission to release a package.  Both lead and
   developer maintainers may create and modify package roadmaps, and
   all developers can directly log into pear.php.net and change the status of
Index: en/guide/users/concepts/package.xml
===================================================================
--- en/guide/users/concepts/package.xml	(revision 295576)
+++ en/guide/users/concepts/package.xml	(working copy)
@@ -4,7 +4,7 @@

  <para>
   The smallest unit that can be managed by Pyrus or the PEAR Installer is
-  a <literal>package</literal>.  A package is a collection of files
+  a <firstterm>package</firstterm>.  A package is a collection of files
   that are organized and defined by a meta-information file called
   <link linkend="guide.developers.package2.intro">package.xml</link>.
  </para>


rday
--

========================================================================
Robert P. J. Day                               Waterloo, Ontario, CANADA

            Linux Consulting, Training and Kernel Pedantry.

Web page:                                          http://crashcourse.ca
Twitter:                                       http://twitter.com/rpjday
========================================================================