docs: fixing doxygen errors reported during make

8 files changed, 16 insertions, 11 deletions

diff --git a/host/include/uhd/rfnoc/block_id.hpp b/host/include/uhd/rfnoc/block_id.hpp
index d15220aa7..113124eea 100644
--- a/host/include/uhd/rfnoc/block_id.hpp
+++ b/host/include/uhd/rfnoc/block_id.hpp
@@ -26,7 +26,7 @@ namespace rfnoc {
  *
  * The rules for formatting such a string are:
  *
- * DEVICE/BLOCKNAME#COUNTER
+ * DEVICE/BLOCKNAME\#COUNTER
  *
  * DEVICE: Identifies the device (usually the motherboard index)
  * BLOCKNAME: A name given to this block
diff --git a/host/include/uhd/rfnoc/mb_controller.hpp b/host/include/uhd/rfnoc/mb_controller.hpp
index 0269301ff..e6276d39c 100644
--- a/host/include/uhd/rfnoc/mb_controller.hpp
+++ b/host/include/uhd/rfnoc/mb_controller.hpp
@@ -345,6 +345,7 @@ public:
      *                       motherboard controller are removed from the list.
      *                       On return, the list should be (ideally) identical
      *                       to its value at call time.
+     * \param time_spec Time specification to syncrhonize \p mb_controllers to
      * \param quiet If true, don't print any errors or warnings if
      *              synchronization fails.
      * \returns true if all motherboards that were removed from \p mb_controllers
diff --git a/host/include/uhd/rfnoc/node.hpp b/host/include/uhd/rfnoc/node.hpp
index 33831a4d7..9424a6b58 100644
--- a/host/include/uhd/rfnoc/node.hpp
+++ b/host/include/uhd/rfnoc/node.hpp
@@ -114,7 +114,7 @@ public:
      * be of a different type than \p prop_data_t due to the usage of runtime
      * type information (RTTI), a lookup_error is thrown.
      *
-     * \param prop_data_t The data type of the property
+     * \tparam prop_data_t The data type of the property
      * \param id The identifier of the property to write. To find out which
      *           values of \p id are valid, call get_property_ids()
      * \param instance The instance number of this property
@@ -148,7 +148,7 @@ public:
      * This is because internally, it can resolve properties, which may cause
      * changes within the object.
      *
-     * \param prop_data_t The data type of the property
+     * \tparam prop_data_t The data type of the property
      * \param id The identifier of the property to write.
      * \param instance The instance number of this property
      * \return The value of the property.
@@ -279,7 +279,7 @@ protected:
      * This is like set_property(), but it also allows setting edge properties.
      * All comments from set_property() still apply.
      *
-     * \param prop_data_t The data type of the property
+     * \tparam prop_data_t The data type of the property
      * \param id The identifier of the property to write. To find out which
      *           values of \p id are valid, call get_property_ids()
      * \param val The new value of the property.
@@ -294,7 +294,7 @@ protected:
      * This is like get_property(), but it also allows reading edge properties.
      * All comments from get_property() still apply.
      *
-     * \param prop_data_t The data type of the property
+     * \tparam prop_data_t The data type of the property
      * \param id The identifier of the property to write.
      * \param src_info Source info of this property
      * \return The value of the property.
diff --git a/host/include/uhd/rfnoc/radio_control.hpp b/host/include/uhd/rfnoc/radio_control.hpp
index 4b1bd3d82..01fcb1d48 100644
--- a/host/include/uhd/rfnoc/radio_control.hpp
+++ b/host/include/uhd/rfnoc/radio_control.hpp
@@ -554,7 +554,7 @@ public:
 
     /*! Enable/disable the automatic IQ imbalance correction.
      *
-     * \param enb true to enable automatic IQ balance correction
+     * \param correction the complex correction (1.0 is full-scale)
      * \param chan the channel index 0 to N-1
      */
     virtual void set_rx_iq_balance(
@@ -582,7 +582,6 @@ public:
      * \param bank the name of a GPIO bank (e.g., FP0)
      * \param attr the name of a GPIO attribute (e.g., CTRL)
      * \param value the new value for this GPIO bank
-     * \param mask the bit mask to effect which pins are changed
      */
     virtual void set_gpio_attr(const std::string& bank,
         const std::string& attr,
diff --git a/host/include/uhd/rfnoc/register_iface.hpp b/host/include/uhd/rfnoc/register_iface.hpp
index 23f24b242..5d95e6aae 100644
--- a/host/include/uhd/rfnoc/register_iface.hpp
+++ b/host/include/uhd/rfnoc/register_iface.hpp
@@ -84,6 +84,7 @@ public:
      *             (truncated to 20 bits).
      * \param data New value of the register(s).
      * \param time The time at which the transaction should be executed.
+     * \param ack Should transaction completion be acknowledged?
      *
      * \throws op_failed if the transaction fails
      * \throws op_timeout if no response is received
diff --git a/host/include/uhd/usrp/multi_usrp.hpp b/host/include/uhd/usrp/multi_usrp.hpp
index 4efc062b0..9742a8ab6 100644
--- a/host/include/uhd/usrp/multi_usrp.hpp
+++ b/host/include/uhd/usrp/multi_usrp.hpp
@@ -1539,13 +1539,14 @@ public:
      * Enumerate the available filters in the RX signal path.
      * \param chan RX channel index 0 to N-1
      * \return a vector of strings representing the selected filter names.
-     * \returnblock Filter names will follow the pattern BLOCK_ID:FILTER_NAME. For example, "0/Radio#0:HB_0"
+     * \return Filter names will follow the pattern BLOCK_ID:FILTER_NAME. For example, "0/Radio#0:HB_0"
      */
     virtual std::vector<std::string> get_rx_filter_names(const size_t chan) = 0;
 
     /*!
      * Return the filter object for the given RX filter name.
      * \param name the name of the filter as returned from get_rx_filter_names().
+     * \param chan RX channel index 0 to N-1
      * \return a filter_info_base::sptr.
      */
     virtual uhd::filter_info_base::sptr get_rx_filter(const std::string& name, const size_t chan) = 0;
@@ -1555,6 +1556,7 @@ public:
      * This filter can be a modified version of the originally returned one.
      * \param name the name of the filter as returned from get_rx_filter_names().
      * \param filter the filter_info_base::sptr of the filter object to be written
+     * \param chan RX channel index 0 to N-1
      */
     virtual void set_rx_filter(
         const std::string& name, uhd::filter_info_base::sptr filter, const size_t chan) = 0;
@@ -1564,13 +1566,14 @@ public:
      * Enumerate the available filters in the TX signal path.
      * \param chan TX channel index 0 to N-1
      * \return a vector of strings representing the selected filter names.
-     * \returnblock Filter names will follow the pattern BLOCK_ID:FILTER_NAME. For example, "0/Radio#0:HB_0"
+     * \return Filter names will follow the pattern BLOCK_ID:FILTER_NAME. For example, "0/Radio#0:HB_0"
      */
     virtual std::vector<std::string> get_tx_filter_names(const size_t chan) = 0;
 
     /*!
      * Return the filter object for the given TX filter name.
      * \param name the name of the filter as returned from get_tx_filter_names().
+     * \param chan TX channel index 0 to N-1
      * \return a filter_info_base::sptr.
      */
     virtual uhd::filter_info_base::sptr get_tx_filter(const std::string& name, const size_t chan) = 0;
@@ -1580,6 +1583,7 @@ public:
      * This filter can be a modified version of the originally returned one.
      * \param name the name of the filter as returned from get_tx_filter_names().
      * \param filter the filter_info_base::sptr of the filter object to be written
+     * \param chan TX channel index 0 to N-1
      */
     virtual void set_tx_filter(
         const std::string& name, uhd::filter_info_base::sptr filter, const size_t chan) = 0;
diff --git a/host/include/uhd/utils/gain_group.hpp b/host/include/uhd/utils/gain_group.hpp
index bfc6a94a6..5901d71bb 100644
--- a/host/include/uhd/utils/gain_group.hpp
+++ b/host/include/uhd/utils/gain_group.hpp
@@ -94,7 +94,6 @@ public:
 
     /*!
      * Make a new gain group with all zero values.
-     * \param name the name of the (only and zero-valued) gain element
      * \return a gain group object populated with zeroes
      */
     static sptr make_zero();
diff --git a/host/include/uhd/utils/graph_utils.hpp b/host/include/uhd/utils/graph_utils.hpp
index b2c61f78f..1cdfe389c 100644
--- a/host/include/uhd/utils/graph_utils.hpp
+++ b/host/include/uhd/utils/graph_utils.hpp
@@ -39,7 +39,7 @@ static const std::vector<block_port_def> TERMINATOR_BLOCKS{
  *  \param graph The rfnoc_graph that is being examined
  *  \param start_block The block we begin to build the chain from
  *  \param port The block port of `src_port` that the path will begin at
- *  \param source_block Whether or not the `start_block` is a source (or a destination).
+ *  \param source_chain Whether or not the `start_block` is a source (or a destination).
  *                      If true, the chain will start at `start_block`'s output port. If
  *                      false, the chain will start with `start_block`'s output port.
  *  \return The edge list representing the data path requested
@@ -52,6 +52,7 @@ std::vector<graph_edge_t> UHD_API get_block_chain(const rfnoc_graph::sptr graph,
 
 /*! Connect desired blocks by whatever path that can be found
  *
+ *  \param graph The rfnoc_graph that is being examined
  *  \param src_blk Source block's ID
  *  \param src_port Block port where the path starts
  *  \param dst_blk Destination block's ID