diff --git a/src/learn_move.c b/src/learn_move.c
index b0f0c61e8e..b7beb06bf9 100644
--- a/src/learn_move.c
+++ b/src/learn_move.c
@@ -21,6 +21,15 @@
  * Move relearner state machine
  * ------------------------
  * 
+ * CB2_MoveRelearner_Init
+ *   - Creates moveDisplayArrowTask to listen to right/left buttons.
+ *   - Creates moveListScrollArrowTask to listen to up/down buttons.
+ *   - Whenever the selected move changes (and once on init), the MoveRelearnerCursorCallback
+ *     is called (see sMoveRelearnerMovesListTemplate). That callback will reload the contest
+ *     display and battle display windows for the new move. Both are always loaded in
+ *     memory, but only the currently active one is copied to VRAM. The exception to this
+ *     is the appeal and jam hearts, which are sprites. MoveRelearnerShowHideHearts is called
+ *     while reloading the contest display to control them.
  * MoveRelearnerStateMachine: MENU_STATE_FADE_TO_BLACK
  * MoveRelearnerStateMachine: MENU_STATE_WAIT_FOR_FADE
  *   - Go to MENU_STATE_IDLE_BATTLE_MODE
@@ -70,7 +79,7 @@
  *   - If the player cancels, go to MENU_STATE_SETUP_BATTLE_MODE.
  * 
  * CB2_MoveRelearner_Resume:
- *   - Do most of the same stuff as CB2_InitLearnMove.
+ *   - Do most of the same stuff as CB2_MoveRelearner_Init.
  * MoveRelearnerStateMachine: MENU_STATE_FADE_FROM_SUMMARY_SCREEN
  * MoveRelearnerStateMachine: MENU_STATE_TRY_OVERWRITE_MOVE
  *   - If any of the pokemon's existing moves were chosen, overwrite the move and