- Added entries for PRAGMAs database_list, temp_store and default_temp_store.

jplyon · jplyon · commit 3aacc84e45d1 · 2003-05-07T04:04:17.000Z
- Fixed missing end tags. (CVS 960)

FossilOrigin-Name: 55ae7b35ee2dcebc99256d4b1e22a87ea75e3d03
diff --git a/manifest b/manifest
@@ -1,5 +1,5 @@
-C Cleaned\sup\skeywords\ssection.\s(CVS\s959)
-D 2003-05-07T03:59:10
+C -\sAdded\sentries\sfor\sPRAGMAs\sdatabase_list,\stemp_store\sand\sdefault_temp_store.\n-\sFixed\smissing\send\stags.\s(CVS\s960)
+D 2003-05-07T04:04:17
 F Makefile.in 004acec253ecdde985c8ecd5b7c9accdb210378f
 F Makefile.linux-gcc b86a99c493a5bfb402d1d9178dcdc4bd4b32f906
 F README f1de682fbbd94899d50aca13d387d1b3fd3be2dd
@@ -155,7 +155,7 @@ F www/faq.tcl 12d1788d4abcfe1ff3054e17605df2418883bf6f
 F www/fileformat.tcl d9b586416c0d099b82e02e469d532c9372f98f3f
 F www/formatchng.tcl cbaf0f410096c71f86a7537cf9249fa04b9a659c
 F www/index.tcl b155eba45136d19e7aa6ba979d4093180c335cf7
-F www/lang.tcl 46b42bd1b22c6e18c17ebfe3893da57790761b79
+F www/lang.tcl bbd268bb1251c94062896d5bdb4beca19bc0ea1f
 F www/mingw.tcl d96b451568c5d28545fefe0c80bee3431c73f69c
 F www/nulls.tcl 29497dac2bc5b437aa7e2e94577dad4d8933ed26
 F www/omitted.tcl 118062f40a203fcb88b8d68ef1d7c0073ac191ec
@@ -165,7 +165,7 @@ F www/speed.tcl cb4c10a722614aea76d2c51f32ee43400d5951be
 F www/sqlite.tcl ffde644361e1d8e2a44a235ff23ad3b43d640df2
 F www/tclsqlite.tcl 1db15abeb446aad0caf0b95b8b9579720e4ea331
 F www/vdbe.tcl 2013852c27a02a091d39a766bc87cff329f21218
-P 6d4b6597e560578253960d9876dc8c8657f41fef
-R 7baf27040092074ad3a30cf620346b84
+P bb609f96e00fd62d932601c4aa37bc17baa82257
+R dda10c19cfdf488f535f7dc535754b7d
 U jplyon
-Z cc6c263b53146ffd7c6d10d64ce2f2b8
+Z c9d5bf00e4e436e976c07b135d71d6fc
diff --git a/manifest.uuid b/manifest.uuid
@@ -1 +1 @@
-bb609f96e00fd62d932601c4aa37bc17baa82257
+55ae7b35ee2dcebc99256d4b1e22a87ea75e3d03
diff --git a/www/lang.tcl b/www/lang.tcl
@@ -1,7 +1,7 @@
 #
 # Run this Tcl script to generate the sqlite.html file.
 #
-set rcsid {$Id: lang.tcl,v 1.54 2003/05/07 03:59:10 jplyon Exp $}
+set rcsid {$Id: lang.tcl,v 1.55 2003/05/07 04:04:17 jplyon Exp $}
 
 puts {<html>
 <head>
@@ -1188,6 +1188,7 @@ with caution.</p>
 <p>The current implementation supports the following pragmas:</p>
 
 <ul>
+<a name="pragma_cache_size"></a>
 <li><p><b>PRAGMA cache_size;
        <br>PRAGMA cache_size = </b><i>Number-of-pages</i><b>;</b></p>
     <p>Query or change the maximum number of database disk pages that SQLite
@@ -1199,8 +1200,8 @@ with caution.</p>
     <p>When you change the cache size using the cache_size pragma, the
     change only endures for the current session.  The cache size reverts
     to the default value when the database is closed and reopened.  Use
-    the <b>default_cache_size</b> pragma to check the cache size permanently
-    </p></li>
+    the <a href="#pragma_default_cache_size"><b>default_cache_size</b></a> 
+    pragma to check the cache size permanently.</p></li>
 
 <li><p><b>PRAGMA count_changes = ON;
        <br>PRAGMA count_changes = OFF;</b></p>
@@ -1210,15 +1211,25 @@ with caution.</p>
     <p>This pragma may be removed from future versions of SQLite.
     Consider using the <b>sqlite_changes()</b> API function instead.</p></li>
 
+<li><p><b>PRAGMA database_list;</b></p>
+    <p>For each open database, invoke the callback function once with
+    information about that database.  Arguments include the index and 
+    the name the datbase was attached with.  The first row will be for 
+    the main database.  The second row will be for the database used to 
+    store temporary tables.</p></li>
+
+<a name="pragma_default_cache_size"></a>
 <li><p><b>PRAGMA default_cache_size;
        <br>PRAGMA default_cache_size = </b><i>Number-of-pages</i><b>;</b></p>
     <p>Query or change the maximum number of database disk pages that SQLite
     will hold in memory at once.  Each page uses about 1.5K of memory.
-    This pragma works like the <b>cache_size</b> pragma with the addition
+    This pragma works like the <a href="#pragma_cache_size"><b>cache_size</b></a> 
+    pragma with the additional
     feature that it changes the cache size persistently.  With this pragma,
     you can set the cache size once and that setting is retained and reused
     everytime you reopen the database.</p></li>
 
+<a name="pragma_default_synchronous"></a>
 <li><p><b>PRAGMA default_synchronous;
        <br>PRAGMA default_synchronous = FULL;
        <br>PRAGMA default_synchronous = NORMAL;
@@ -1247,10 +1258,28 @@ with caution.</p>
     </p>
     <p>This pragma changes the synchronous mode persistently.  Once changed,
     the mode stays as set even if the database is closed and reopened.  The
-    <b>synchronous</b> pragma does the same thing but only applies the setting
-    to the current session.</p>
+    <a href="#pragma_synchronous"><b>synchronous</b></a> pragma does the same 
+    thing but only applies the setting to the current session.</p></li>
+
+<a name="pragma_default_temp_store"></a>
+<li><p><b>PRAGMA default_temp_store;
+       <br>PRAGMA default_temp_store = DEFAULT;
+       <br>PRAGMA default_temp_store = MEMORY;
+       <br>PRAGMA default_temp_store = FILE;</b></p>
+    <p>Query or change the setting of the "temp_store" flag stored in
+    the database.  When temp_store is DEFAULT, the compile-time default 
+    is used for the temporary database.  When temp_store is MEMORY, an 
+    in-memory database is used.  When temp_store is FILE, a temporary 
+    database file on disk will be used.  Note that it is possible for 
+    the library compile-time options to override this setting.  Once 
+    the temporary database is in use, its location cannot be changed.</p>
+
+    <p>This pragma changes the temp_store mode persistently.  Once changed,
+    the mode stays as set even if the database is closed and reopened.  The
+    <a href="#pragma_temp_store"><b>temp_store</b></a> pragma does the same 
+    thing but only applies the setting to the current session.</p></li>
 
-<a name="pragma_empty_result_callbacks">
+<a name="pragma_empty_result_callbacks"></a>
 <li><p><b>PRAGMA empty_result_callbacks = ON;
        <br>PRAGMA empty_result_callbacks = OFF;</b></p>
     <p>When on, the EMPTY_RESULT_CALLBACKS pragma causes the callback
@@ -1259,7 +1288,7 @@ with caution.</p>
     because there is no data to report.  But the second "<b>argc</b>" and
     fourth "<b>columnNames</b>" parameters are valid and can be used to
     determine the number and names of the columns that would have been in
-    the result set had the set not been empty.</p>
+    the result set had the set not been empty.</p></li>
 
 <li><p><b>PRAGMA full_column_names = ON;
        <br>PRAGMA full_column_names = OFF;</b></p>
@@ -1272,28 +1301,28 @@ with caution.</p>
     <p>For each column that the named index references, invoke the 
     callback function
     once with information about that column, including the column name,
-    and the column number.</p>
+    and the column number.</p></li>
 
 <li><p><b>PRAGMA index_list(</b><i>table-name</i><b>);</b></p>
     <p>For each index on the named table, invoke the callback function
     once with information about that index.  Arguments include the
     index name and a flag to indicate whether or not the index must be
-    unique.</p>
-
-<li><p><b>PRAGMA parser_trace = ON;<br>PRAGMA parser_trace = OFF;</b></p>
-    <p>Turn tracing of the SQL parser inside of the
-    SQLite library on and off.  This is used for debugging.
-    This only works if the library is compiled without the NDEBUG macro.
-    </p></li>
+    unique.</p></li>
 
 <li><p><b>PRAGMA integrity_check;</b></p>
     <p>The command does an integrity check of the entire database.  It
     looks for out-of-order records, missing pages, and malformed records.
     If any problems are found, then a single string is returned which is
     a description of all problems.  If everything is in order, "ok" is
-    returned.</p>
+    returned.</p></li>
 
-<a name="pragma_show_datatypes">
+<li><p><b>PRAGMA parser_trace = ON;<br>PRAGMA parser_trace = OFF;</b></p>
+    <p>Turn tracing of the SQL parser inside of the
+    SQLite library on and off.  This is used for debugging.
+    This only works if the library is compiled without the NDEBUG macro.
+    </p></li>
+
+<a name="pragma_show_datatypes"></a>
 <li><p><b>PRAGMA show_datatypes = ON;<br>PRAGMA show_datatypes = OFF;</b></p>
     <p>When turned on, the SHOW_DATATYPES pragma causes extra entries containing
     the names of <a href="datatypes.html">datatypes</a> of columns to be
@@ -1325,22 +1354,38 @@ with caution.</p>
        azCol[6] = 0;
     </td></table></blockquote></li>
 
+<a name="pragma_synchronous"></a>
 <li><p><b>PRAGMA synchronous;
        <br>PRAGMA synchronous = FULL;
        <br>PRAGMA synchronous = NORMAL;
        <br>PRAGMA synchronous = OFF;</b></p>
-    <p>Query or change the setting of the "synchronous" flag in
-    the database for the duration of the current database connect.
+    <p>Query or change the setting of the "synchronous" flag affecting
+    the database for the duration of the current database connection.
     The synchronous flag reverts to its default value when the database
     is closed and reopened.  For additional information on the synchronous
-    flag, see the description of the <b>default_synchronous</b> pragma.</p>
+    flag, see the description of the <a href="#pragma_default_synchronous">
+    <b>default_synchronous</b></a> pragma.</p>
     </li>
 
 <li><p><b>PRAGMA table_info(</b><i>table-name</i><b>);</b></p>
     <p>For each column in the named table, invoke the callback function
     once with information about that column, including the column name,
     data type, whether or not the column can be NULL, and the default
-    value for the column.</p>
+    value for the column.</p></li>
+
+<a name="pragma_temp_store"></a>
+<li><p><b>PRAGMA temp_store;
+       <br>PRAGMA temp_store = default;
+       <br>PRAGMA temp_store = memory;
+       <br>PRAGMA temp_store = file;</b></p>
+    <p>Query or change the setting of the "temp_store" flag affecting
+    the database for the duration of the current database connection.
+    The temp_store flag reverts to its default value when the database
+    is closed and reopened.  For additional information on the temp_store
+    flag, see the description of the <a href="#pragma_default_temp_store">
+    <b>default_temp_store</b></a> pragma.  Note that it is possible for 
+    the library compile-time options to override this setting. </p>
+    </li>
 
 <li><p><b>PRAGMA vdbe_trace = ON;<br>PRAGMA vdbe_trace = OFF;</b></p>
     <p>Turn tracing of the virtual database engine inside of the

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-bb609f96e00fd62d932601c4aa37bc17baa82257`
	`1`	`+55ae7b35ee2dcebc99256d4b1e22a87ea75e3d03`