diff --git a/db/db_write_test.cc b/db/db_write_test.cc
index 84fa347174a1c5b99f1c3a14f96b14f33f158896..d82c573763e795d3c033c25127546dbde711b447 100644
--- a/db/db_write_test.cc
+++ b/db/db_write_test.cc
@@ -620,6 +620,7 @@ TEST_P(DBWriteTest, LockWALInEffect) {
   options.env = fault_fs_env.get();
   options.disable_auto_compactions = true;
   options.paranoid_checks = false;
+  options.max_bgerror_resume_count = 0;  // manual Resume()
   Reopen(options);
   // try the 1st WAL created during open
   ASSERT_OK(Put("key0", "value"));
@@ -649,6 +650,7 @@ TEST_P(DBWriteTest, LockWALInEffect) {
     ASSERT_OK(db_->UnlockWAL());
   }
   fault_fs->SetFilesystemActive(true);
+  ASSERT_OK(db_->Resume());
   // Writes should work again
   ASSERT_OK(Put("key3", "value"));
   ASSERT_EQ(Get("key3"), "value");
diff --git a/include/rocksdb/db.h b/include/rocksdb/db.h
index fa646923150a623dfb98be1bbc65bcbd004e4c82..6949fadcfd5c716c75203f9055c0ce182703536a 100644
--- a/include/rocksdb/db.h
+++ b/include/rocksdb/db.h
@@ -301,6 +301,18 @@ class DB {
       std::vector<ColumnFamilyHandle*>* handles, DB** dbptr,
       std::string trim_ts);
 
+  // Manually, synchronously attempt to resume DB writes after a write failure
+  // to the underlying filesystem. See
+  // https://github.com/facebook/rocksdb/wiki/Background-Error-Handling
+  //
+  // Returns OK if writes are successfully resumed, or there was no
+  // outstanding error to recover from. Returns underlying write error if
+  // it is not recoverable.
+  //
+  // WART: Does not mix well with auto-resume. Will return Busy if an
+  // auto-resume is in progress, without waiting for it to complete.
+  // See DBOptions::max_bgerror_resume_count and
+  // EventListener::OnErrorRecoveryBegin
   virtual Status Resume() { return Status::NotSupported(); }
 
   // Close the DB by releasing resources, closing files etc. This should be
diff --git a/include/rocksdb/options.h b/include/rocksdb/options.h
index eca34108a5b28eb06b44bcdaeb74211124ff0154..669afc1d49f2513c75d76d985776d4b2093a52a0 100644
--- a/include/rocksdb/options.h
+++ b/include/rocksdb/options.h
@@ -1311,12 +1311,12 @@ struct DBOptions {
   // Default: false
   bool best_efforts_recovery = false;
 
-  // It defines how many times db resume is called by a separate thread when
+  // It defines how many times DB::Resume() is called by a separate thread when
   // background retryable IO Error happens. When background retryable IO
   // Error happens, SetBGError is called to deal with the error. If the error
   // can be auto-recovered (e.g., retryable IO Error during Flush or WAL write),
   // then db resume is called in background to recover from the error. If this
-  // value is 0 or negative, db resume will not be called.
+  // value is 0 or negative, DB::Resume() will not be called automatically.
   //
   // Default: INT_MAX
   int max_bgerror_resume_count = INT_MAX;