Add section about cleaning up web cvs repository.

Make column headings better on table.

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196324 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/src/documentation/content/xdocs/dev/doc.xml b/src/documentation/content/xdocs/dev/doc.xml
index 5e9d8d5a89281c7b24e36d9975b2b64fc5914f77..c58ea80f4aa4ac4c9e177dbaa8981193a5c57e0e 100644 (file)
--- a/src/documentation/content/xdocs/dev/doc.xml
+++ b/src/documentation/content/xdocs/dev/doc.xml
@@ -27,10 +27,10 @@ Maintenance branch releases either copy the trunk content to the maintenance bra
         <p>The following table summarizes the flow of data to the FOP website in chronological order:</p>
         <table>
           <tr>
-            <th>Processes</th>
-            <th>Files</th>
+            <th>Process</th>
+            <th>Output</th>
             <th>State</th>
-            <th>Views</th>
+            <th>View(s)</th>
           </tr>
           <tr>
             <td>Developer commits code to FOP repository.</td>
@@ -119,12 +119,17 @@ It will fail in a headless environment when it tries to use FOP to generate the
       </section>
       <section id="web-manual">
         <title>Updating the FOP Web Repository Manually (Deprecated)</title>
-        <warning>The steps in this section should not ordinarily be used. They are documented here for historical reasons, and for emergencies.</warning>
+        <warning>The steps in this section should not ordinarily be used. They are documented here for historical reasons, and for emergencies.
+See <link href="#delete">manually deleting retired files</link> for an exception to this rule.</warning>
         <ul>
           <li>Copy (or sym-link) the documents generated by Forrest (in xml-fop/build/site) to xml-site/targets/fop on your local machine.</li>
           <li>Commit xml-site/targets/fop.</li>
         </ul>
       </section>
+      <section id="delete">
+        <title>Deleting Documentation Files</title>
+        <p>The one place where manual updates of the web cvs repository are required is when a document is retired. At this point, it will no longer be generated. However, it will still exist in the web cvs repository. You will need to use a cvs client to remove the files, then commit the changes to keep them from continuing to exist on the live site.</p>
+      </section>
     </section>
   </body>
 </document>