[phpBT-dev] CVS: phpbt/docs/sgml primer.sgml,1.2,1.3

[Benjamin C. <bc...@us...>]

Update of /cvsroot/phpbt/phpbt/docs/sgml
In directory usw-pr-cvs1:/tmp/cvs-serv648/sgml

Modified Files:
	primer.sgml 
Log Message:
Learn DocBook in 1,267 easy steps!  Added screenshot elements around the screen shots

Index: primer.sgml
===================================================================
RCS file: /cvsroot/phpbt/phpbt/docs/sgml/primer.sgml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- primer.sgml	2001/10/03 13:38:06	1.2
+++ primer.sgml	2001/10/08 01:59:15	1.3
@@ -13,7 +13,9 @@
     <title>Entering a bug</title>
 
     <para>Once you have logged in to the system you can follow the <emphasis role="bold">Enter Bug</emphasis> link from the top navigation bar to create a new bug.  If there is more than one project for which you can submit a bug, you will be prompted to choose one.</para>
-
+    
+    <screenshot>
+      <screeninfo>Project selection</screeninfo>
     <mediaobject>
       <imageobject>
 	<imagedata fileref="images/shots/user/enterbug-chooseproject.png" format="PNG" align="center">
@@ -27,10 +29,16 @@
       <textobject>
 	<phrase>Screen shot of selecting a project for a bug report.</phrase>
       </textobject>
+	<caption>
+	  <para>Selecting a project for a bug report.</para>
+	</caption>
     </mediaobject>
+    </screenshot>
  
     <para>Once you have chosen a project, or if there is only one project in the system, you will see the bug entry page.  The <emphasis role="bold">Version</emphasis> and <emphasis role="bold">Component</emphasis> fields allow you to specify details about which part or version of the product that produces this bug.  The <emphasis role="bold">Summary</emphasis> field should be a short but specific summary of the problem, while the <emphasis role="bold">Description</emphasis> field should include details about the behavior observed, how that behavior differs from expected behavior, and the steps to reproduce the problem.  If the product being tested is web-based, you can use the <emphasis role="bold">URL</emphasis> field to provide a link directly to the problem.  The <emphasis role="bold">Add another</emphasis> checkbox, if checked, will present another bug entry form when you submit a bug, instead of taking you to the bug list.</para>
 
+    <screenshot>
+      <screeninfo>Adding a bug</screeninfo>
     <mediaobject>
       <imageobject>
 	<imagedata fileref="images/shots/user/enterbug-detail.png" format="PNG" align="center">
@@ -44,6 +52,9 @@
       <textobject>
 	<phrase>Screen shot of entering a bug report.</phrase>
       </textobject>
+	<caption>
+	  <para>Entering a bug report.</para>
+	</caption>
     </mediaobject>
 
     <para>That's it!  The bug has been entered, and it's ready to be reviewed and fixed by the developers.</para>