diff --git a/docs/library/pyb.LED.rst b/docs/library/pyb.LED.rst
index 02fc1324631e70f0e221c17adcdadf69dce0f97b..461ea57d31e9329a33cab7fcda3227b895b9c0dc 100644
--- a/docs/library/pyb.LED.rst
+++ b/docs/library/pyb.LED.rst
@@ -31,8 +31,9 @@ Methods
 
 .. method:: led.on()
 
-   Turn the LED on.
+   Turn the LED on, to maximum intensity.
 
 .. method:: led.toggle()
 
-   Toggle the LED between on and off.
+   Toggle the LED between on (maximum intensity) and off.  If the LED is at
+   non-zero intensity then it is considered "on" and toggle will turn it off.