From e8036127fe825b51d9acc65b5e65e91e8034c1af Mon Sep 17 00:00:00 2001
From: Thomas Harte <thomas.harte@gmail.com>
Date: Fri, 16 Feb 2024 09:19:22 -0500
Subject: [PATCH] Add some commentary.

---
 Machines/Apple/AppleII/AppleII.cpp | 2 ++
 Machines/Apple/AppleII/Video.hpp   | 3 ++-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/Machines/Apple/AppleII/AppleII.cpp b/Machines/Apple/AppleII/AppleII.cpp
index 795f1e50a..4ca222a3d 100644
--- a/Machines/Apple/AppleII/AppleII.cpp
+++ b/Machines/Apple/AppleII/AppleII.cpp
@@ -742,6 +742,8 @@ template <Analyser::Static::AppleII::Target::Model model, bool has_mockingboard>
 				// actor, but this will actually be the result most of the time so it's not
 				// too terrible.
 				if(isReadOperation(operation) && address != 0xc000) {
+					// Ensure any enqueued video changes are applied before grabbing the
+					// vapour value.
 					if(video_.has_deferred_actions()) {
 						update_video();
 					}
diff --git a/Machines/Apple/AppleII/Video.hpp b/Machines/Apple/AppleII/Video.hpp
index ce0814a3b..fe6ce1504 100644
--- a/Machines/Apple/AppleII/Video.hpp
+++ b/Machines/Apple/AppleII/Video.hpp
@@ -123,7 +123,8 @@ template <class BusHandler, bool is_iie> class Video: public VideoBase {
 			bus_handler_(bus_handler) {}
 
 		/*!
-			Obtains the last value the video read prior to time now+offset.
+			Obtains the last value the video read prior to time now+offset, according to the *current*
+			video mode, i.e. not allowing for any changes still enqueued.
 		*/
 		uint8_t get_last_read_value(Cycles offset) {
 			// Rules of generation: