diff --git a/src/validation.h b/src/validation.h
--- a/src/validation.h
+++ b/src/validation.h
@@ -421,13 +421,7 @@
                     bool fAllowSlow = false, CBlockIndex *blockIndex = nullptr);
 
 /**
- * Find the best known block, and make it the active tip of the block chain.
- * If it fails, the tip is not updated.
- *
- * pblock is either nullptr or a pointer to a block that is already loaded
- * in memory (to avoid loading it from disk again).
- *
- * Returns true if a new chain tip was set.
+ * Find the best known block, and make it the tip of the block chain
  */
 bool ActivateBestChain(
     const Config &config, CValidationState &state,
diff --git a/src/validation.cpp b/src/validation.cpp
--- a/src/validation.cpp
+++ b/src/validation.cpp
@@ -2867,6 +2867,11 @@
     }
 }
 
+/**
+ * Make the best chain active, in multiple steps. The result is either failure
+ * or an activated best chain. pblock is either nullptr or a pointer to a block
+ * that is already loaded (to avoid loading it again from disk).
+ */
 bool CChainState::ActivateBestChain(const Config &config,
                                     CValidationState &state,
                                     std::shared_ptr<const CBlock> pblock) {