Merge branch 'refactor'

This merges the libmaple refactor work into master.  The contents of
libmaple proper (/libmaple/) are almost completely incompatible with
previous APIs in master.  See /docs/source/libmaple/overview.rst for
more information on the new design.

Wirish incompatibilities are limited to the HardwareTimer class;
however, there are several new deprecations, most likely to be removed
in 0.1.0.

1 files changed, 16 insertions, 23 deletions

diff --git a/docs/source/lang/api/digitalread.rst b/docs/source/lang/api/digitalread.rst
index 3502587..ccf4a4c 100644
--- a/docs/source/lang/api/digitalread.rst
+++ b/docs/source/lang/api/digitalread.rst
@@ -8,51 +8,44 @@ digitalRead()
 Reads the value from a specified digital pin, either :ref:`HIGH
 <lang-constants-high>` or :ref:`LOW <lang-constants-low>`.
 
-
 Library Documentation
 ---------------------
 
 .. doxygenfunction:: digitalRead
 
+Discussion
+----------
+
+If the pin isn't connected to anything, ``digitalRead()`` can return
+either HIGH or LOW (and this will change in a way that seems random).
 
 Example
 -------
 
-The following example turns the LED on when the button is pressed::
-
-    int ledPin = 13;     // LED connected to Maple pin 13
-    int buttonPin = 38;  // BUT connected to Maple pin 38
+The following example turns the LED on or off when the button is pressed::
 
     void setup() {
-      pinMode(ledPin, OUTPUT);
-      pinMode(buttonPin, INPUT);
+      pinMode(BOARD_LED_PIN, OUTPUT);
+      pinMode(BOARD_BUTTON_PIN, INPUT);
     }
 
     void loop() {
-      int val = digitalRead(buttonPin);   // reads the input pin
-      digitalWrite(ledPin, val);
+      int val = digitalRead(BOARD_BUTTON_PIN);   // reads the input pin
+      togglePin(BOARD_LED_PIN, val);
     }
 
-Note
-----
-
-If the pin isn't connected to anything, ``digitalRead()`` can return
-either HIGH or LOW (and this can change in a way that seems random).
-
 Arduino Compatibility
 ---------------------
 
 The Maple version of ``digitalRead()`` is compatible with Arduino.
 
-
 See Also
 --------
 
--  :ref:`pinMode <lang-pinMode>`
--  :ref:`digitalWrite <lang-digitalWrite>`
-
-
-
-
+- :ref:`BOARD_BUTTON_PIN <lang-board-values-but>`
+- :ref:`lang-isButtonPressed`
+- :ref:`lang-pinmode`
+- :ref:`lang-digitalWrite`
+- :ref:`lang-togglepin`
 
-.. include:: cc-attribution.txt
+.. include:: /arduino-cc-attribution.txt