From c362dc235e1b893290623b28fe9eb9b50c8a270e Mon Sep 17 00:00:00 2001
From: Alan Coopersmith <alan.coopersmith@oracle.com>
Date: Fri, 10 Jan 2014 23:34:48 -0800
Subject: spec: fixup markup/formatting of the naming syntax section

Use <replaceable> <literal> <optional> etc. tags instead of
&lt;&gt; "" and [] pairs.

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
---
 specs/fsproto.xml | 35 ++++++++++++++++++-----------------
 1 file changed, 18 insertions(+), 17 deletions(-)

diff --git a/specs/fsproto.xml b/specs/fsproto.xml
index 8172d15..a38e910 100644
--- a/specs/fsproto.xml
+++ b/specs/fsproto.xml
@@ -262,24 +262,24 @@ X Consortium.
 <!-- .XE -->
 <para>
 The following syntax should be used for TCP/IP names:
-</para>
 
 <literallayout class="monospaced">
-    &lt;TCP name&gt;  ::=  "tcp/" &lt;hostname&gt;":" &lt;ipportnumber&gt; ["/" &lt;cataloguelist&gt;]
+    <replaceable>TCP name</replaceable>  ::=  <literal>tcp/</literal> <replaceable>hostname</replaceable> <literal>:</literal> <replaceable>ipportnumber</replaceable> <optional><literal>/</literal> <replaceable>cataloguelist</replaceable></optional>
 </literallayout>
 
-<para>
-where &lt;hostname&gt; is either symbolic (such as expo.lcs.mit.edu) or numeric
-decimal (such as 18.30.0.212).  The &lt;ipportnumber&gt; is the port on
-which the
-font server is listening for connections.  The &lt;cataloguelist&gt; string at
+where <replaceable>hostname</replaceable> is either symbolic (such as
+<systemitem class="systemname">expo.lcs.mit.edu</systemitem>) or numeric
+decimal (such as <systemitem class="ipaddress">18.30.0.212</systemitem>).
+The <replaceable>ipportnumber</replaceable> is the port on which the
+font server is listening for connections.
+The <replaceable>cataloguelist</replaceable> string at
 the end is optional and specifies a plus-separated list of catalogues
 that may be requested.  For example:
-</para>
 <literallayout class="monospaced">
      tcp/expo.lcs.mit.edu:8012/available+special
      tcp/18.30.0.212:7890
 </literallayout>
+</para>
 </section>
 
 <section id='DECnet_Names'>
@@ -290,25 +290,26 @@ that may be requested.  For example:
 <para>
 <!-- .LP -->
 The following syntax should be used for DECnet names:
-</para>
+
 <literallayout class="monospaced">
-    &lt;DECnet name&gt;  ::=  "decnet/" &lt;nodename&gt; "::font$" &lt;objname&gt;
-               ["/" &lt;cataloguelist&gt;]
+    <replaceable>DECnet name</replaceable>  ::=  <literal>decnet/</literal> <replaceable>nodename</replaceable> <literal>::font$</literal> <replaceable>objname</replaceable> <optional><literal>/</literal> <replaceable>cataloguelist</replaceable></optional>
 </literallayout>
-<para>
-where &lt;nodename&gt; is either symbolic (such as SRVNOD) or the
-numeric decimal
-form of the DECnet address (such as 44.70).  The &lt;objname&gt; is normal,
-case-insensitive DECnet object name.  The &lt;cataloguelist&gt; string
+
+where <replaceable>nodename</replaceable> is either symbolic (such as
+<systemitem class="systemname">SRVNOD</systemitem>) or the
+numeric decimal form of the DECnet address (such as
+<systemitem class="ipaddress">44.70</systemitem>).
+The <replaceable>objname</replaceable> is normal, case-insensitive DECnet
+object name.  The <replaceable>cataloguelist</replaceable> string
 at the end is
 optional and specifies a plus-separated list of catalogues that may be
 requested.  For example:
-</para>
 
 <literallayout class="monospaced">
      DECNET/SRVNOD::FONT$DEFAULT/AVAILABLE
      decnet/44.70::font$other
 </literallayout>
+</para>
 </section>
 </chapter>
 
-- 
cgit v1.2.3