Mercurial > hg > dbutils / file diff

--- a/ucx/cx/streams.h	Sun Feb 16 17:38:07 2025 +0100
+++ b/ucx/cx/streams.h	Tue Feb 25 21:12:11 2025 +0100
@@ -27,13 +27,13 @@
  */
 
 /**
- * \file streams.h
+ * @file streams.h
  *
- * \brief Utility functions for data streams.
+ * @brief Utility functions for data streams.
  *
- * \author Mike Becker
- * \author Olaf Wintermann
- * \copyright 2-Clause BSD License
+ * @author Mike Becker
+ * @author Olaf Wintermann
+ * @copyright 2-Clause BSD License
  */
 
 #ifndef UCX_STREAMS_H
@@ -52,12 +52,12 @@
  * @param dest the destination stream
  * @param rfnc the read function
  * @param wfnc the write function
- * @param buf a pointer to the copy buffer or \c NULL if a buffer
+ * @param buf a pointer to the copy buffer or @c NULL if a buffer
  * shall be implicitly created on the heap
- * @param bufsize the size of the copy buffer - if \p buf is \c NULL you can
+ * @param bufsize the size of the copy buffer - if @p buf is @c NULL you can
  * set this to zero to let the implementation decide
  * @param n the maximum number of bytes that shall be copied.
- * If this is larger than \p bufsize, the content is copied over multiple
+ * If this is larger than @p bufsize, the content is copied over multiple
  * iterations.
  * @return the total number of bytes copied
  */
@@ -65,6 +65,7 @@
 cx_attr_access_r(1)
 cx_attr_access_w(2)
 cx_attr_access_w(5)
+cx_attr_export
 size_t cx_stream_bncopy(
         void *src,
         void *dest,
@@ -78,14 +79,14 @@
 /**
  * Reads data from a stream and writes it to another stream.
  *
- * @param src the source stream
- * @param dest the destination stream
- * @param rfnc the read function
- * @param wfnc the write function
- * @param buf a pointer to the copy buffer or \c NULL if a buffer
+ * @param src (@c void*) the source stream
+ * @param dest (@c void*) the destination stream
+ * @param rfnc (@c cx_read_func) the read function
+ * @param wfnc (@c cx_write_func) the write function
+ * @param buf (@c char*) a pointer to the copy buffer or @c NULL if a buffer
  * shall be implicitly created on the heap
- * @param bufsize the size of the copy buffer - if \p buf is \c NULL you can
- * set this to zero to let the implementation decide
+ * @param bufsize (@c size_t) the size of the copy buffer - if @p buf is
+ * @c NULL you can set this to zero to let the implementation decide
  * @return total number of bytes copied
  */
 #define cx_stream_bcopy(src, dest, rfnc, wfnc, buf, bufsize) \
@@ -106,6 +107,7 @@
 cx_attr_nonnull
 cx_attr_access_r(1)
 cx_attr_access_w(2)
+cx_attr_export
 size_t cx_stream_ncopy(
         void *src,
         void *dest,
@@ -119,10 +121,10 @@
  *
  * The data is temporarily stored in a stack allocated buffer.
  *
- * @param src the source stream
- * @param dest the destination stream
- * @param rfnc the read function
- * @param wfnc the write function
+ * @param src (@c void*) the source stream
+ * @param dest (@c void*) the destination stream
+ * @param rfnc (@c cx_read_func) the read function
+ * @param wfnc (@c cx_write_func) the write function
  * @return total number of bytes copied
  */
 #define cx_stream_copy(src, dest, rfnc, wfnc) \