Improvements to comments in build.c. (CVS 3149)

FossilOrigin-Name: 986208a364ce0ba81456b54e6561a277fb19309c

manifest

@@ -1,5 +1,5 @@
-C Get\sautovacuum\sand\sin-memory\sdatabases\sworking\stogether.\s\sTicket\s#1727.\s(CVS\s3148)
+C Improvements\sto\scomments\sin\sbuild.c.\s(CVS\s3149)
-D 2006-03-23T23:29:04
+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
+P 21446df6420df00468867f1131c28604a1ae91a3
-R 750982574ed29edef07cf0a26cbd5a70
+R 5732f7c7668c3772e0c25148e3d40aa1
 U drh
-Z ec805b2d5215633dd615b072bbda2925
+Z 7ebd5a18779bf0f0d04ac1a12eb7a3df

manifest.uuid

@@ -1 +1 @@
-21446df6420df00468867f1131c28604a1ae91a3
+986208a364ce0ba81456b54e6561a277fb19309c

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 iDb;             /* The database containing the table to be locked */
-  int iTab;
+  int iTab;            /* The root page of the table to be locked */
-  u8 isWriteLock;
+  u8 isWriteLock;      /* True for write lock.  False for a read lock */
-  const char *zName;
+  const char *zName;   /* Name of the table */
 };
 
 /*
-** Have the compiled statement lock the table with rootpage iTab in database
+** Record the fact that we want to lock a table at run-time.  
-** iDb at the shared-cache level when executed. The isWriteLock argument 
-** is zero for a read-lock, or non-zero for a write-lock.
 **
-** The zName parameter should point to the unqualified table name. This is
+** The table to be locked has root page iTab and is found in database iDb.
-** used to provide a more informative error message should the lock fail.
+** A read or a write lock can be taken depending on isWritelock.
+**
+** 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, 
+  Parse *pParse,     /* Parsing context */
-  int iDb, 
+  int iDb,           /* Index of the database containing the table to lock */
-  int iTab, 
+  int iTab,          /* Root page number of the table to be locked */
-  u8 isWriteLock,  
+  u8 isWriteLock,    /* True for a write lock */
-  const char *zName
+  const char *zName  /* Name of the table to be locked */
 ){
   int i;
   int nBytes;