docs: Define more clearly the behaviour of LED methods.

Addresses issue #1006.