From b1fcb0abc8a9d3dfa2d481dbde7797d8f520451f Mon Sep 17 00:00:00 2001
From: "mbarnson%sisna.com"
 <mbarnson%sisna.com@18797224-902f-48f8-a5cc-f745e15eee43>
Date: Tue, 5 Nov 2002 04:07:18 +0000
Subject: [PATCH] Added information about versioncache back in. See bug 140332

git-svn-id: svn://10.0.0.236/trunk@132998 18797224-902f-48f8-a5cc-f745e15eee43
---
 .../webtools/bugzilla/docs/sgml/database.sgml | 26 +++++++++++++++++++
 .../webtools/bugzilla/docs/xml/database.xml   | 26 +++++++++++++++++++
 2 files changed, 52 insertions(+)

diff --git a/mozilla/webtools/bugzilla/docs/sgml/database.sgml b/mozilla/webtools/bugzilla/docs/sgml/database.sgml
index f0cda458937..ae1918207cd 100644
--- a/mozilla/webtools/bugzilla/docs/sgml/database.sgml
+++ b/mozilla/webtools/bugzilla/docs/sgml/database.sgml
@@ -8,6 +8,32 @@
     tables to document dependencies. Any takers?</para>
   </note>
 
+  <section id="dbmodify">
+      <title>Modifying Your Running System</title>
+
+      <para>Bugzilla optimizes database lookups by storing all relatively
+      static information in the 
+      <filename>versioncache</filename> file, located in the 
+      <filename class="directory">data/</filename>
+      subdirectory under your installation directory.</para>
+
+      <para>If you make a change to the structural data in your database (the
+      versions table for example), or to the 
+      <quote>constants</quote>
+
+      encoded in <filename>defparams.pl</filename>, you will need to remove 
+      the cached content from the data directory (by doing a 
+      <quote>rm data/versioncache</quote>
+
+      ), or your changes won't show up.</para>
+
+      <para> <filename>versioncache</filename> 
+      gets automatically regenerated whenever it's more than
+      an hour old, so Bugzilla will eventually notice your changes by itself,
+      but generally you want it to notice right away, so that you can test
+      things.</para>
+    </section>
+
   <section id="dbdoc">
     <title>MySQL Bugzilla Database Introduction</title>
 
diff --git a/mozilla/webtools/bugzilla/docs/xml/database.xml b/mozilla/webtools/bugzilla/docs/xml/database.xml
index f0cda458937..ae1918207cd 100644
--- a/mozilla/webtools/bugzilla/docs/xml/database.xml
+++ b/mozilla/webtools/bugzilla/docs/xml/database.xml
@@ -8,6 +8,32 @@
     tables to document dependencies. Any takers?</para>
   </note>
 
+  <section id="dbmodify">
+      <title>Modifying Your Running System</title>
+
+      <para>Bugzilla optimizes database lookups by storing all relatively
+      static information in the 
+      <filename>versioncache</filename> file, located in the 
+      <filename class="directory">data/</filename>
+      subdirectory under your installation directory.</para>
+
+      <para>If you make a change to the structural data in your database (the
+      versions table for example), or to the 
+      <quote>constants</quote>
+
+      encoded in <filename>defparams.pl</filename>, you will need to remove 
+      the cached content from the data directory (by doing a 
+      <quote>rm data/versioncache</quote>
+
+      ), or your changes won't show up.</para>
+
+      <para> <filename>versioncache</filename> 
+      gets automatically regenerated whenever it's more than
+      an hour old, so Bugzilla will eventually notice your changes by itself,
+      but generally you want it to notice right away, so that you can test
+      things.</para>
+    </section>
+
   <section id="dbdoc">
     <title>MySQL Bugzilla Database Introduction</title>