docs: Clarified there can only be one streamer per device

2 files changed, 12 insertions, 4 deletions

diff --git a/host/include/uhd/device.hpp b/host/include/uhd/device.hpp
index 1090c243c..b54ffc5f7 100644
--- a/host/include/uhd/device.hpp
+++ b/host/include/uhd/device.hpp
@@ -77,10 +77,18 @@ public:
      */
     static sptr make(const device_addr_t &hint, size_t which = 0);
 
-    //! Make a new receive streamer from the streamer arguments
+    /*! \brief Make a new receive streamer from the streamer arguments
+     *
+     * Note: There can always only be one streamer. When calling get_rx_stream()
+     * a second time, the first streamer must be destroyed beforehand.
+     */
     virtual rx_streamer::sptr get_rx_stream(const stream_args_t &args) = 0;
 
-    //! Make a new transmit streamer from the streamer arguments
+    /*! \brief Make a new transmit streamer from the streamer arguments
+     *
+     * Note: There can always only be one streamer. When calling get_tx_stream()
+     * a second time, the first streamer must be destroyed beforehand.
+     */
     virtual tx_streamer::sptr get_tx_stream(const stream_args_t &args) = 0;
 
     //! Get access to the underlying property structure
diff --git a/host/include/uhd/usrp/multi_usrp.hpp b/host/include/uhd/usrp/multi_usrp.hpp
index 5b4991202..aac40efe5 100644
--- a/host/include/uhd/usrp/multi_usrp.hpp
+++ b/host/include/uhd/usrp/multi_usrp.hpp
@@ -118,12 +118,12 @@ public:
      */
     virtual device::sptr get_device(void) = 0;
 
-    //! Convenience method to get a RX streamer
+    //! Convenience method to get a RX streamer. See also uhd::device::get_rx_stream().
     rx_streamer::sptr get_rx_stream(const stream_args_t &args){
         return this->get_device()->get_rx_stream(args);
     }
 
-    //! Convenience method to get a TX streamer
+    //! Convenience method to get a TX streamer. See also uhd::device::get_rx_stream().
     tx_streamer::sptr get_tx_stream(const stream_args_t &args){
         return this->get_device()->get_tx_stream(args);
     }