diff --git a/src/symbols.c b/src/symbols.c
index aadbdf80..f63c7f0a 100644
--- a/src/symbols.c
+++ b/src/symbols.c
@@ -1317,7 +1317,9 @@ static void update_tree_tags(GeanyDocument *doc, GList **tags)
 	GList *item;
 
 	/* Build hash tables holding tags and parents */
-	/* parent table is GHashTable<tag_name, GTree<line_num, GtkTreeIter>> */
+	/* parent table is GHashTable<tag_name, GTree<line_num, GtkTreeIter>>
+	 * where tag_name might be a fully qualified name (with scope) if the language
+	 * parser reports scope properly (see tm_tag_has_full_context()). */
 	parents_table = g_hash_table_new_full(g_str_hash, g_str_equal, g_free, parents_table_value_free);
 	/* tags table is another representation of the @tags list,
 	 * GHashTable<TMTag, GTree<line_num, GList<GList<TMTag>>>> */