diff --git a/src/fileio/fileio_scen.cpp b/src/fileio/fileio_scen.cpp
index 899f467d..7b7032f7 100644
--- a/src/fileio/fileio_scen.cpp
+++ b/src/fileio/fileio_scen.cpp
@@ -1074,6 +1074,8 @@ void readScenarioFromXml(ticpp::Document&& data, cScenario& scenario) {
 		throw xMissingElem("scenario", *reqs.begin(), data.FirstChildElement()->Row(), data.FirstChildElement()->Column(), fname);
 }
 
+// This state is serialized in scen.fileio.cpp: writeEditorStateToXml()
+// and re-applied at editor launch in scen.actions.cpp: restore_editor_state()
 void readEditorStateFromXml(ticpp::Document&& data, cScenario& scenario) {
 	using namespace ticpp;
 	int maj, min, rev;
diff --git a/src/scenedit/scen.actions.cpp b/src/scenedit/scen.actions.cpp
index 068bb246..b5f4a146 100644
--- a/src/scenedit/scen.actions.cpp
+++ b/src/scenedit/scen.actions.cpp
@@ -3198,6 +3198,9 @@ bool monst_on_space(location loc,short m_num) {
 	
 }
 
+// Restore the state of the editor when the designer last saved this scenario.
+// This state is serialized in scen.fileio.cpp: writeEditorStateToXml()
+// and parsed in fileio_scen.cpp: readEditorStateFromXml().
 void restore_editor_state(bool first_time) {
 	set_current_town(scenario.editor_state.last_town_edited, first_time);
 	set_current_out(scenario.editor_state.last_out_edited, false, first_time);
diff --git a/src/scenedit/scen.fileio.cpp b/src/scenedit/scen.fileio.cpp
index cf548f2f..eda10f8d 100644
--- a/src/scenedit/scen.fileio.cpp
+++ b/src/scenedit/scen.fileio.cpp
@@ -122,6 +122,8 @@ namespace ticpp {
 	}
 }
 
+// This state is parsed in fileio_scen.cpp: readEditorStateFromXml()
+// and re-applied at editor launch in scen.actions.cpp: restore_editor_state()
 void writeEditorStateToXml(ticpp::Printer&& data, cScenario& scenario) {
 	editor_state_t editor_state = scenario.editor_state;