From: drh <drh@noemail.net>
Date: Fri, 15 Jun 2007 12:16:31 +0000 (+0000)
Subject: Documentation updates in preparation for 3.4.0. (CVS 4064)
X-Git-Tag: version-3.6.10~2110
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=711ffd8c7641741a5cb456f3bcecc0f563f710d2;p=thirdparty%2Fsqlite.git

Documentation updates in preparation for 3.4.0. (CVS 4064)

FossilOrigin-Name: 5232fd29d01d48d70b6d8f34ad5d0e2dde115fa0
---

diff --git a/VERSION b/VERSION
index e9f0bde544..18091983f5 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-3.3.17
+3.4.0
diff --git a/manifest b/manifest
index e1b4b26e8f..788a793a1c 100644
--- a/manifest
+++ b/manifest
@@ -1,9 +1,9 @@
-C Update\sthe\sbtree\sfile\sformat\sdescription\sin\sbtreeInt.h.\s(CVS\s4063)
-D 2007-06-15T12:06:59
+C Documentation\supdates\sin\spreparation\sfor\s3.4.0.\s(CVS\s4064)
+D 2007-06-15T12:16:31
 F Makefile.in b9971ab07868cf2b3209fe3bf8c52e7e25af4193
 F Makefile.linux-gcc 2d8574d1ba75f129aba2019f0b959db380a90935
 F README 9c4e2d6706bdcc3efdd773ce752a8cdab4f90028
-F VERSION 6de5e9812c227f00155cb59af3535017aef3e258
+F VERSION bd995b15c92d73ccf2f3e65d51702f88efea8001
 F aclocal.m4 d20ba55930a05197b484809fba1d2b603f4e67a6
 F addopcodes.awk 701697fae48376375ec8532c3d04e910cfeef352
 F art/2005osaward.gif 0d1851b2a7c1c9d0ccce545f3e14bca42d7fd248
@@ -460,7 +460,7 @@ F www/autoinc.tcl b357f5ba954b046ee35392ce0f884a2fcfcdea06
 F www/c_interface.tcl b51b08591554c16a0c3ef718364a508ac25abc7e
 F www/capi3.tcl 88884dd743039d1a95aa57f4a5eb369de7744716
 F www/capi3ref.tcl 167c2d5b45da22d77b2493b00d44b001b4ec83b1
-F www/changes.tcl 550300b0ff00fc1b872f7802b2d5a1e7587d3e58
+F www/changes.tcl eddb6708265031c163bd3ce63cddf03914c9380d
 F www/common.tcl 2b793e5c31486c8a01dd27dc0a631ad93704438e
 F www/compile.tcl 276546d7eb445add5a867193bbd80f6919a6b084
 F www/conflict.tcl cdd0f4b59b0ba6d61f67e6a38f3ae45853bacb30
@@ -479,15 +479,15 @@ F www/fileformat.tcl 900c95b9633abc3dcfc384d9ddd8eb4876793059
 F www/formatchng.tcl bbb8af1ee494a71031acac4c8d8c51535f23b9df
 F www/fullscanb.gif f7c94cb227f060511f8909e10f570157263e9a25
 F www/index-ex1-x-b.gif f9b1d85c3fa2435cf38b15970c7e3aa1edae23a3
-F www/index.tcl e3b86b8628c9dffd4a60a16c4e4e428a69a0fe25
+F www/index.tcl 4d733614279b71ae25a385d65926c8d17ef3bd19
 F www/indirect1b1.gif adfca361d2df59e34f9c5cac52a670c2bfc303a1
-F www/lang.tcl 8dde95ed76af71579a132c9bb730d3764056d3ff
+F www/lang.tcl 49ef3e6dfca7c1f6e8573d3f3534b0bec31b9e7a
 F www/limits.tcl b74da35214028454f6e4170e0da3eeaf1811dbbd
 F www/lockingv3.tcl e52345bd20323bef6146bfce18ae0829b2b7c87d
 F www/mingw.tcl d96b451568c5d28545fefe0c80bee3431c73f69c
 F www/mkapidoc.tcl 696996026a3e13e3a5c31cee75a3a64edb5a7da0
 F www/nulls.tcl ec35193f92485b87b90a994a01d0171b58823fcf
-F www/oldnews.tcl 3ab579af86125f6047cf65f06a7a61b5b41e2312
+F www/oldnews.tcl badf03d45ed67a5046a4846e9ef9a4c234993f1b
 F www/omitted.tcl ee6b46f83d513b2187869740da829a700e1a355e
 F www/opcode.tcl 5bd68059416b223515a680d410a9f7cb6736485f
 F www/optimizer.tcl d6812a10269bd0d7c488987aac0ad5036cace9dc
@@ -505,7 +505,7 @@ F www/tclsqlite.tcl bb0d1357328a42b1993d78573e587c6dcbc964b9
 F www/vdbe.tcl 87a31ace769f20d3627a64fa1fade7fed47b90d0
 F www/version3.tcl 890248cf7b70e60c383b0e84d77d5132b3ead42b
 F www/whentouse.tcl fc46eae081251c3c181bd79c5faef8195d7991a5
-P d93c41e9a97882bf90217d60744d62dece6d10d3
-R df974033f78f42e5f8a5a73a6db722e5
+P 1ac160d3dc0f8723a1e2007cf45351dd8242c8c2
+R a8a52ca0a214cb8c3a79554b270f12e3
 U drh
-Z 8707dba60cafc501a175a7773fc2d178
+Z 23e4c835b3b4a2e88658b9b14d2b3da0
diff --git a/manifest.uuid b/manifest.uuid
index 41b8150a0f..001d1e683d 100644
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-1ac160d3dc0f8723a1e2007cf45351dd8242c8c2
\ No newline at end of file
+5232fd29d01d48d70b6d8f34ad5d0e2dde115fa0
\ No newline at end of file
diff --git a/www/changes.tcl b/www/changes.tcl
index 7110e07929..31af56d4b6 100644
--- a/www/changes.tcl
+++ b/www/changes.tcl
@@ -22,7 +22,66 @@ proc chng {date desc} {
     puts "<A NAME=\"version_$label\">"
   }
   puts "<DT><B>$date</B></DT>"
-  puts "<DD><P><UL>$desc</UL></P></DD>"
+  regsub -all {[Tt]icket #(\d+)} $desc \
+      {<a href="http://www.sqlite.org/cvstrac/tktview?tn=\1">\0</a>} desc
+  puts "<DD><P><UL>$desc</UL></P>"
+  puts "</DD>"
+}
+
+chng {2007 June 15 (3.4.0)} {
+<li>Fix a bug that can lead to database corruption if an SQLITE_BUSY error
+    occurs in the middle of an explicit transaction and that transaction
+    is later committed.  Ticket #2409.  See the
+    <a href="http://www.sqlite.org/cvstrac/wiki?p=CorruptionFollowingBusyError">
+    CorruptionFollowingBusyError</a> wiki page for details.</i>
+<li>Added explicit <a href="limits.html">upper bounds</a> on the sizes and
+    quantities of things SQLite can process.  This change might break some
+    applications that use SQLite in the extreme, which is when the current
+    release is 3.4.0 instead of 3.3.18.</li>
+<li>Added support for <a href="capi3ref.html#sqlite3_blob_open">
+    Incremental BLOB I/O</a>.</li>
+<li>Added the <a href="capi3ref.html#sqlite3_bind_zeroblob">zeroblob API</a>
+    and the <a href="lang_expr.html#zeroblob">zeroblob()</a> SQL function.</li>
+<li>Added support for <a href="pragma.html#pragma_incremental_vacuum">
+    Incremntal Vacuum</a>.</li>
+<li>Added the SQLITE_MIXED_ENDIAN_64BIT_FLOAT compile-time option to suppport
+    ARM7 processors with goofy endianness.</li>
+<li>Removed all instances of sprintf() and strcpy() from the core library.</li>
+<li>Added support for <a href="http://www.icu-project.org/">
+    International Components for Unicode (ICU)</a> to the full-text search
+    extensions.
+</ul><p>
+<ul type="circle">
+<li>In the windows OS driver, reacquire a SHARED lock if an attempt to
+    acquire an EXCLUSIVE lock fails.  Ticket #2354</li>
+<li>Fix the REPLACE() function so that it returns NULL if the second argument
+    is an empty string.  Ticket #2324.</li>
+<li>Document the hazards of type coversions in
+    <a href="capi3ref.html#sqlite3_column_blob">sqlite3_column_blob()</a>
+    and related APIs.  Fix unnecessary type conversions.  Ticket #2321.</li>
+<li>Internationalization of the TRIM() functin.  Ticket #2323</li>
+<li>Use memmove() instead of memcpy() when moving between memory regions
+    that might overlap.  Ticket #2334</li>
+<li>Fix an optimizer bug involving subqueries in a compound SELECT that has
+    both an ORDER BY and a LIMIT clause.  Ticket #2339.</li>
+<li>Make sure the <a href="capi3ref.html#sqlite3_snprintf">sqlite3_snprintf()
+    </a> interface does not zero-terminate the buffer if the buffer size is
+    less than 1.  Ticket #2341</li>
+<li>Fix the built-in printf logic so that it prints "NaN" not "Inf" for
+    floating-point NaNs.  Ticket #2345</li>
+<li>When converting BLOB to TEXT, use the text encoding of the main database.
+    Ticket #2349</li>
+<li>Keep the full precision of integers (if possible) when casting to
+    NUMERIC.  Ticket #2364</li>
+<li>Fix a bug in the handling of UTF16 codepoint 0xE000</li>
+<li>Consider explicit collate clauses when matching WHERE constraints
+    to indices in the query optimizer.  Ticket #2391</li>
+<li>Fix the query optimizer to correctly handle constant expressions in 
+    the ON clause of a LEFT JOIN.  Ticket #2403</li>
+<li>Fix the query optimizer to handle rowid comparisions to NULL
+    correctly.  Ticket #2404</li>
+<li>Fix many potental segfaults that could be caused by malicious SQL
+    statements.</li>
 }
 
 chng {2007 April 25 (3.3.17)} {
diff --git a/www/index.tcl b/www/index.tcl
index b1aa5453b4..5d974a7684 100644
--- a/www/index.tcl
+++ b/www/index.tcl
@@ -71,6 +71,24 @@ proc newsitem {date title text} {
   puts "<hr width=\"50%\">"
 }
 
+newsitem {2007-Jun-15} {Version 3.4.0} {
+  This release fixes a bug that can lead to database corruption.  Upgrading
+  is strongly recommended.  If you must continue using an older version
+  of SQLite, please at least read
+  <a href="http://www.sqlite.org/cvstrac/wiki?p=CorruptionFollowingBusyError">
+  how to avoid the bug</a>.
+  <p>
+  This release also adds explicit <a href="limits.html">limits</a> on the
+  sizes and quantities of things SQLite will handle.  The new limits might
+  causes minor problems for some existing applications that push the
+  envelope, which is the reason that this release is 3.4.0 instead of 3.3.18.
+  </p>
+  There are also new features, including
+  <a href="capi3ref.html#sqlite3_blob_open">incremental BLOB I/O</a> and
+  <a href="pragma.html#pragma_incremental_vacuum">incremental vacuum</a>.
+  See the <a href="changes.html">change log</a> for additional information.
+}
+
 newsitem {2007-Apr-25} {Version 3.3.17} {
   This version fixes a bug in the forwards-compatibility logic of SQLite
   that was causing a database to become unreadable when it should have
@@ -85,39 +103,8 @@ newsitem {2007-Apr-18} {Version 3.3.16} {
   VACUUM from running if a NULL value was in a UNIQUE column.
 }
 
-newsitem {2007-Apr-09} {Version 3.3.15} {
-  An annoying bug introduced in 3.3.14 has been fixed.  There are
-  also many enhancements to the test suite.  
-}
-
-newsitem {2007-Apr-02} {Version 3.3.14} {
-  This version focuses on performance improvements.  If you recompile
-  <a href="http://www.sqlite.org/cvstrac/wiki?p=TheAmalgamation">
-  the amalgamation</a> using GCC option -O3 (the precompiled binaries
-  use -O2) you may see performance
-  improvements of 35% or more over version 3.3.13 depending on your
-  workload.  This version also
-  adds support for <a href="pragma.html#pragma_locking_mode">
-  exclusive access mode</a>.
-}
-
-newsitem {2007-Feb-13} {Version 3.3.13} {
-  This version fixes a subtle bug in the ORDER BY optimizer that can 
-  occur when using joins.  There are also a few minor enhancements.
-  Upgrading is recommended.
-}
-
-newsitem {2007-Jan-27} {Version 3.3.12} {
-  The first published build of the previous version used the wrong
-  set of source files.  Consequently, many people downloaded a build
-  that was labeled as "3.3.11" but was really 3.3.10.  Version 3.3.12
-  is released to clear up the ambiguity.  A couple more bugs have
-  also been fixed and <a href="pragma.html#pragma_integrity_check">
-  PRAGMA integrity_check</a> has been enhanced.
-}
-
 puts {
 <p align="right"><a href="oldnews.html">Old news...</a></p>
 </td></tr></table>
 }
-footer {$Id: index.tcl,v 1.155 2007/06/09 09:53:51 drh Exp $}
+footer {$Id: index.tcl,v 1.156 2007/06/15 12:16:32 drh Exp $}
diff --git a/www/lang.tcl b/www/lang.tcl
index c65e0ec9e1..4f9459d85d 100644
--- a/www/lang.tcl
+++ b/www/lang.tcl
@@ -1,7 +1,7 @@
 #
 # Run this Tcl script to generate the lang-*.html files.
 #
-set rcsid {$Id: lang.tcl,v 1.129 2007/05/15 01:13:47 drh Exp $}
+set rcsid {$Id: lang.tcl,v 1.130 2007/06/15 12:16:32 drh Exp $}
 source common.tcl
 
 if {[llength $argv]>0} {
@@ -1485,6 +1485,16 @@ upper-case letters.  The implementation of this function uses the C library
 routine <b>toupper()</b> which means it may not work correctly on 
 UTF-8 strings.</td>
 </tr>
+
+<tr>
+<td valign="top" align="right">zeroblob(<i>N</i>)</td>
+<td valign="top"><a name="zeroblob">
+Return a BLOB consisting of N bytes of 0x00.  SQLite
+manages these zeroblobs very efficiently.  Zeroblobs can be use to
+reserve space for a BLOB that is later written using 
+<a href="capi3ref.html#sqlite3_blob_open">incremental BLOB I/O</a>.</td>
+</tr>
+
 </table>
 
 <b>Date And Time Functions</b>
diff --git a/www/oldnews.tcl b/www/oldnews.tcl
index ed3cb15d31..a3da2fac49 100644
--- a/www/oldnews.tcl
+++ b/www/oldnews.tcl
@@ -10,6 +10,37 @@ proc newsitem {date title text} {
 }
 
 
+newsitem {2007-Apr-09} {Version 3.3.15} {
+  An annoying bug introduced in 3.3.14 has been fixed.  There are
+  also many enhancements to the test suite.  
+}
+
+newsitem {2007-Apr-02} {Version 3.3.14} {
+  This version focuses on performance improvements.  If you recompile
+  <a href="http://www.sqlite.org/cvstrac/wiki?p=TheAmalgamation">
+  the amalgamation</a> using GCC option -O3 (the precompiled binaries
+  use -O2) you may see performance
+  improvements of 35% or more over version 3.3.13 depending on your
+  workload.  This version also
+  adds support for <a href="pragma.html#pragma_locking_mode">
+  exclusive access mode</a>.
+}
+
+newsitem {2007-Feb-13} {Version 3.3.13} {
+  This version fixes a subtle bug in the ORDER BY optimizer that can 
+  occur when using joins.  There are also a few minor enhancements.
+  Upgrading is recommended.
+}
+
+newsitem {2007-Jan-27} {Version 3.3.12} {
+  The first published build of the previous version used the wrong
+  set of source files.  Consequently, many people downloaded a build
+  that was labeled as "3.3.11" but was really 3.3.10.  Version 3.3.12
+  is released to clear up the ambiguity.  A couple more bugs have
+  also been fixed and <a href="pragma.html#pragma_integrity_check">
+  PRAGMA integrity_check</a> has been enhanced.
+}
+
 newsitem {2007-Jan-22} {Version 3.3.11} {
   Version 3.3.11 fixes for a few more problems in version 3.3.9 that
   version 3.3.10 failed to catch.  Upgrading is recommended.
@@ -412,4 +443,4 @@ newsitem {2004-Apr-23} {Work Begins On SQLite Version 3} {
   Plans are to continue to support SQLite version 2.8 with
   bug fixes.  But all new development will occur in version 3.0.
 }
-footer {$Id: oldnews.tcl,v 1.20 2007/04/09 13:18:47 drh Exp $}
+footer {$Id: oldnews.tcl,v 1.21 2007/06/15 12:16:32 drh Exp $}