summaryrefslogtreecommitdiffstats
path: root/en_US/writing-guidelines.xml
diff options
context:
space:
mode:
Diffstat (limited to 'en_US/writing-guidelines.xml')
-rw-r--r--en_US/writing-guidelines.xml85
1 files changed, 37 insertions, 48 deletions
diff --git a/en_US/writing-guidelines.xml b/en_US/writing-guidelines.xml
index 6249a11..f6bf7ed 100644
--- a/en_US/writing-guidelines.xml
+++ b/en_US/writing-guidelines.xml
@@ -87,54 +87,43 @@
<figure id="fig-redhat-config-kickstart-basic">]]></screen>
</example>
- <table id="tb-id-two-char-naming-conventions">
+ <segmentedlist id="sg-id-two-char-naming-conventions">
<title>Two-Character Naming Conventions</title>
-
- <tgroup cols="2">
- <colspec colnum="1" colname="tag"/>
- <colspec colnum="2" colname="prefix"/>
- <thead>
- <row>
- <entry>Tag</entry>
- <entry>Prefix</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><sgmltag class="element">preface</sgmltag></entry>
- <entry><literal>pr-</literal></entry>
- </row>
- <row>
- <entry><sgmltag class="element">chapter</sgmltag></entry>
- <entry><literal>ch-</literal></entry>
- </row>
- <row>
- <entry><sgmltag class="element">section</sgmltag></entry>
- <entry><literal>sn-</literal></entry>
- </row>
- <row>
- <entry><sgmltag class="element">figure</sgmltag></entry>
- <entry><literal>fig-</literal></entry>
- </row>
- <row>
- <entry><sgmltag class="element">table</sgmltag></entry>
- <entry><literal>tb-</literal></entry>
- </row>
- <row>
- <entry><sgmltag class="element">appendix</sgmltag></entry>
- <entry><literal>ap-</literal></entry>
- </row>
- <row>
- <entry><sgmltag class="element">part</sgmltag></entry>
- <entry><literal>pt-</literal></entry>
- </row>
- <row>
- <entry><sgmltag class="element">example</sgmltag></entry>
- <entry><literal>ex-</literal></entry>
- </row>
- </tbody>
- </tgroup>
- </table>
+ <segtitle>Tag</segtitle>
+ <segtitle>Prefix</segtitle>
+ <seglistitem>
+ <seg><sgmltag class="element">preface</sgmltag></seg>
+ <seg><literal>pr-</literal></seg>
+ </seglistitem>
+ <seglistitem>
+ <seg><sgmltag class="element">chapter</sgmltag></seg>
+ <seg><literal>ch-</literal></seg>
+ </seglistitem>
+ <seglistitem>
+ <seg><sgmltag class="element">section</sgmltag></seg>
+ <seg><literal>sn-</literal></seg>
+ </seglistitem>
+ <seglistitem>
+ <seg><sgmltag class="element">figure</sgmltag></seg>
+ <seg><literal>fig-</literal></seg>
+ </seglistitem>
+ <seglistitem>
+ <seg><sgmltag class="element">table</sgmltag></seg>
+ <seg><literal>tb-</literal></seg>
+ </seglistitem>
+ <seglistitem>
+ <seg><sgmltag class="element">appendix</sgmltag></seg>
+ <seg><literal>ap-</literal></seg>
+ </seglistitem>
+ <seglistitem>
+ <seg><sgmltag class="element">part</sgmltag></seg>
+ <seg><literal>pt-</literal></seg>
+ </seglistitem>
+ <seglistitem>
+ <seg><sgmltag class="element">example</sgmltag></seg>
+ <seg><literal>ex-</literal></seg>
+ </seglistitem>
+ </segmentedlist>
<para>Use the title of the item as the ID. Make your titles unique
within a document to prevent conflicts. For example:</para>
@@ -262,7 +251,7 @@
committed to CVS) the line is updated automatically to include
information about the file. For example:</para>
- <screen><![CDATA[<!-- $Id: writing-guidelines.xml,v 1.6 2007/02/18 22:59:19 pfrields Exp $ -->]]></screen>
+ <screen><![CDATA[<!-- $Id: writing-guidelines.xml,v 1.7 2007/03/08 03:00:44 pfrields Exp $ -->]]></screen>
</section>