[Zope3-checkins] CVS: ZODB/src/ZODB/FileStorage - format.py:1.6

[Tim Peters]

Update of /cvs-repository/ZODB/src/ZODB/FileStorage
In directory cvs.zope.org:/tmp/cvs-serv14120/src/zodb/filestorage

Modified Files:
	format.py 
Log Message:
Took a stab at documenting what the possible values for a transaction
record's "status byte" are and mean.


=== ZODB/src/ZODB/FileStorage/format.py 1.5 => 1.6 ===
--- ZODB/src/ZODB/FileStorage/format.py:1.5	Thu Feb 26 19:31:55 2004
+++ ZODB/src/ZODB/FileStorage/format.py	Mon Mar 15 14:04:29 2004
@@ -28,6 +28,15 @@
 #   - 8-byte transaction record length - 8.
 #
 #   - 1-byte status code
+#     ' '  (a blank) completed transaction that hasn't been packed
+#     'p'  completed transaction that has been packed
+#     'c'  checkpoint -- a transaction in progress, at the end of the file;
+#          it's been thru vote() but not finish(); if finish() completes
+#          normally, it will be overwritten with a blank; if finish() dies
+#          (e.g., out of disk space), cleanup code will try to truncate
+#          the file to chop off this incomplete transaction
+#     'u'  uncertain; no longer used; was previously used to record something
+#          about non-transactional undo
 #
 #   - 2-byte length of user name
 #