documentation-guide/en_US acknowledgments.xml, 1.4, 1.5 emacs-nxml.xml, 1.1, 1.2 emacs.xml, 1.1, 1.2 module-struct.xml, 1.1, 1.2 style.xml, 1.1, 1.2 tutorial.xml, 1.1, 1.2 vim.xml, 1.1, 1.2 writing-guidelines.xml, 1.1, 1.2 xml-tags.xml, 1.1, 1.2

Karsten Wade (kwade) fedora-docs-commits at redhat.com
Sat Feb 3 22:29:39 UTC 2007


Author: kwade

Update of /cvs/docs/documentation-guide/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv32490

Modified Files:
	acknowledgments.xml emacs-nxml.xml emacs.xml module-struct.xml 
	style.xml tutorial.xml vim.xml writing-guidelines.xml 
	xml-tags.xml 
Log Message:
updating all section usage and associated ID tags


Index: acknowledgments.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/en_US/acknowledgments.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- acknowledgments.xml	17 Dec 2006 00:41:55 -0000	1.4
+++ acknowledgments.xml	3 Feb 2007 22:29:37 -0000	1.5
@@ -36,14 +36,14 @@
 
     <para>
       A patch from Karsten Wade (kwade at redhat.com) has been applied to add
-      <xref linkend="s1-screenshots"></xref>. It was edited by Paul
+      <xref linkend="sn-screenshots"></xref>. It was edited by Paul
       W. Frields (stickstr5 at hotmail.com).
   </para>
 
     <para>
       A patch from Paul W. Frields (stickstr5 at hotmail.com) has been applied
       to add more explanation of the <command>screen</command> tag set to <xref
-      linkend="s1-xml-tags-screen"></xref>.
+      linkend="sn-xml-tags-screen"></xref>.
     </para>
 
     <para>


Index: emacs-nxml.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/en_US/emacs-nxml.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- emacs-nxml.xml	3 Feb 2007 22:21:58 -0000	1.1
+++ emacs-nxml.xml	3 Feb 2007 22:29:37 -0000	1.2
@@ -39,12 +39,12 @@
       when using it with other documents types. If you keep an eye on the
       mailing-list, you can keep up to date with these, as well as ask
       questions. For more details, check out <xref
-	linkend="s1-emacs-nxml-readme"></xref>.
+	linkend="sn-emacs-nxml-readme"></xref>.
     </para>
   </note>
 
     
-  <sect1 id="s1-nxml-rpm">
+  <section id="sn-nxml-rpm">
     <title>Getting the nXML RPM</title>
 
     <indexterm>
@@ -68,12 +68,12 @@
 
     <para>
 	Information on where to get the source is available in <xref
-        linkend="s1-emacs-additional-resources"></xref>.
+        linkend="sn-emacs-additional-resources"></xref>.
     </para>
       
-  </sect1>
+  </section>
 
-  <sect1 id="s1-nxml-examples">
+  <section id="sn-nxml-examples">
     <title>Examples</title>
       
     <para>
@@ -82,7 +82,7 @@
       which means you can concentrate more on the content of your article.
     </para>
 
-    <sect2 id="s2-nxml-commands">
+    <section id="sn-nxml-commands">
       <title>Commands</title>
 	
       <para>
@@ -117,13 +117,13 @@
 	  using <application>Emacs</application> with PSGML mode and
 	  <application>Emacs</application> with nXML mode. You will still need
 	  to use all the same commands as discussed in <xref
-	    linkend="s1-emacs-basic-commands"></xref>.
+	    linkend="sn-emacs-basic-commands"></xref>.
 	</para>
       </tip>
-    </sect2>
-  </sect1>
+    </section>
+  </section>
 
-  <sect1 id="s1-emacs-nxml-additional-resources">
+  <section id="sn-emacs-nxml-additional-resources">
     <title>Additional Resources</title>
 
     <para> Additional Emacs and nXML references are available at the following
@@ -151,9 +151,9 @@
 	</para>
       </listitem>
     </itemizedlist>
-  </sect1>
+  </section>
 
-  <sect1 id="s1-emacs-nxml-readme">
+  <section id="sn-emacs-nxml-readme">
     <title>nXML README File</title>
 
     <note>
@@ -336,5 +336,5 @@
     <para>
       jjc at thaiopensource.com
     </para>
-  </sect1>
+  </section>
   </chapter>


Index: emacs.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/en_US/emacs.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- emacs.xml	3 Feb 2007 22:21:58 -0000	1.1
+++ emacs.xml	3 Feb 2007 22:29:37 -0000	1.2
@@ -30,7 +30,7 @@
       and more.
     </para>
     
-    <sect1 id="s1-emacs-file">
+    <section id="sn-emacs-file">
       <title>Setting Up Your <filename>.emacs</filename> File</title>
 
       <indexterm>
@@ -224,10 +224,10 @@
 
 -->
 
-    </sect1>   
+    </section>   
 
 
-     <sect1 id="s1-emacs-colors">
+     <section id="sn-emacs-colors">
       <title>Customizing Emacs</title>
 
       <indexterm>
@@ -293,9 +293,9 @@
 	place.
       </para>
       
-    </sect1>   
+    </section>   
   
-    <sect1 id="s1-emacs-cedfile">
+    <section id="sn-emacs-cedfile">
       <title>Create Recompiled DTD Subset</title>
   
       <para>
@@ -358,9 +358,9 @@
 	</para>
       </tip>
       
-    </sect1>
+    </section>
 
-    <sect1 id="s1-emacs-loadced">
+    <section id="sn-emacs-loadced">
       <title>Load the Parsed DTD</title>
       
       <para>
@@ -404,9 +404,9 @@
 	</para>
       </tip>
 
-    </sect1>
+    </section>
     
-    <sect1 id="s1-emacs-basic-commands">
+    <section id="sn-emacs-basic-commands">
       <title>Basic Emacs Commands</title>
       
       <para>
@@ -563,9 +563,9 @@
 	</tgroup>
       </table>
 
-    </sect1>
+    </section>
 
-    <sect1 id="s1-emacs-examples">
+    <section id="sn-emacs-examples">
       <title>Examples</title>
 
       <para>
@@ -573,7 +573,7 @@
 	for beginners. This section provides some examples of how to use them.
       </para>
 
-      <sect2 id="s2-emacs-tag-completion">
+      <section id="sn-emacs-tag-completion">
 	<title>Tag Completion</title>
 
 	<note>
@@ -623,8 +623,8 @@
 </computeroutput>
 </screen>
 
-      </sect2>
-      <sect2 id="s2-emacs-tag-closing">
+      </section>
+      <section id="sn-emacs-tag-closing">
 	<title>Tag Closure</title>
 
 	<para>
@@ -634,9 +634,9 @@
 	<keycap>/</keycap>. This will close the closest open tag you have.
       </para>
       
-      </sect2>
+      </section>
 
-      <sect2 id="s2-emacs-other">
+      <section id="sn-emacs-other">
 	<title>Other Emacs Tasks</title>
 
 	<para>
@@ -680,11 +680,11 @@
 	  it will prompt you to save the file, otherwise it will just quit the
 	  current emacs session you have been working with.
 	</para>
-      </sect2>
+      </section>
       
-    </sect1>
+    </section>
 
-    <sect1 id="s1-emacs-additional-resources">
+    <section id="sn-emacs-additional-resources">
       <title>Additional Resources</title>
 
       <para> Additional Emacs and PSGML references are available at the
@@ -722,7 +722,7 @@
 	</listitem>
       </itemizedlist>
 
-    </sect1>
+    </section>
   </chapter>
   
   


Index: module-struct.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/en_US/module-struct.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- module-struct.xml	3 Feb 2007 22:21:58 -0000	1.1
+++ module-struct.xml	3 Feb 2007 22:29:37 -0000	1.2
@@ -318,7 +318,7 @@
 	  class="extension">.JPG</filename> images into <filename
 	class="extension">.PNG</filename> format.  For more information
 	on formatting images such as screenshots, refer to <xref
-	linkend="s1-screenshots"/>.
+	linkend="sn-screenshots"/>.
       </para>
       <para>
         Image files may be organized into subdirectories under


Index: style.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/en_US/style.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- style.xml	3 Feb 2007 22:21:58 -0000	1.1
+++ style.xml	3 Feb 2007 22:29:37 -0000	1.2
@@ -942,7 +942,7 @@
                 Do not use angle brackets to indicate variables in text,
 		instead use the <sgmltag
 		  class="starttag">replaceable</sgmltag> tag. Refer to
-		<xref linkend="s1-xml-tags-replaceable"/> for
+		<xref linkend="sn-xml-tags-replaceable"/> for
 		information about using this tag.
               </para>
             </listitem>


Index: tutorial.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/en_US/tutorial.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- tutorial.xml	3 Feb 2007 22:21:58 -0000	1.1
+++ tutorial.xml	3 Feb 2007 22:29:37 -0000	1.2
@@ -19,7 +19,7 @@
     be used, and an entity to change the version and date of the tutorial.
   </para>
   
-    <sect1 id="s1-tutorial-parent">
+    <section id="sn-tutorial-parent">
       <title>The Parent File</title>
       
       <para>
@@ -64,7 +64,7 @@
     &lt;title&gt;Some Section&lt;/title&gt;
 
     &lt;para&gt;
-      This is an example section. You can also use sect1, sect2, etc.
+      This is an example section. You can also use section, section, etc.
     &lt;/para&gt;
 
     &lt;warning&gt;
@@ -81,9 +81,9 @@
 </computeroutput>
 </screen>
 
-    </sect1>
+    </section>
 
-    <sect1 id="s1-tutorial-license">
+    <section id="sn-tutorial-license">
       <title>Including the License Information</title>
     
       <indexterm>
@@ -101,7 +101,7 @@
 	The sample parent file shows how it is included.
       </para>
       
-    </sect1>
+    </section>
     
   </chapter>
 


Index: vim.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/en_US/vim.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- vim.xml	3 Feb 2007 22:21:58 -0000	1.1
+++ vim.xml	3 Feb 2007 22:29:37 -0000	1.2
@@ -26,7 +26,7 @@
       <userinput>:help tutor</userinput> from inside VIM.
     </para>
     
-    <sect1 id="s1-vimrc-file">
+    <section id="sn-vimrc-file">
       <title>Setting Up Your <filename>.vimrc</filename> File</title>
 
       <indexterm>
@@ -63,9 +63,9 @@
       Vim.org</ulink> and load it separately.
       </para>
       </note>
-    </sect1>
+    </section>
 
-    <sect1 id="s1-vim-keymapping">
+    <section id="sn-vim-keymapping">
       <title>Keymapping with VIM</title>
       
       <para>
@@ -86,7 +86,7 @@
 
 " common tags that start a new text block
 imap<leader>pa <para><cr></para><esc>O
-imap<leader>s1 <sect1 id=""><cr><para><esc>jo</sect1><esc>O
+imap<leader>sn <section id=""><cr><para><esc>jo</section><esc>O
 imap<leader>pl <programlisting><cr></programlisting><esc>O<esc>0i
 imap<leader>cp <computeroutput></computeroutput><esc>O<esc>0i
 
@@ -111,11 +111,11 @@
       Unfortunately, there is not currently a complete macro set for all
       DocBook commands, so you will need to define them yourself or customize
       the definitions in the examples from <xref
-      linkend="s1-vim-additional-resources"></xref>.
+      linkend="sn-vim-additional-resources"></xref>.
       </para>
-    </sect1>
+    </section>
 
-    <sect1 id="s1-vim-additional-resources">
+    <section id="sn-vim-additional-resources">
       <title>Additional VIM Resources</title>
 
       <para>
@@ -152,5 +152,5 @@
 	
       </itemizedlist>
 
-    </sect1>
+    </section>
   </chapter>


Index: writing-guidelines.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/en_US/writing-guidelines.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- writing-guidelines.xml	3 Feb 2007 22:21:58 -0000	1.1
+++ writing-guidelines.xml	3 Feb 2007 22:29:37 -0000	1.2
@@ -29,7 +29,7 @@
   <para>Please read this chapter carefully. This chapter describes the
     guidelines that must be followed such as naming conventions.</para>
 
-  <sect1 id="s1-xml-guidelines-naming">
+  <section id="sn-xml-guidelines-naming">
     <title>ID Naming Conventions</title>
 
     <indexterm>
@@ -87,7 +87,7 @@
       name (minus the <command>"ch-"</command>) in its ID. For example,
       you are working with the <command>"ch-intro"</command> chapter and
       need to create your first section on disk partitions. That section
-      ID would look similar to <command>"s1-intro-partition"</command>
+      ID would look similar to <command>"sn-intro-partition"</command>
       which contains the section number, the main chapter ID, and a
       unique ID for that section.</para>
 
@@ -117,12 +117,12 @@
 	    <entry><computeroutput>sn-</computeroutput></entry>
 	  </row>
 	  <row>
-	    <entry><command>sect1</command></entry>
-	    <entry><computeroutput>s1-</computeroutput></entry>
+	    <entry><command>section</command></entry>
+	    <entry><computeroutput>sn-</computeroutput></entry>
 	  </row>
 	  <row>
-	    <entry><command>sect2</command></entry>
-	    <entry><computeroutput>s2-</computeroutput></entry>
+	    <entry><command>section</command></entry>
+	    <entry><computeroutput>sn-</computeroutput></entry>
 	  </row>
 	  <row>
 	    <entry><command>sect3</command></entry>
@@ -156,9 +156,9 @@
       </tgroup>
     </table>
 
-  </sect1>
+  </section>
   
-  <sect1 id="s1-xml-guidelines-header">
+  <section id="sn-xml-guidelines-header">
     <title>File Header</title>
 
     <para>All the files must contain the CVS Id header. If you create a
@@ -172,9 +172,9 @@
 
     <screen><![CDATA[<!-- $Id$ -->]]></screen>
 
-  </sect1>
+  </section>
 
-  <sect1 id="s1-xml-admon">
+  <section id="sn-xml-admon">
     <title>Admonitions</title>
 
     <indexterm>
@@ -244,7 +244,7 @@
       mandate that Warnings be reserved for cases where bodily harm can
       result.</para>
       
-    <sect2 id="s2-xml-notesetc">
+    <section id="sn-xml-notesetc">
       <title>Creating Notes, Tips, Cautions, Importants, and
 	Warnings</title>
 
@@ -342,11 +342,11 @@
 	<title>Warning</title> 
 	<para>Body of text goes here.</para>
       </warning>
-    </sect2>
+    </section>
 
-  </sect1>
+  </section>
 
-  <sect1 id="s1-screenshots">
+  <section id="sn-screenshots">
     <title>Screenshots</title>
 
     <indexterm>
@@ -453,7 +453,7 @@
 	    </step>
 	  </procedure>
 	  <para>For more information about calling the images from the
-	    XML, refer to <xref linkend="s1-xml-tags-figure"/>.</para>
+	    XML, refer to <xref linkend="sn-xml-tags-figure"/>.</para>
 	</listitem>
       </varlistentry>
       <varlistentry>
@@ -500,14 +500,14 @@
  8032 pts/1    S      0:00 ssh root at backup.example.com</computeroutput></screen>
 	  </example>
 	  <para>For more information about using screen, refer to <xref
-	      linkend="s1-xml-tags-screen"/>.</para>
+	      linkend="sn-xml-tags-screen"/>.</para>
 	</listitem>
       </varlistentry>
     </variablelist>
-  </sect1>
+  </section>
 
 <!-- 
-  <sect1 id="s1-diagrams-images">
+  <section id="sn-diagrams-images">
     <title>Diagrams and Images</title>
     
     <indexterm>
@@ -522,7 +522,7 @@
 	To be written
       </para>
 
-    </sect1>	
+    </section>	
 -->
 
 </chapter>


Index: xml-tags.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/en_US/xml-tags.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- xml-tags.xml	3 Feb 2007 22:21:58 -0000	1.1
+++ xml-tags.xml	3 Feb 2007 22:29:37 -0000	1.2
@@ -55,7 +55,7 @@
 </computeroutput>
 </screen>
 
-    <sect1 id="s1-xml-tags-caveats">
+    <section id="sn-xml-tags-caveats">
       <title>Tags and Entities Caveats</title>
 
       <indexterm>
@@ -149,9 +149,9 @@
 	</varlistentry>
       </variablelist>
 
-    </sect1>
+    </section>
 
-      <sect1 id="s1-xml-tags-application">
+      <section id="sn-xml-tags-application">
       <title><command>application</command></title>
 
 	<indexterm>
@@ -185,9 +185,9 @@
 	or <application>lynx</application> if you only want a text-based browser.
       </para>
 
-      </sect1>
+      </section>
 
-      <sect1 id="s1-xml-tags-chapter">
+      <section id="sn-xml-tags-chapter">
       <title><command>chapter</command></title>
 
 	<indexterm>
@@ -215,15 +215,15 @@
 
       <para>
 	The chapter can also be further divided into sections
-	(<command>sect1</command>, <command>sect2</command>,
+	(<command>section</command>, <command>section</command>,
 	<command>sect3</command>, etc.). Refer to <xref
-	linkend="s1-xml-tags-sections"></xref> for details.
+	linkend="sn-xml-tags-sections"></xref> for details.
       </para>
 
-    </sect1>
+    </section>
 
 
-      <sect1 id="s1-xml-tags-citetitle">
+      <section id="sn-xml-tags-citetitle">
       <title><command>citetitle</command></title>
 
 	<indexterm>
@@ -255,9 +255,9 @@
 	entity.
       </para>
 
-      </sect1>
+      </section>
 
-      <sect1 id="s1-xml-tags-command">
+      <section id="sn-xml-tags-command">
       <title><command>command</command></title>
 
 	<indexterm>
@@ -340,9 +340,9 @@
 	</listitem>
       </itemizedlist>
 
-      </sect1>
+      </section>
 
-      <sect1 id="s1-xml-tags-compoutput">
+      <section id="sn-xml-tags-compoutput">
       <title><command>computeroutput</command></title>
 
 	<indexterm>
@@ -365,9 +365,9 @@
       <para>
 	<computeroutput>Do you really want to delete this file? y n</computeroutput>
       </para>
-    </sect1>
+    </section>
 
-    <sect1 id="s1-xml-tags-emphasis">
+    <section id="sn-xml-tags-emphasis">
       <title><command>emphasis</command></title>
       
       <indexterm>
@@ -396,9 +396,9 @@
 	partitions on <emphasis>all</emphasis> hard drives in your system;
 	non-Linux partitions will not be removed.
       </para>
-    </sect1>
+    </section>
     
-    <sect1 id="s1-xml-tags-example">
+    <section id="sn-xml-tags-example">
       <title><command>example</command></title>
 
 	<indexterm>
@@ -449,10 +449,10 @@
 </screen>
 	</example>
 
-    </sect1>
+    </section>
 
     
-    <sect1 id="s1-xml-tags-filename">
+    <section id="sn-xml-tags-filename">
       <title><command>filename</command></title>
       
       <indexterm>
@@ -502,9 +502,9 @@
 	</para>
       </note>
 
-    </sect1>
+    </section>
 
-    <sect1 id="s1-xml-tags-firstterm">
+    <section id="sn-xml-tags-firstterm">
       <title><command>firstterm</command></title>
 
       <indexterm>
@@ -534,9 +534,9 @@
 	  partitions</firstterm>, and &FC; is no exception.
       </para>
 
-    </sect1>
+    </section>
 
-    <sect1 id="s1-xml-tags-footnote">
+    <section id="sn-xml-tags-footnote">
       <title><command>footnote</command></title>
       
       <indexterm>
@@ -572,9 +572,9 @@
 	<citetitle>Installation Guide</citetitle>.
       </para>
 
-    </sect1>
+    </section>
 
-    <sect1 id="s1-xml-tags-figure">
+    <section id="sn-xml-tags-figure">
       <title><command>figure</command></title>
 
       <indexterm>
@@ -635,12 +635,12 @@
 
       <para>
 	For more information on taking screenshots, refer to <xref
-	linkend="s1-screenshots"/>.
+	linkend="sn-screenshots"/>.
       </para>
 
-    </sect1>
+    </section>
 
-    <sect1 id="s1-xml-tags-gui">
+    <section id="sn-xml-tags-gui">
       <title>GUI Tags</title>
       
       <indexterm>
@@ -648,7 +648,7 @@
 	<secondary>GUI tags</secondary>
       </indexterm>
       
-      <sect2 id="s2-xml-tags-guilabel">
+      <section id="sn-xml-tags-guilabel">
 	<title><command>guilabel</command></title>
 	
 	<indexterm>
@@ -682,9 +682,9 @@
 	  The <guilabel>Authentication Configuration</guilabel> screen shows you how to
 	  make your system more secure.
 	</para>
-      </sect2>
+      </section>
 
-      <sect2 id="s2-xml-tags-guibutton">
+      <section id="sn-xml-tags-guibutton">
 	<title><command>guibutton</command></title>
 	
 	<indexterm>
@@ -718,9 +718,9 @@
 	  Check the <guibutton>Activate on boot</guibutton> button to have the X
 	  Window System start automatically.
 	</para>
-      </sect2>
+      </section>
       
-      <sect2 id="s2-xml-tags-guiicon">
+      <section id="sn-xml-tags-guiicon">
 	<title><command>guiicon</command></title>
 	
 	<indexterm>
@@ -752,9 +752,9 @@
 	  Double-click the <guiicon>Start Here</guiicon> icon on the desktop.
 	</para>
 
-	</sect2>
+	</section>
 
-      <sect2 id="s2-xml-tags-guimenu">
+      <section id="sn-xml-tags-guimenu">
 	<title><command>guimenu</command> and
 	  <command>guimenuitem</command></title>
 
@@ -811,10 +811,10 @@
 	  <guimenuitem>Emacs</guimenuitem> to start the
 	  <application>Emacs</application> text editor.
 	</para>
-      </sect2>
-    </sect1>
+      </section>
+    </section>
     
-    <sect1 id="s1-xml-tags-keycap">
+    <section id="sn-xml-tags-keycap">
       <title><command>keycap</command></title>
 
       <indexterm>
@@ -842,7 +842,7 @@
 	To make your selection, press the <keycap>Enter</keycap> key.
       </para>
       
-      <sect2 id="s2-xml-tags-menuchoice">
+      <section id="sn-xml-tags-menuchoice">
 	<title><command>menuchoice</command></title>
 	
 	<indexterm>
@@ -887,9 +887,9 @@
 	  </menuchoice>.
 	</para>
 
-      </sect2>
+      </section>
 
-      <sect2 id="s2-xml-tags-keycombo">
+      <section id="sn-xml-tags-keycombo">
 	<title><command>keycombo</command></title>
 	
 	<indexterm>
@@ -922,11 +922,11 @@
 	  </keycombo>.
 	</para>
 
-	</sect2>
+	</section>
 
-    </sect1>
+    </section>
 
-    <sect1 id="s1-xml-tags-lists">
+    <section id="sn-xml-tags-lists">
       <title>Lists</title>
       
       <indexterm>
@@ -944,7 +944,7 @@
       <para>The sections below will discuss the proper uses for the various
 	list and how to create them.</para>
 
-      <sect2 id="s2-xml-tags-itemizedlist">
+      <section id="sn-xml-tags-itemizedlist">
 	<title><command>itemizedlist</command></title>
 	
 	<indexterm>
@@ -1016,9 +1016,9 @@
 	  </listitem> 
 	</itemizedlist> 
 		  
-      </sect2>
+      </section>
 
-      <sect2 id="s2-xml-tags-orderedlist">
+      <section id="sn-xml-tags-orderedlist">
 	<title><command>OrderedList</command></title>
 	  
 	<indexterm>
@@ -1103,9 +1103,9 @@
 	  </listitem>
 	</orderedlist>
 	
-      </sect2>
+      </section>
 
-      <sect2 id="s2-xml-tags-varlist">
+      <section id="sn-xml-tags-varlist">
 	<title><command>Variablelist</command></title>
 	
 	<indexterm>
@@ -1198,9 +1198,9 @@
 	  </para>
 	</warning>
 
-      </sect2>
+      </section>
       
-      <sect2 id="s2-xml-tags-simplelist">
+      <section id="sn-xml-tags-simplelist">
 	<title>Creating a List Within a Table Using <command>Simplelist</command></title>
 	
 	<indexterm>
@@ -1381,9 +1381,9 @@
 	<para>For each paragraph or list item to be added within a
 	  <command>SimpleList</command>, the &lt;member&gt; tag set must be
 	  added around that particular text item.</para>
-      </sect2>
+      </section>
       
-      <sect2 id="s2-xml-tags-glossary">
+      <section id="sn-xml-tags-glossary">
 	<title><command>glosslist</command></title>
 	
 	<indexterm>
@@ -1467,11 +1467,11 @@
 	  </glossentry>
 	</glosslist>
 	
-      </sect2>
-    </sect1>
+      </section>
+    </section>
 
    
-    <sect1 id="s1-xml-tags-option">
+    <section id="sn-xml-tags-option">
       <title><command>option</command></title>
       
       <indexterm>
@@ -1507,9 +1507,9 @@
       <para>For example, with the command <command>ls</command> you can
 	specify an option such as <option>-la</option>.</para>
       
-    </sect1>
+    </section>
 
-    <sect1 id="s1-xml-tags-indexing">
+    <section id="sn-xml-tags-indexing">
       <title>Index Entries</title>
 
 	<indexterm>
@@ -1620,9 +1620,9 @@
 	true by default.
 	</para>
 
-    </sect1>
+    </section>
 
-    <sect1 id="s1-xml-tags-para">
+    <section id="sn-xml-tags-para">
       <title><command>para</command></title>
       
       
@@ -1662,9 +1662,9 @@
 	</listitem>
       </itemizedlist>
       
-    </sect1>
+    </section>
 
-    <sect1 id="s1-xml-tags-part">
+    <section id="sn-xml-tags-part">
       <title><command>part</command></title>
 
 	<indexterm>
@@ -1717,9 +1717,9 @@
 	information about the part is on a separate page.
       </para>
 
-    </sect1>
+    </section>
 
-    <sect1 id="s1-xml-tags-prompt">
+    <section id="sn-xml-tags-prompt">
       <title><command>prompt</command></title>
       
       <indexterm>
@@ -1761,9 +1761,9 @@
 	  (unless the command or prompt is the actually computer output you want
 	  to show).</para>
       </note>
-    </sect1>
+    </section>
 
-    <sect1 id="s1-xml-tags-replaceable">
+    <section id="sn-xml-tags-replaceable">
       <title><command>replaceable</command></title>
       
       <indexterm>
@@ -1792,9 +1792,9 @@
 <screen>
 foo-<replaceable>version-number</replaceable>.<replaceable>arch</replaceable>.rpm
 </screen>
-    </sect1>
+    </section>
 
-    <sect1 id="s1-xml-tags-screen">
+    <section id="sn-xml-tags-screen">
       <title><command>screen</command></title>
       <indexterm>
 	<primary>XML tags</primary>
@@ -1862,7 +1862,7 @@
 within this command.
 </screen>
 
-    <sect2 id="s2-xml-tags-screen-inline-tags">
+    <section id="sn-xml-tags-screen-inline-tags">
       <title>Using Inline Tags with <command>screen</command></title>
       <para>
 	If you choose to use inline tags inside a
@@ -1958,13 +1958,13 @@
 	<para>
 	  For an explanation of how to use the <command>replaceable</command>
 	  tags within a set of <command>screen</command> tags, refer to <xref
-	  linkend="s1-xml-tags-replaceable"></xref>.
+	  linkend="sn-xml-tags-replaceable"></xref>.
 	</para>
 
-      </sect2>
-    </sect1>
+      </section>
+    </section>
 
-      <sect1 id="s1-xml-tags-sections">
+      <section id="sn-xml-tags-sections">
 	<title>Sections</title>
 
 	<indexterm>
@@ -1978,7 +1978,7 @@
 
     <para>Within an article (or chapter if it is a DocBook XML book like the
 	<citetitle>&IG;</citetitle>), you can have sections and
-	subsections. <command>&lt;sect1&gt;</command> is always the highest
+	subsections. <command>&lt;section&gt;</command> is always the highest
 	section and you cannot have two sections of the same level within one
 	another (a section 2 can be created within a section 1, but section 1
 	has to be closed before another section 1 can be created). The general
@@ -1986,14 +1986,14 @@
 	  
 <screen>
 <computeroutput>
-&lt;sect1 id="s1-uniquename"&gt;
+&lt;section id="sn-uniquename"&gt;
   &lt;title&gt;Insert Title Here&lt;/title&gt;
   &lt;para&gt;
     Body text goes here.
   &lt;/para&gt;
 
 
-  &lt;sect2 id="s2-uniquename"&gt;
+  &lt;section id="sn-uniquename"&gt;
     &lt;title&gt;Insert Title Here&lt;/title&gt;
     &lt;para&gt;
       Body text goes here.
@@ -2007,9 +2007,9 @@
 
     &lt;/sect3&gt;
 
-  &lt;/sect2&gt;
+  &lt;/section&gt;
 
-&lt;/sect1&gt;
+&lt;/section&gt;
 </computeroutput>
 </screen>
     
@@ -2034,9 +2034,9 @@
 &lt;/section&gt;
 </computeroutput>
 </screen>
-    </sect1>
+    </section>
 
-    <sect1 id="s1-xml-tags-table">
+    <section id="sn-xml-tags-table">
       <title><command>table</command></title>
       
       <indexterm>
@@ -2155,7 +2155,7 @@
 	</tgroup> 
       </table> 
       
-      <sect2 id="s2-xml-tags-listintable">
+      <section id="sn-xml-tags-listintable">
 	<title>Creating a List Within a Table</title>
 	
 	<indexterm>
@@ -2290,11 +2290,11 @@
 	  </tgroup>
 	</table>
 	
-      </sect2>
+      </section>
       
-    </sect1>
+    </section>
 
-    <sect1 id="s1-xml-tags-trademark">
+    <section id="sn-xml-tags-trademark">
       <title><command>trademark</command></title>
 
       <indexterm>
@@ -2320,9 +2320,9 @@
 </computeroutput>
 </screen>
       
-    </sect1>
+    </section>
     
-    <sect1 id="s1-xml-tags-userinput">
+    <section id="sn-xml-tags-userinput">
       <title><command>userinput</command></title>
 
       <indexterm>
@@ -2353,10 +2353,10 @@
       <para>
 	<userinput>dd if=boot.img of=/dev/fd0 bs=1440k</userinput>
       </para>
-    </sect1>
+    </section>
 
 
-<!--      <sect1 id="s1-xml-tags-mouse">
+<!--      <section id="sn-xml-tags-mouse">
 	<title><command>mousebutton</command></title>
 
 	<indexterm>
@@ -2375,9 +2375,9 @@
 <mousebutton>Right click</mousebutton> on the image and a new menu will appear.
  </para>
 
-      </sect1> -->
+      </section> -->
 
-    <sect1 id="s1-xml-tag-sulink">
+    <section id="sn-xml-tag-sulink">
       <title><command>ulink</command></title>
       
       <indexterm>
@@ -2416,9 +2416,9 @@
 	</para>
       </note>
 
-    </sect1>
+    </section>
     
-    <sect1 id="s1-xml-tags-wordasword">
+    <section id="sn-xml-tags-wordasword">
       <title><command>wordasword</command></title>
       
       <indexterm>
@@ -2462,10 +2462,10 @@
 	meaning to the content. It can be replaced with any other word without
 	losing any of the context.</para>
       
-    </sect1>
+    </section>
     
 
-    <sect1 id="s1-xml-tags-xref">
+    <section id="sn-xml-tags-xref">
       <title><command>xref</command></title>
       
       <indexterm>
@@ -2485,7 +2485,7 @@
 <screen>
 <computeroutput>
 For more information about the parent file, refer to
-&lt;xref linkend="ch-tutorial"&gt;&lt;/xref&gt; and &lt;xref linkend="s1-tutorial-parent"&gt;&lt;/xref&gt;
+&lt;xref linkend="ch-tutorial"&gt;&lt;/xref&gt; and &lt;xref linkend="sn-tutorial-parent"&gt;&lt;/xref&gt;
 </computeroutput>
 </screen>
 
@@ -2495,9 +2495,9 @@
 
       <para>
 	For more information about the parent file, refer to <xref linkend="ch-tutorial"></xref>
-	and <xref linkend="s1-tutorial-parent"></xref>.
+	and <xref linkend="sn-tutorial-parent"></xref>.
       </para>
-    </sect1>
+    </section>
 
   </chapter>
 




More information about the docs-commits mailing list