Better documentation

Author: emasab

src/rdhttp.c

@@ -276,6 +276,8 @@ static void rd_http_ssl_configure(rd_kafka_t *rk, CURL *hreq_curl) {
  *          otherwise return rd_false.
  *
  * @locality Any thread.
+ * @locks None.
+ * @locks_acquired None.
  */
 static rd_bool_t rd_http_is_failure_temporary(int error_code) {
         switch (error_code) {

src/rdkafka_conf.c

@@ -1213,7 +1213,7 @@ static const struct rd_kafka_property rd_kafka_properties[] = {
         "sasl.oauthbearer.metadata.authentication.type",
         _RK_C_S2I,
         _RK(sasl.oauthbearer.metadata_authentication.type),
-        "Type of metadata based authentication to use for OAUTHBEARER/OIDC "
+        "Type of metadata-based authentication to use for OAUTHBEARER/OIDC "
         "`azure_imds` authenticates using the Azure IMDS endpoint. "
         "Sets a default value for `sasl.oauthbearer.token.endpoint.url` if "
         "missing. "

tests/0126-oauthbearer_oidc.c

@@ -467,6 +467,7 @@ static rd_kafka_conf_t *oidc_configuration_metadata_authentication(
         return conf;
 }
 
+/* Test metadata-based authentication cases against Trivup. */
 void do_test_produce_consumer_with_OIDC_metadata_authentication(
     rd_kafka_conf_t *conf) {
         rd_kafka_conf_t *metadata_authentication_conf;