diff --git a/src/document.c b/src/document.c
index 20da7c3f6..a98521bd7 100644
--- a/src/document.c
+++ b/src/document.c
@@ -89,7 +89,8 @@ GeanyFilePrefs file_prefs;
  * check @c doc_ptr->is_valid. Of course, the pointer may represent a different
  * file by then.
  *
- * You also need to check @c GeanyDocument::is_valid when iterating over this array.
+ * You also need to check @c GeanyDocument::is_valid when iterating over this array,
+ * although usually you would just use the documents_foreach() macro.
  *
  * Never assume that the order of document pointers is the same as the order of notebook tabs.
  * Notebook tabs can be reordered. Use @c document_get_from_page(). */