From edaf998db012d201b76ef665a00a3ed194f79493 Mon Sep 17 00:00:00 2001
From: Mark <mark@microbit.org>
Date: Wed, 7 Apr 2021 15:07:57 +0100
Subject: [PATCH] docs: Indicate pin_speaker is only for PWM (#715)

---
 docs/pin.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/pin.rst b/docs/pin.rst
index 29da1b663..3cf539d0d 100644
--- a/docs/pin.rst
+++ b/docs/pin.rst
@@ -79,7 +79,9 @@ in MicroPython, but that are not available via the edge connector:
 * ``pin_logo`` - A touch sensitive logo pin on the front of the micro:bit,
   which by default is set to capacitive touch mode.
 
-* ``pin_speaker`` - A pin to address the micro:bit speaker.
+* ``pin_speaker`` - A pin to address the micro:bit speaker. This API is
+  intended only for use in Pulse-Width Modulation pin operations eg.
+  ``pin_speaker.write_analog(128)``.
 
 
 Pulse-Width Modulation