diff --git a/src/gui.c b/src/gui.c
index adca7fb..a7ae722 100644
--- a/src/gui.c
+++ b/src/gui.c
@@ -2714,7 +2714,7 @@
 }
 
 /*
- * Fill buffer with mouse coordinates encoded for check_termcode().
+ * Fill p[4] with mouse coordinates encoded for check_termcode().
  */
     static void
 fill_mouse_coord(p, col, row)
diff --git a/src/gui.h b/src/gui.h
index 2e757b8..14b8d3f 100644
--- a/src/gui.h
+++ b/src/gui.h
@@ -71,6 +71,10 @@
 # define ALWAYS_USE_GUI
 #endif
 
+/*
+ * On some systems scrolling needs to be done right away instead of in the
+ * main loop.
+ */
 #if defined(FEAT_GUI_MSWIN) || defined(FEAT_GUI_MAC) || defined(HAVE_GTK2)
 # define USE_ON_FLY_SCROLL
 #endif