From d698bc15ef14e34c5bf0c6ae959f845f99a3ff00 Mon Sep 17 00:00:00 2001
From: drh <drh@noemail.net>
Date: Thu, 23 Mar 2006 23:33:26 +0000
Subject: [PATCH] Improvements to comments in build.c. (CVS 3149)

FossilOrigin-Name: 986208a364ce0ba81456b54e6561a277fb19309c
---
 manifest      | 12 ++++++------
 manifest.uuid |  2 +-
 src/build.c   | 32 +++++++++++++++++---------------
 3 files changed, 24 insertions(+), 22 deletions(-)

diff --git a/manifest b/manifest
index e26e3cc310..9a43cd185d 100644
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C Get\sautovacuum\sand\sin-memory\sdatabases\sworking\stogether.\s\sTicket\s#1727.\s(CVS\s3148)
-D 2006-03-23T23:29:04
+C Improvements\sto\scomments\sin\sbuild.c.\s(CVS\s3149)
+D 2006-03-23T23:33:27
 F Makefile.in 5d8dff443383918b700e495de42ec65bc1c8865b
 F Makefile.linux-gcc 74ba0eadf88748a9ce3fd03d2a3ede2e6715baec
 F README 9c4e2d6706bdcc3efdd773ce752a8cdab4f90028
@@ -36,7 +36,7 @@ F src/attach.c d73a3505de3fb9e373d0a158978116c4212031d0
 F src/auth.c 9ae84d2d94eb96195e04515715e08e85963e96c2
 F src/btree.c 582f0fb985c3dc209d2904639dd2c3c4544ba90e
 F src/btree.h 40055cfc09defd1146bc5b922399c035f969e56d
-F src/build.c 4bd8471e4f20f5623c15fd71d2aaee0f66e394d8
+F src/build.c b8437e81e1e10a8fedda0b6209bb05c83e93a844
 F src/callback.c d8c5ab1cd6f3b7182b2ee63bf53f1b69c0f74306
 F src/complete.c 7d1a44be8f37de125fcafd3d3a018690b3799675
 F src/date.c cd2bd5d1ebc6fa12d6312f69789ae5b0a2766f2e
@@ -355,7 +355,7 @@ F www/tclsqlite.tcl bb0d1357328a42b1993d78573e587c6dcbc964b9
 F www/vdbe.tcl 87a31ace769f20d3627a64fa1fade7fed47b90d0
 F www/version3.tcl 890248cf7b70e60c383b0e84d77d5132b3ead42b
 F www/whentouse.tcl 97e2b5cd296f7d8057e11f44427dea8a4c2db513
-P 5a24f61981df4d8b696f03372eba2d37228906d9
-R 750982574ed29edef07cf0a26cbd5a70
+P 21446df6420df00468867f1131c28604a1ae91a3
+R 5732f7c7668c3772e0c25148e3d40aa1
 U drh
-Z ec805b2d5215633dd615b072bbda2925
+Z 7ebd5a18779bf0f0d04ac1a12eb7a3df
diff --git a/manifest.uuid b/manifest.uuid
index 727b63ea0d..f37fd68355 100644
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-21446df6420df00468867f1131c28604a1ae91a3
\ No newline at end of file
+986208a364ce0ba81456b54e6561a277fb19309c
\ No newline at end of file
diff --git a/src/build.c b/src/build.c
index 6f02af8b71..cdf8c19af9 100644
--- a/src/build.c
+++ b/src/build.c
@@ -22,7 +22,7 @@
 **     COMMIT
 **     ROLLBACK
 **
-** $Id: build.c,v 1.391 2006/03/13 12:54:10 drh Exp $
+** $Id: build.c,v 1.392 2006/03/23 23:33:27 drh Exp $
 */
 #include "sqliteInt.h"
 #include <ctype.h>
@@ -42,26 +42,28 @@ void sqlite3BeginParse(Parse *pParse, int explainFlag){
 ** codeTableLocks() functions.
 */
 struct TableLock {
-  int iDb;
-  int iTab;
-  u8 isWriteLock;
-  const char *zName;
+  int iDb;             /* The database containing the table to be locked */
+  int iTab;            /* The root page of the table to be locked */
+  u8 isWriteLock;      /* True for write lock.  False for a read lock */
+  const char *zName;   /* Name of the table */
 };
 
 /*
-** Have the compiled statement lock the table with rootpage iTab in database
-** iDb at the shared-cache level when executed. The isWriteLock argument 
-** is zero for a read-lock, or non-zero for a write-lock.
+** Record the fact that we want to lock a table at run-time.  
+**
+** The table to be locked has root page iTab and is found in database iDb.
+** A read or a write lock can be taken depending on isWritelock.
 **
-** The zName parameter should point to the unqualified table name. This is
-** used to provide a more informative error message should the lock fail.
+** This routine just records the fact that the lock is desired.  The
+** code to make the lock occur is generated by a later call to
+** codeTableLocks() which occurs during sqlite3FinishCoding().
 */
 void sqlite3TableLock(
-  Parse *pParse, 
-  int iDb, 
-  int iTab, 
-  u8 isWriteLock,  
-  const char *zName
+  Parse *pParse,     /* Parsing context */
+  int iDb,           /* Index of the database containing the table to lock */
+  int iTab,          /* Root page number of the table to be locked */
+  u8 isWriteLock,    /* True for a write lock */
+  const char *zName  /* Name of the table to be locked */
 ){
   int i;
   int nBytes;
-- 
2.47.2