CHange semantics of reset_joy to make more sense

docs/stdlib/input.md

@@ -21,9 +21,9 @@ Vertical joystick movement. 1 if down, -1 if up, 0 if neither.
 
 #### `void reset_joy()`
 
-Resets the state variables.
-For platforms with more than one button, this resets only the main button state.
-On those platforms use the platform-specific functions instead. 
+Resets the state variables.  
+The default implementation resets only the main button.  
+May be overridden by a strong alias on some platforms that have more buttons.
 
 ## null_joy_default
 
@@ -31,6 +31,8 @@ This module set the default joystick to no joystick.
 
 #### `alias read_joy`
 
+A reserved name for reading the default joystick.
+
 ## mouse
 
 The `mouse` module automatically imports the `x_coord` module.

docs/stdlib/nes.md

@@ -76,9 +76,9 @@ Reads the joypad from the port 1 and adds its readouts to the current readouts.
 Reads the joypad from the port 2 and adds its readouts to the current readouts.
 
 #### `void nes_reset_joy()`
+#### `alias reset_joy = nes_reset_joy!`
 
 Resets the state variables.
-Unlike `reset_joy`, this resets all the NES button states.
 
 ## nes_joy1_default