From 9642846d71451ce12579da421567ebf63560c829 Mon Sep 17 00:00:00 2001
From: Damien George <damien.p.george@gmail.com>
Date: Tue, 16 Dec 2014 11:55:46 +0000
Subject: [PATCH] docs: Define more clearly the behaviour of LED methods.

Addresses issue #1006.
---
 docs/library/pyb.LED.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/library/pyb.LED.rst b/docs/library/pyb.LED.rst
index 02fc132463..461ea57d31 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.