Docs: Various improvements.

1 files changed, 47 insertions, 40 deletions

diff --git a/docs/source/hardware/maple.rst b/docs/source/hardware/maple.rst
index e460e00..c2dc895 100644
--- a/docs/source/hardware/maple.rst
+++ b/docs/source/hardware/maple.rst
@@ -136,49 +136,54 @@ the header is connected to on the microcontroller.  The "5V?" column
 documents whether or not the pin is 5 volt tolerant.
 
 .. csv-table::
-   :header: "Pin", "STM32", ":ref:`ADC <adc>`", ":ref:`Timer <timers>`", ":ref:`I2C <i2c>`", ":ref:`UART <usart>`", ":ref:`SPI <spi>`", "5v?"
-
-   "D0",  "PA3",  "ADC3",  "TIM2_CH4",     "-",          "USART2_RX",  "-",         "No"
-   "D1",  "PA2",  "ADC2",  "TIM2_CH3",     "-",          "USART2_TX",  "-",         "No"
-   "D2",  "PA0",  "ADC0",  "TIM2_CH1_ETR", "-",          "USART2_CTS", "-",         "No"
-   "D3",  "PA1",  "ADC1",  "TIM2_CH2",     "-",          "USART2_RTS", "-",         "No"
-   "D4",  "PB5",  "-",     "-",            "ISC1_SMBA",  "-",          "-",         "No"
-   "D5",  "PB6",  "-",     "TIM4_CH1",     "I2C1_SCL",   "-",          "-",         "Yes"
-   "D6",  "PA8",  "-",     "TIM1_CH1",     "-",          "USART1_CK",  "-",         "Yes"
-   "D7",  "PA9",  "-",     "TIM1_CH2",     "-",          "USART1_TX",  "-",         "Yes"
-   "D8",  "PA10", "-",     "TIM1_CH3",     "-",          "USART1_RX",  "-",         "Yes"
-   "D9",  "PB7",  "-",     "TIM4_CH2",     "I2C1_SDA",   "-",          "-",         "Yes"
-   "D10", "PA4",  "ADC4",  "-",            "-",          "USART2_CK",  "SPI1_NSS",  "No"
-   "D11", "PA7",  "ADC7",  "TIM3_CH2",     "-",          "-",          "SPI1_MOSI", "No"
-   "D12", "PA6",  "ADC6",  "TIM3_CH1",     "-",          "-",          "SPI1_MISO", "No"
-   "D13", "PA5",  "ADC5",  "-",            "-",          "-",          "SPI1_SCK",  "No"
-   "D14", "PB8",  "-",     "TIM4_CH3",     "-",          "-",          "-",         "Yes"
-   "D15", "PC0",  "ADC10", "-",            "-",          "-",          "-",         "No"
-   "D16", "PC1",  "ADC11", "-",            "-",          "-",          "-",         "No"
-   "D17", "PC2",  "ADC12", "-",            "-",          "-",          "-",         "No"
-   "D18", "PC3",  "ADC13", "-",            "-",          "-",          "-",         "No"
-   "D19", "PC4",  "ADC14", "-",            "-",          "-",          "-",         "No"
-   "D20", "PC5",  "ADC15", "-",            "-",          "-",          "-",         "No"
-   "D21", "PC13", "-",     "-",            "-",          "-",          "-",         "No"
-   "D22", "PC14", "-",     "-",            "-",          "-",          "-",         "No"
-   "D23", "PC15", "-",     "-",            "-",          "-",          "-",         "No"
-   "D24", "PB9",  "-",     "TIM4_CH4",     "-",          "-",          "-",         "Yes"
-   "D25", "PD2",  "-",     "TIM3_ETR",     "-",          "-",          "-",         "Yes"
-   "D26", "PC10", "-",     "-",            "-",          "-",          "-",         "Yes"
-   "D27", "PB0",  "ADC8",  "TIM3_CH3",     "-",          "-",          "-",         "No"
-   "D28", "PB1",  "ADC9",  "TIM3_CH4",     "-",          "-",          "-",         "No"
-   "D29", "PB10", "-",     "-",            "I2C2_SCL",   "USART3_TX",  "-",         "Yes"
-   "D30", "PB11", "-",     "-",            "I2C2_SDA",   "USART3_RX",  "-",         "Yes"
-   "D31", "PB12", "-",     "TIM1_BKIN",    "I2C2_SMBA",  "USART3_CK",  "SPI2_NSS",  "Yes"
-   "D32", "PB13", "-",     "TIM1_CH1N",    "-",          "USART3_CTS", "SPI2_SCK",  "Yes"
-   "D33", "PB14", "-",     "TIM1_CH2N",    "-",          "USART3_RTS", "SPI2_MISO", "Yes"
-   "D34", "PB15", "-",     "TIM1_CH3N",    "-",          "-",          "SPI2_MOSI", "Yes"
-   "D35", "PC6",  "-",     "-",            "-",          "-",          "-",         "Yes"
-   "D36", "PC7",  "-",     "-",            "-",          "-",          "-",         "Yes"
-   "D37", "PC8",  "-",     "-",            "-",          "-",          "-",         "Yes"
+   :header: Pin, STM32, :ref:`ADC <adc>`, :ref:`Timer <timers>`, :ref:`I2C <i2c>`, :ref:`UART <usart>`, :ref:`SPI <spi>`, 5v?
+
+   D0,  PA3,  ADC3,  TIM2_CH4,     -,          USART2_RX,  -,         No
+   D1,  PA2,  ADC2,  TIM2_CH3,     -,          USART2_TX,  -,         No
+   D2,  PA0,  ADC0,  TIM2_CH1_ETR, -,          USART2_CTS, -,         No
+   D3,  PA1,  ADC1,  TIM2_CH2,     -,          USART2_RTS, -,         No
+   D4,  PB5,  -,     -,            ISC1_SMBA,  -,          -,         No
+   D5,  PB6,  -,     TIM4_CH1,     I2C1_SCL,   -,          -,         Yes
+   D6,  PA8,  -,     TIM1_CH1,     -,          USART1_CK,  -,         Yes
+   D7,  PA9,  -,     TIM1_CH2,     -,          USART1_TX,  -,         Yes
+   D8,  PA10, -,     TIM1_CH3,     -,          USART1_RX,  -,         Yes
+   D9,  PB7,  -,     TIM4_CH2,     I2C1_SDA,   -,          -,         Yes
+   D10, PA4,  ADC4,  -,            -,          USART2_CK,  SPI1_NSS,  No
+   D11, PA7,  ADC7,  TIM3_CH2,     -,          -,          SPI1_MOSI, No
+   D12, PA6,  ADC6,  TIM3_CH1,     -,          -,          SPI1_MISO, No
+   D13, PA5,  ADC5,  -,            -,          -,          SPI1_SCK,  No
+   D14, PB8,  -,     TIM4_CH3,     -,          -,          -,         Yes
+   D15, PC0,  ADC10, -,            -,          -,          -,         No
+   D16, PC1,  ADC11, -,            -,          -,          -,         No
+   D17, PC2,  ADC12, -,            -,          -,          -,         No
+   D18, PC3,  ADC13, -,            -,          -,          -,         No
+   D19, PC4,  ADC14, -,            -,          -,          -,         No
+   D20, PC5,  ADC15, -,            -,          -,          -,         No
+   D21, PC13, -,     -,            -,          -,          -,         No
+   D22, PC14, -,     -,            -,          -,          -,         No
+   D23, PC15, -,     -,            -,          -,          -,         No
+   D24, PB9,  -,     TIM4_CH4,     -,          -,          -,         Yes
+   D25, PD2,  -,     TIM3_ETR,     -,          -,          -,         Yes
+   D26, PC10, -,     -,            -,          -,          -,         Yes
+   D27, PB0,  ADC8,  TIM3_CH3,     -,          -,          -,         No
+   D28, PB1,  ADC9,  TIM3_CH4,     -,          -,          -,         No
+   D29, PB10, -,     -,            I2C2_SCL,   USART3_TX,  -,         Yes
+   D30, PB11, -,     -,            I2C2_SDA,   USART3_RX,  -,         Yes
+   D31, PB12, -,     TIM1_BKIN,    I2C2_SMBA,  USART3_CK,  SPI2_NSS,  Yes
+   D32, PB13, -,     TIM1_CH1N,    -,          USART3_CTS, SPI2_SCK,  Yes
+   D33, PB14, -,     TIM1_CH2N,    -,          USART3_RTS, SPI2_MISO, Yes
+   D34, PB15, -,     TIM1_CH3N,    -,          -,          SPI2_MOSI, Yes
+   D35, PC6,  -,     -,            -,          -,          -,         Yes
+   D36, PC7,  -,     -,            -,          -,          -,         Yes
+   D37, PC8,  -,     -,            -,          -,          -,         Yes
 
 .. TODO [0.0.10] JTAG pins
 
+.. The following pins are used for :ref:`jtag` debugging by default, but
+.. can be used as ordinary GPIOs through the use of the
+.. :ref:`lang-disabledebugports` function.  (Though see :ref:`this
+.. erratum <maple-reset-njtrst>`).
+
 Timer Pin Map
 ^^^^^^^^^^^^^
 
@@ -353,6 +358,8 @@ Rev 5
   from its silkscreen.  This mistake was fixed in later manufacturing
   runs.
 
+.. _maple-reset-njtrst:
+
 * **Reset and NJTRST tied together**: The MCU's reset pin is connected
   to PB4, the NJTRST pin, which is pin 43.  Thus, attempting to use
   pin 43 as a GPIO will reset your board (and also prevents the JTAG