diff options
Diffstat (limited to 'prologue/typography.xml')
| -rw-r--r-- | prologue/typography.xml | 12 |
1 files changed, 8 insertions, 4 deletions
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><REPLACED TEXT></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><program + name></replaceable></command> is generally sufficient.</para> </sect1> |