From efd6a856f895aa125de6b95c635e0368ef057d0c Mon Sep 17 00:00:00 2001
From: Paul Davis <paul@linuxaudiosystems.com>
Date: Thu, 20 Feb 2020 00:22:17 -0700
Subject: add comment

---
 libs/ardour/disk_reader.cc | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/libs/ardour/disk_reader.cc b/libs/ardour/disk_reader.cc
index 95f926497d..e1a46ae0ee 100644
--- a/libs/ardour/disk_reader.cc
+++ b/libs/ardour/disk_reader.cc
@@ -1019,6 +1019,10 @@ DiskReader::_do_refill_with_alloc (bool partial_fill)
 int
 DiskReader::refill (Sample* sum_buffer, Sample* mixdown_buffer, float* gain_buffer, samplecnt_t fill_level)
 {
+	/* NOTE: Audio refill MUST come first so that in contexts where ONLY it
+	   is called, _last_read_reversed is set correctly.
+	*/
+
 	if (refill_audio (sum_buffer, mixdown_buffer, gain_buffer, fill_level)) {
 		return -1;
 	}
-- 
cgit v1.2.3