From d7212508f203d03b4931b94695fb10cb8a7862c2 Mon Sep 17 00:00:00 2001 From: bnewbold Date: Wed, 27 Aug 2014 19:02:33 -0400 Subject: docs: first pass removal of board-specific hardware info --- docs/source/lang/api/analogread.rst | 5 ++--- docs/source/lang/api/board-values.rst | 8 ++++---- docs/source/lang/api/disabledebugports.rst | 4 +++- docs/source/lang/api/pwmwrite.rst | 5 ++--- 4 files changed, 11 insertions(+), 11 deletions(-) (limited to 'docs/source/lang/api') diff --git a/docs/source/lang/api/analogread.rst b/docs/source/lang/api/analogread.rst index 6665a94..59eab79 100644 --- a/docs/source/lang/api/analogread.rst +++ b/docs/source/lang/api/analogread.rst @@ -40,9 +40,8 @@ listed underneath their number on your board's silkscreen. These pin numbers are available to your program in the :ref:`boardADCPins ` board-specific array. The number of pins which are capable of analog to digital conversion on your board -is given by the ``BOARD_NR_ADC_PINS`` constant. These values are -documented for each board in the :ref:`Board Hardware Documentation -` pages. +is given by the ``BOARD_NR_ADC_PINS`` constant. See your board's +documentation for these values. .. note:: Pin 3 is not marked ``AIN`` on the silkscreen for Maple revisions through Rev 5; however **it does work** as an analog diff --git a/docs/source/lang/api/board-values.rst b/docs/source/lang/api/board-values.rst index d944c8d..70eff60 100644 --- a/docs/source/lang/api/board-values.rst +++ b/docs/source/lang/api/board-values.rst @@ -7,8 +7,8 @@ Board-Specific Values There are a number of board-specific values: constants or variables which are different depending on which LeafLabs board you have. The -exact values for each board are given in your :ref:`board's hardware -documentation `. +exact values for each board are given in your board's hardware +documentation. This page lists and documents the board-specific values. You should use these when appropriate in your own programs. This will help make @@ -122,8 +122,8 @@ Constants `). However, they can be used as ordinary GPIOs if you call the :ref:`lang-disabledebugports` function. (Be careful with this on the Maple and Maple RET6 - Edition, as writing to ``BOARD_NJTRST_PIN`` :ref:`may cause your - board to reset `\ !). + Edition, as writing to ``BOARD_NJTRST_PIN`` may cause your + board to reset!). .. _lang-board-values-pwm-pins: diff --git a/docs/source/lang/api/disabledebugports.rst b/docs/source/lang/api/disabledebugports.rst index 283cdbf..071d4c3 100644 --- a/docs/source/lang/api/disabledebugports.rst +++ b/docs/source/lang/api/disabledebugports.rst @@ -30,4 +30,6 @@ See Also -------- - :ref:`lang-enabledebugports` -- :ref:`Important erratum on Maple pin 43 ` +- Important erratum on Maple pin 43 + +.. TODO direct off-site link to diff --git a/docs/source/lang/api/pwmwrite.rst b/docs/source/lang/api/pwmwrite.rst index 5cc112e..aa39ab1 100644 --- a/docs/source/lang/api/pwmwrite.rst +++ b/docs/source/lang/api/pwmwrite.rst @@ -15,9 +15,8 @@ The pins which support PWM have ``PWM`` listed underneath their number on your board's silkscreen. These pin numbers are available to your program in the :ref:`boardPWMPins ` board-specific array. The number of pins which are capable of PWM on -your board is given by the ``BOARD_NR_PWM_PINS`` constant. These -values are documented for each board in the :ref:`Board Hardware -Documentation ` pages. +your board is given by the ``BOARD_NR_PWM_PINS`` constant. See your +board's documentation for these values. The Arduino function :ref:`analogWrite() ` is an alias for ``pwmWrite()``, but it is badly named, and its use is -- cgit v1.2.3