diff --git a/data/predef_pointers.asm b/data/predef_pointers.asm
index 7d7064005..a6e2aa26f 100644
--- a/data/predef_pointers.asm
+++ b/data/predef_pointers.asm
@@ -1,3 +1,6 @@
+; Predef routines can be used with the "predef" and "predef_jump" macros.
+; This preserves registers bc, de, hl and f.
+
 add_predef: MACRO
 \1Predef::
 	dab \1
diff --git a/data/special_pointers.asm b/data/special_pointers.asm
index e6ad1797d..6320838fc 100644
--- a/data/special_pointers.asm
+++ b/data/special_pointers.asm
@@ -1,3 +1,6 @@
+; Special routines can be used with the "special" map script command.
+; They often use ScriptVar for arguments and return values.
+
 add_special: MACRO
 \1Special::
 	dba \1