From 79c943f17488eda7cf76c03f876d52f40dd6ee7e Mon Sep 17 00:00:00 2001
From: Mike Dalessio <mike@37signals.com>
Date: Thu, 31 Oct 2024 11:12:00 -0400
Subject: [PATCH] Add a bit more documentation, and add the Optimize::DEFAULT
 constant

---
 lib/sqlite3/constants.rb | 18 +++++++++++++-----
 lib/sqlite3/pragmas.rb   |  2 ++
 2 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/lib/sqlite3/constants.rb b/lib/sqlite3/constants.rb
index 816af009..eae77b7c 100644
--- a/lib/sqlite3/constants.rb
+++ b/lib/sqlite3/constants.rb
@@ -172,19 +172,27 @@ module Status
     end
 
     module Optimize
-      # Debugging mode. Do not actually perform any optimizations but instead return one line of text
-      # for each optimization that would have been done.
+      # Debugging mode. Do not actually perform any optimizations but instead return one line of
+      # text for each optimization that would have been done. Off by default.
       DEBUG = 0x00001
 
-      # Run ANALYZE on tables that might benefit.
+      # Run ANALYZE on tables that might benefit. On by default.
       ANALYZE_TABLES = 0x00002
 
-      # When running ANALYZE, set a temporary PRAGMA analysis_limit to prevent excess run-time.
+      # When running ANALYZE, set a temporary PRAGMA analysis_limit to prevent excess run-time. On
+      # by default.
       LIMIT_ANALYZE = 0x00010
 
       # Check the size of all tables, not just tables that have not been recently used, to see if
-      # any have grown and shrunk significantly and hence might benefit from being re-analyzed.
+      # any have grown and shrunk significantly and hence might benefit from being re-analyzed. Off
+      # by default.
       CHECK_ALL_TABLES = 0x10000
+
+      # Useful for adding a bit to the default behavior, for example
+      #
+      #     db.optimize(Optimize::DEFAULT | Optimize::CHECK_ALL_TABLES)
+      #
+      DEFAULT = ANALYZE_TABLES | LIMIT_ANALYZE
     end
   end
 end
diff --git a/lib/sqlite3/pragmas.rb b/lib/sqlite3/pragmas.rb
index cf44b4df..08ad037b 100644
--- a/lib/sqlite3/pragmas.rb
+++ b/lib/sqlite3/pragmas.rb
@@ -342,6 +342,8 @@ def mmap_size=(size)
     #
     # To customize the optimization options, pass +bitmask+ with a combination
     # of the Constants::Optimize masks.
+    #
+    # See https://www.sqlite.org/pragma.html#pragma_optimize for more information.
     def optimize(bitmask = nil)
       if bitmask
         set_int_pragma "optimize", bitmask