up stale comment

maurycy · maurycy · commit a9449afb276b · 2026-07-01T18:58:31.000+02:00
diff --git a/Modules/_remote_debugging/module.c b/Modules/_remote_debugging/module.c
@@ -1784,9 +1784,9 @@ _remote_debugging_BinaryWriter_write_sample_impl(BinaryWriterObject *self,
 /* Finalize the writer, cache total_samples, and destroy it.
  *
  * The cache assignment must happen AFTER binary_writer_finalize(): finalize
- * flushes pending RLE samples via flush_pending_rle(), which increments
- * writer->total_samples for each one. Caching before finalize would lose
- * those trailing samples. */
+ * flushes pending RLE records and updates the file header before the writer is
+ * destroyed. Caching before finalize would preserve a count for a file that
+ * might still fail to finish. */
 static int
 binary_writer_finalize_and_cache(BinaryWriterObject *self)
 {

Original file line number	Diff line number	Diff line change
`@@ -1784,9 +1784,9 @@ _remote_debugging_BinaryWriter_write_sample_impl(BinaryWriterObject *self,`
`1784`	`1784`	`/* Finalize the writer, cache total_samples, and destroy it.`
`1785`	`1785`	`*`
`1786`	`1786`	`* The cache assignment must happen AFTER binary_writer_finalize(): finalize`
`1787`		`- * flushes pending RLE samples via flush_pending_rle(), which increments`
`1788`		`- * writer->total_samples for each one. Caching before finalize would lose`
`1789`		`- * those trailing samples. */`
	`1787`	`+ * flushes pending RLE records and updates the file header before the writer is`
	`1788`	`+ * destroyed. Caching before finalize would preserve a count for a file that`
	`1789`	`+ * might still fail to finish. */`
`1790`	`1790`	`static int`
`1791`	`1791`	`binary_writer_finalize_and_cache(BinaryWriterObject *self)`
`1792`	`1792`	`{`