From f3ccc38a697da306aee63e66c22c2d480d292875 Mon Sep 17 00:00:00 2001
From: drh <drh@noemail.net>
Date: Fri, 7 Mar 2014 14:57:07 +0000
Subject: [PATCH] Improved comment on the pager.c PERSIST rollback journal
 delete logic inside of hasHotJournal().  No changes to code.

FossilOrigin-Name: e5b17a9d07a35c9b44ff977ba81b93d745d26a11
---
 manifest      | 14 +++++++-------
 manifest.uuid |  2 +-
 src/pager.c   | 14 ++++++++------
 3 files changed, 16 insertions(+), 14 deletions(-)

diff --git a/manifest b/manifest
index 9e997b1eb1..f1ed65c66d 100644
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C Revise\schange\sfrom\sthe\sprevious\scheck-in\sto\sclarify\sthe\ssituation\swhen\shandling\sopen\sjournal\sfiles,\sregardless\sof\sjournal\smode.
-D 2014-03-07T03:31:35.143
+C Improved\scomment\son\sthe\spager.c\sPERSIST\srollback\sjournal\sdelete\slogic\ninside\sof\shasHotJournal().\s\sNo\schanges\sto\scode.
+D 2014-03-07T14:57:07.028
 F Makefile.arm-wince-mingw32ce-gcc d6df77f1f48d690bd73162294bbba7f59507c72f
 F Makefile.in 2ef13430cd359f7b361bb863504e227b25cc7f81
 F Makefile.linux-gcc 91d710bdc4998cb015f39edf3cb314ec4f4d7e23
@@ -204,7 +204,7 @@ F src/os.h 4a46270a64e9193af4a0aaa3bc2c66dc07c29b3f
 F src/os_common.h 92815ed65f805560b66166e3583470ff94478f04
 F src/os_unix.c 18f7f95dc6bcb9cf4d4a238d8e2de96611bc2ae5
 F src/os_win.c e71678ac927d0a0fb11d993db20a9748eabf808e
-F src/pager.c ab9b5331e402f438effb02575955ffea673246cd
+F src/pager.c 97a8908bf4e6e7c3adea09d3597cfa48ae33ab4e
 F src/pager.h ffd5607f7b3e4590b415b007a4382f693334d428
 F src/parse.y 2613ca5d609c2f3d71dd297351f010bcec16e1e0
 F src/pcache.c d8eafac28290d4bb80332005435db44991d07fc2
@@ -1155,7 +1155,7 @@ F tool/vdbe_profile.tcl 67746953071a9f8f2f668b73fe899074e2c6d8c1
 F tool/warnings-clang.sh f6aa929dc20ef1f856af04a730772f59283631d4
 F tool/warnings.sh d1a6de74685f360ab718efda6265994b99bbea01
 F tool/win/sqlite.vsix 030f3eeaf2cb811a3692ab9c14d021a75ce41fff
-P fdc651e2ec7a0babee669e24fd56632e7cd5f0e9
-R dd6c54a8aa52f6e2a8e41a668b913ede
-U mistachkin
-Z 7a2dfaabd9df7aaa8958f21cc25c2459
+P 1c318ef3b76e9a9a5ff2f156a9acddfc1bda0949
+R 061864752fb659e79b9068736cf1ac45
+U drh
+Z 9721365445b2c154201b5f1346741e86
diff --git a/manifest.uuid b/manifest.uuid
index 13a19cc1e7..e76365c166 100644
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-1c318ef3b76e9a9a5ff2f156a9acddfc1bda0949
\ No newline at end of file
+e5b17a9d07a35c9b44ff977ba81b93d745d26a11
\ No newline at end of file
diff --git a/src/pager.c b/src/pager.c
index e2486caa0a..c6485a4d45 100644
--- a/src/pager.c
+++ b/src/pager.c
@@ -4889,14 +4889,16 @@ static int hasHotJournal(Pager *pPager, int *pExists){
     if( rc==SQLITE_OK && !locked ){
       Pgno nPage;                 /* Number of pages in database file */
 
-      /* Check the size of the database file. If it consists of 0 pages
-      ** and the journal is not being persisted, then delete the journal
-      ** file.  See the header comment above for the reasoning here.
-      ** Delete the obsolete journal file under a RESERVED lock to avoid
-      ** race conditions and to avoid violating [H33020].
-      */
       rc = pagerPagecount(pPager, &nPage);
       if( rc==SQLITE_OK ){
+        /* If the database is zero pages in size, that means that either (1) the
+        ** journal is a remnant from a prior database with the same name where
+        ** the database file but not the journal was deleted, or (2) the initial
+        ** transaction that populates a new database is being rolled back.
+        ** In either case, the journal file can be deleted.  However, take care
+        ** not to delete the journal file if it is already open due to
+        ** journal_mode=PERSIST.
+        */
         if( nPage==0 && !jrnlOpen ){
           sqlite3BeginBenignMalloc();
           if( pagerLockDb(pPager, RESERVED_LOCK)==SQLITE_OK ){