From 0090db5c7b0cb69fc9c06da99ad868814414d2b0 Mon Sep 17 00:00:00 2001
From: Manuel Canales Esparcia <manuel@linuxfromscratch.org>
Date: Fri, 14 Apr 2006 09:37:17 +0000
Subject: Changed typography convections.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7516 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
---
 prologue/typography.xml | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

(limited to 'prologue/typography.xml')

diff --git a/prologue/typography.xml b/prologue/typography.xml
index ddafff780..ab884840d 100644
--- a/prologue/typography.xml
+++ b/prologue/typography.xml
@@ -49,10 +49,14 @@ EOF</userinput></screen>
   is encountered. Therefore, this entire section is generally typed as
   seen.</para>
 
-  <para><replaceable>[REPLACED TEXT]</replaceable></para>
+  <para><replaceable>&lt;REPLACED TEXT&gt;</replaceable></para>
 
   <para>This format is used to encapsulate text that is not to be typed
-  as seen or copied-and-pasted.</para>
+  as seen or for copy-and-paste operations.</para>
+
+  <para><replaceable>[OPTIONAL TEXT]</replaceable></para>
+
+  <para>This format is used to encapsulate text that is optional.</para>
 
   <para><filename>passwd(5)</filename></para>
 
@@ -70,8 +74,8 @@ EOF</userinput></screen>
   <filename>/usr/share/man/man1/passwd.1</filename>. For this example, you will
   need to run <command>man 5 passwd</command> in order to read the specific page
   being referred to. It should be noted that most man pages do not have duplicate
-  page names in different sections. Therefore, <command>man <replaceable>[program
-  name]</replaceable></command> is generally sufficient.</para>
+  page names in different sections. Therefore, <command>man <replaceable>&lt;program
+  name&gt;</replaceable></command> is generally sufficient.</para>
 
 </sect1>
 
-- 
cgit v1.2.3-54-g00ecf