From f0313692fc34299f25c909b4cecc86c8390d18ba Mon Sep 17 00:00:00 2001
From: Florian Forster <octo@collectd.org>
Date: Thu, 14 Dec 2023 21:48:09 +0100
Subject: [PATCH] src/daemon/metric.h: Improve doc comment for
 `metric_family_append`.

---
 src/daemon/metric.h | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/daemon/metric.h b/src/daemon/metric.h
index 8ea3b09cd..16289d345 100644
--- a/src/daemon/metric.h
+++ b/src/daemon/metric.h
@@ -170,6 +170,9 @@ int metric_family_resource_attribute_update(metric_family_t *fam,
  *   m.value = v;
  *   metric_label_set(&m, lname, lvalue);
  *   metric_family_metric_append(fam, m);
+ *
+ * templ may be NULL. In that case the function behaves as if &(metric_t){0} had
+ * been passed in.
  */
 int metric_family_append(metric_family_t *fam, char const *lname,
                          char const *lvalue, value_t v, metric_t const *templ);
-- 
2.47.2