1 files changed, 22 insertions, 21 deletions

diff --git a/docs/source/lang/pinmode.rst b/docs/source/lang/pinmode.rst
index aed23d6..b9095da 100644
--- a/docs/source/lang/pinmode.rst
+++ b/docs/source/lang/pinmode.rst
@@ -18,50 +18,51 @@ Library Documentation
 Discussion
 ----------
 
-pinMode() is usually called within :ref:`lang-setup` in order to
+``pinMode()`` is usually called within :ref:`lang-setup` in order to
 configure a pin for a certain usage (although it may be called
 anywhere).
 
-
 Example
 -------
 
- ::
-
+::
 
     int ledPin = 13;                 // LED connected to digital pin 13
 
-    void setup()
-    {
+    void setup() {
       pinMode(ledPin, OUTPUT);      // sets the digital pin as output
     }
 
-    void loop()
-    {
+    void loop() {
       digitalWrite(ledPin, HIGH);   // sets the LED on
       delay(1000);                  // waits for a second
       digitalWrite(ledPin, LOW);    // sets the LED off
       delay(1000);                  // waits for a second
     }
 
-
-
 Arduino Compatibility
 ---------------------
 
-The libmaple implementation of pinMode() supports OUTPUT and INPUT
-modes with a meaning identical to that of the Arduino function.
+.. TODO check out Arduino vs. Maple static discilpline cutoffs to
+.. ensure accuracy of following:
+
+The libmaple implementation of ``pinMode()`` supports the ``INPUT``
+and ``OUTPUT`` modes with semantics identical to that of the Arduino
+function (however, be advised that the Maple, as a 3.3V device, will
+only drive 3.3V to an ``OUTPUT`` pin that has been set ``HIGH``).
+
+``INPUT_ANALOG`` and ``PWM`` modes were added because the Maple does
+not distinguish between analog and digital pins the same way the
+Arduino does.  Unlike the Arduino, you **must call** ``pinMode()`` to
+set up a pin for these purposes before a call to, e.g.,
+:ref:`lang-analogRead`.  In practice, this should only add a few lines
+to your :ref:`lang-setup` function.
 
-INPUT_ANALOG and PWM modes were added because the Maple does not
-distinguish between analog and digital pins the same way the Arduino
-does.  Unlike the Arduino, you **must call pinMode**\ () to set up a pin
-for these purposes before a call to, e.g., :ref:`lang-analogRead`.
-In practice, this should only add a few lines of pinMode() calls to
-your :ref:`lang-setup` function.
+.. TODO verify following before putting it in:
 
-OUTPUT_OPEN_DRAIN, INPUT_PULLUP, INPUT_PULLDOWN, and PWM_OPEN_DRAIN
-modes represent functionality not currently available on Arduino
-boards.
+.. ``OUTPUT_OPEN_DRAIN``, ``INPUT_PULLUP``, ``INPUT_PULLDOWN``, and
+.. ``PWM_OPEN_DRAIN`` modes represent functionality not currently
+.. available on Arduino boards.
 
 See also
 --------