DocBook tags: <literal> versus <firstterm>
[email protected] ("Robert P. J. Day") Thu, 25 Feb 2010 09:24:42 -0500 (EST)
| Newsgroups | php.pear.doc |
|---|---|
| Message-ID | <alpine.LFD.2.00.1002250921420.10615@localhost> |
working my way thru the PEAR manual, and i've already noticed a few
examples of the introduction of a new term being tagged as <literal>
rather than <firstterm>. proposed fix as output of "svn diff":
Index: en/guide/users/concepts/package.xml
===================================================================
--- en/guide/users/concepts/package.xml (revision 295501)
+++ 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>
to be semantically proper, things like that really should be
<firstterm>, should they not? is there any rendering problem with
using <firstterm> in cases like that?
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Kernel Pedantry.
Web page: http://crashcourse.ca
Twitter: http://twitter.com/rpjday
========================================================================