protogen: a bit more generated docs tidying

[disorder] / lib / client-stubs.h

diff --git a/lib/client-stubs.h b/lib/client-stubs.h
index 8b0f4c589440ec19a618fc03d6c4b8f9e0ff0942..1962df2799ddfa5163ac0acd19121158c980788c 100644 (file)
--- a/lib/client-stubs.h
+++ b/lib/client-stubs.h
@@ -22,6 +22,11 @@
  */
 #ifndef CLIENT_STUBS_H
 #define CLIENT_STUBS_H
+/** @file lib/client-stubs.h
+ * @brief Generated client API
+ *
+ * Don't include this file directly - use @ref client.h instead.
+ */
 
 /** @brief Adopt a track
  *
@@ -539,6 +544,7 @@ int disorder_revoke(disorder_client *c);
  *
  * @param c Client
  * @param addressp Where to store hostname or address
+ * @param portp Where to store service name or port number
  * @return 0 on success, non-0 on error
  */
 int disorder_rtp_address(disorder_client *c, char **addressp, char **portp);
@@ -759,6 +765,7 @@ int disorder_set_volume(disorder_client *c, long left, long right);
  *
  * @param c Client
  * @param leftp Left channel volume
+ * @param rightp Right channel volume
  * @return 0 on success, non-0 on error
  */
 int disorder_get_volume(disorder_client *c, long *leftp, long *rightp);