diff --git a/modules/juce_blocks_basics/juce_LittleFootFunctions.dox b/modules/juce_blocks_basics/juce_LittleFootFunctions.dox
index 1d7ce53f63..a7965f1caf 100644
--- a/modules/juce_blocks_basics/juce_LittleFootFunctions.dox
+++ b/modules/juce_blocks_basics/juce_LittleFootFunctions.dox
@@ -272,21 +272,25 @@ void handleButtonDown (int index);
 */
 void handleButtonUp (int index);
 
-/** Called when a control block button is pressed.
+/** Call this when a control block button is pressed to trigger the buttons default behaviour.
 
     @param buttonIndex    the index of the button
 
     @note Requires >= 0.2.5 firmware
     @note Only valid with a control block
+
+    @see initControl onControlRelease
 */
 void onControlPress (int buttonIndex);
 
-/** Called when a control block button is released.
+/** Call this when a control block button is released to trigger the buttons default behaviour.
 
     @param buttonIndex    the index of the button
 
     @note Requires >= 0.2.5 firmware
     @note Only valid with a control block
+
+    @see initControl onControlPress
 */
 void onControlRelease (int buttonIndex);