More comment improvements.

src/include/access/nbtree.h

@@ -7,7 +7,7 @@
  * Portions Copyright (c) 1996-2001, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California
  *
- * $Id: nbtree.h,v 1.53 2001/02/22 21:48:49 momjian Exp $
+ * $Id: nbtree.h,v 1.54 2001/02/22 23:02:33 momjian Exp $
  *
  *-------------------------------------------------------------------------
  */
@@ -67,7 +67,7 @@ typedef struct BTMetaPageData
 #define BTPageGetMeta(p) \
 	((BTMetaPageData *) &((PageHeader) p)->pd_linp[0])
 
-#define BTREE_METAPAGE	0	/* first page is meta */
+#define BTREE_METAPAGE	0			/* first page is meta */
 #define BTREE_MAGIC		0x053162	/* magic number of btree pages */
 
 #define BTreeInvalidParent(opaque)	\
@@ -215,8 +215,8 @@ typedef BTStackData *BTStack;
  *	items beginning in item 1.
  */
 
-#define P_HIKEY			((OffsetNumber) 1)
-#define P_FIRSTKEY		((OffsetNumber) 2)
+#define P_HIKEY				((OffsetNumber) 1)
+#define P_FIRSTKEY			((OffsetNumber) 2)
 #define P_FIRSTDATAKEY(opaque)  (P_RIGHTMOST(opaque) ? P_HIKEY : P_FIRSTKEY)
 
 /*

src/include/storage/lmgr.h

@@ -7,7 +7,7 @@
  * Portions Copyright (c) 1996-2001, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California
  *
- * $Id: lmgr.h,v 1.28 2001/01/24 19:43:27 momjian Exp $
+ * $Id: lmgr.h,v 1.29 2001/02/22 23:02:33 momjian Exp $
  *
  *-------------------------------------------------------------------------
  */
@@ -25,11 +25,12 @@
 #define AccessShareLock			1		/* SELECT */
 #define RowShareLock			2		/* SELECT FOR UPDATE */
 #define RowExclusiveLock		3		/* INSERT, UPDATE, DELETE */
-#define ShareLock				4
-#define ShareRowExclusiveLock	5
-#define ExclusiveLock			6
-#define AccessExclusiveLock		7
-
+#define ShareLock				4		/* CREATE INDEX */
+#define ShareRowExclusiveLock	5		/* like EXCLUSIVE MODE, allows SHARE ROW */
+#define ExclusiveLock			6		/* blocks ROW SHARE/SELECT...FOR UPDATE */
+#define AccessExclusiveLock		7		/* ALTER TABLE, DROP TABLE, VACUUM, and
+										 * unqualified LOCK TABLE 
+										 */
 extern LOCKMETHOD LockTableId;
 
 

src/include/storage/lock.h

@@ -7,7 +7,7 @@
  * Portions Copyright (c) 1996-2001, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California
  *
- * $Id: lock.h,v 1.44 2001/01/25 03:31:16 tgl Exp $
+ * $Id: lock.h,v 1.45 2001/02/22 23:02:33 momjian Exp $
  *
  *-------------------------------------------------------------------------
  */
@@ -60,7 +60,7 @@ typedef int LOCKMODE;
 typedef int LOCKMETHOD;
 
 /* MAX_LOCKMODES cannot be larger than the # of bits in LOCKMASK */
-#define MAX_LOCKMODES	8
+#define MAX_LOCKMODES  		8
 
 /*
  * MAX_LOCK_METHODS corresponds to the number of spin locks allocated in