Merge branch 'legacy'

- superficial rebranding to librambutan
- bugfixes to documentation syntax

4 files changed, 14 insertions, 7 deletions

diff --git a/docs/source/libmaple/api/dma.rst b/docs/source/libmaple/api/dma.rst
index 286b6d6..4ce298d 100644
--- a/docs/source/libmaple/api/dma.rst
+++ b/docs/source/libmaple/api/dma.rst
@@ -34,6 +34,10 @@ Devices
 Functions
 ---------
 
+.. NB: Some of these functions have multiple definitions, in which case the
+   complete function signature needs to be specified to disambiguate or breathe
+   will choke ("Unable to resolve multiple matches for function"...)
+
 .. doxygenfunction:: dma_init
 .. doxygenfunction:: dma_setup_transfer
 .. doxygenfunction:: dma_set_num_transfers
@@ -43,12 +47,12 @@ Functions
 .. doxygenfunction:: dma_get_irq_cause
 .. doxygenfunction:: dma_enable
 .. doxygenfunction:: dma_disable
-.. doxygenfunction:: dma_set_mem_addr
+.. doxygenfunction:: dma_set_mem_addr(dma_dev *, dma_tube, __io void *)
 .. doxygenfunction:: dma_set_per_addr
 .. doxygendefine:: dma_channel_regs
 .. doxygendefine:: dma_is_channel_enabled
-.. doxygenfunction:: dma_get_isr_bits
-.. doxygenfunction:: dma_clear_isr_bits
+.. doxygenfunction:: dma_get_isr_bits(dma_dev *, dma_tube)
+.. doxygenfunction:: dma_clear_isr_bits(dma_dev *, dma_tube)
 
 Register Map Base Pointers
 --------------------------
diff --git a/docs/source/libmaple/api/gpio.rst b/docs/source/libmaple/api/gpio.rst
index 9e8e5c7..5f631d5 100644
--- a/docs/source/libmaple/api/gpio.rst
+++ b/docs/source/libmaple/api/gpio.rst
@@ -42,14 +42,17 @@ Functions
 
 .. doxygenfunction:: gpio_init
 .. doxygenfunction:: gpio_init_all
-.. doxygenfunction:: gpio_set_mode
+.. doxygenfunction:: gpio_set_mode(gpio_dev *, uint8, gpio_pin_mode)
 .. doxygenfunction:: gpio_exti_port
 .. doxygenfunction:: gpio_write_bit
 .. doxygenfunction:: gpio_read_bit
 .. doxygenfunction:: gpio_toggle_bit
 
 .. doxygenfunction:: afio_init
-.. doxygenfunction:: afio_exti_select
+
+.. c:macro:: afio_exti_select(exti, port)
+
+   Macro for `exti_select((exti), (port))`.
 
 .. _gpio-h-afio-remap:
 .. doxygenfunction:: afio_remap
diff --git a/docs/source/libmaple/api/nvic.rst b/docs/source/libmaple/api/nvic.rst
index 505e36e..815da2b 100644
--- a/docs/source/libmaple/api/nvic.rst
+++ b/docs/source/libmaple/api/nvic.rst
@@ -49,7 +49,7 @@ Functions
 .. doxygenfunction:: nvic_globalirq_disable
 .. doxygenfunction:: nvic_irq_enable
 .. doxygenfunction:: nvic_irq_disable
-.. doxygenfunction:: nvic_irq_disable_all
+.. doxygenfunction:: nvic_irq_disable_all(void)
 .. doxygenfunction:: nvic_sys_reset
 
 Register Maps
diff --git a/docs/source/libmaple/api/util.rst b/docs/source/libmaple/api/util.rst
index 54377c0..2f6e080 100644
--- a/docs/source/libmaple/api/util.rst
+++ b/docs/source/libmaple/api/util.rst
@@ -50,5 +50,5 @@ If an assertion fails, execution is halted at the point of the failed
 assertion.  When libmaple has been configured properly (Wirish
 performs this configuration by default), the built-in LED throbs in a
 smooth pattern to signal the failed assertion (using
-:c:func:`throb()`), and the file and line where the assert failed are
+``throb()``), and the file and line where the assert failed are
 transmitted to the user as detailed in :ref:`lang-assert`.