f simplify backwards compat discussion

Author: TheBlueMatt

lightning/src/chain/mod.rs

@@ -83,11 +83,9 @@ impl_writeable_tlv_based!(BestBlock, {
 /// made immediately for the same block (prior to any other calls to the [`Listen`] interface).
 ///
 /// In case of a reorg, you must call [`Listen::blocks_disconnected`] once with information on the
-/// "fork point" block, i.e. the highest block that is in both forks. For backwards compatibility,
-/// you may instead walk the chain backwards, calling `blocks_disconnected` for each block that is
-/// disconnected in a reorg, each time passing the new-best-block (i.e. information about the block
-/// prior to the one being disconnected) such that you ultimately pass information about the fork
-/// point to `blocks_disconnected`.
+/// "fork point" block, i.e. the highest block that is in both forks. You may call
+/// [`Listen::blocks_disconnected`] multiple times as you walk the chain backwards, but each must
+/// include a fork point block which is before the last.
 ///
 /// # Object Birthday
 ///