lib/kafka, rlm_kafka: drop trailing periods from Doxygen block titles

House style: the brief / title line of a /** */ block is a heading,
not a sentence, so no trailing period.  Body prose sentences after the
title keep their periods as normal.

Author: arr2036

src/lib/kafka/base.c

@@ -36,7 +36,7 @@
  * @{
  */
 
-/** Common parse path for a single CONF_PAIR's value.
+/** Common parse path for a single CONF_PAIR's value
  *
  * Handles librdkafka's preferred unit conventions (ms-integer for time
  * deltas, byte-integer for sizes, string "true"/"false" for bools) and
@@ -237,7 +237,7 @@ static int kafka_noop_parse(UNUSED TALLOC_CTX *ctx, UNUSED void *out, UNUSED voi
  * @{
  */
 
-/** Destructor on the talloc sentinel that owns the rd_kafka_conf_t handle.
+/** Destructor on the talloc sentinel that owns the rd_kafka_conf_t handle
  *
  * The sentinel is just a talloced `rd_kafka_conf_t *` attached to the
  * caller's parse ctx - when talloc unwinds the instance, this fires and
@@ -249,7 +249,7 @@ static int _kafka_conf_free(rd_kafka_conf_t **pconf)
 	return 0;
 }
 
-/** Fetch the `fr_kafka_conf_t` currently being populated by the parser.
+/** Fetch the `fr_kafka_conf_t` currently being populated by the parser
  *
  * The parser contract is that `base` points at the caller's instance
  * struct and `fr_kafka_conf_t` is its first member, so a reinterpret
@@ -441,7 +441,7 @@ int kafka_config_dflt(CONF_PAIR **out, void *parent, CONF_SECTION *cs, fr_token_
 	return 0;
 }
 
-/** Untyped passthrough: hand a CONF_PAIR's attr/value straight to rd_kafka_conf_set.
+/** Untyped passthrough: hand a CONF_PAIR's attr/value straight to rd_kafka_conf_set
  *
  * Used by the `CF_IDENT_ANY` entry in the base `properties { }` subsection
  * to accept arbitrary librdkafka properties that don't have a typed entry
@@ -485,7 +485,7 @@ static int _kafka_topic_conf_free(fr_kafka_topic_conf_t *ktc)
 	return 0;
 }
 
-/** Allocate a per-topic conf parented under `ctx`.
+/** Allocate a per-topic conf parented under `ctx`
  *
  * Used by the subsection hook to build each declared topic's
  * `fr_kafka_topic_conf_t`.  The destructor releases the librdkafka
@@ -589,7 +589,7 @@ static int kafka_topic_config_dflt(CONF_PAIR **out, void *parent, CONF_SECTION *
 	return 0;
 }
 
-/** Topic-level counterpart to `kafka_config_raw_parse`.
+/** Topic-level counterpart to `kafka_config_raw_parse`
  *
  * Used inside a declared topic's `properties { }` subsection to accept
  * arbitrary `rd_kafka_topic_conf_set` properties.  `base` is the enclosing
@@ -698,7 +698,7 @@ int kafka_topic_subsection_parse(TALLOC_CTX *ctx, void *out, void *base,
  * @{
  */
 
-/** `properties { ... }` escape-hatch contents.
+/** `properties { ... }` escape-hatch contents
  *
  * Accepts any `key = value` pair and hands it straight to
  * `rd_kafka_conf_set`.  See `kafka_config_raw_parse`.
@@ -708,7 +708,7 @@ conf_parser_t const kafka_base_properties_config[] = {
 	CONF_PARSER_TERMINATOR
 };
 
-/** Per-topic `properties { ... }` escape-hatch contents.
+/** Per-topic `properties { ... }` escape-hatch contents
  *
  * Same idea as `kafka_base_properties_config`, but dispatches to
  * `rd_kafka_topic_conf_set` against the enclosing topic's conf.

src/lib/kafka/base.h

@@ -57,7 +57,7 @@ typedef struct {
 	rd_kafka_topic_conf_t	*rdtc;
 } fr_kafka_topic_conf_t;
 
-/** Declared topic record - one per `topic { <name> { ... } }` subsection.
+/** Declared topic record - one per `topic { <name> { ... } }` subsection
  *
  * Built by the library's per-topic parse hook, indexed on the parent
  * `fr_kafka_conf_t.topics` tree.  Callers typically retrieve via
@@ -71,7 +71,7 @@ struct fr_kafka_topic_s {
 	fr_rb_node_t		node;
 };
 
-/** uctx attached to each entry in `KAFKA_BASE_PRODUCER_CONFIG`.
+/** uctx attached to each entry in `KAFKA_BASE_PRODUCER_CONFIG`
  *
  * Public so the config macro's struct literals resolve in caller TUs.
  * You only touch this directly if you're extending the library's
@@ -87,7 +87,7 @@ typedef struct {
 						//!< Kafka uses ', ' or ';' seemingly at random.
 } fr_kafka_conf_ctx_t;
 
-/** Generic librdkafka-property parser used by `KAFKA_BASE_PRODUCER_CONFIG` entries.
+/** Generic librdkafka-property parser used by `KAFKA_BASE_PRODUCER_CONFIG` entries
  *
  * Exposed so the macro's FR_CONF_PAIR_GLOBAL entries can reference it from any TU.
  */
@@ -98,7 +98,7 @@ int kafka_config_parse(TALLOC_CTX *ctx, void *out, void *base, CONF_ITEM *ci, co
  */
 int kafka_config_dflt(CONF_PAIR **out, void *parent, CONF_SECTION *cs, fr_token_t quote, conf_parser_t const *rule);
 
-/** Untyped passthrough parser used by `KAFKA_RAW_CONFIG`.
+/** Untyped passthrough parser used by `KAFKA_RAW_CONFIG`
  *
  * Hands the CONF_PAIR's attribute/value straight to `rd_kafka_conf_set`.
  * No type dispatch - user is responsible for librdkafka-native units.
@@ -111,22 +111,22 @@ int kafka_config_raw_parse(TALLOC_CTX *ctx, void *out, void *base, CONF_ITEM *ci
  */
 int kafka_topic_config_raw_parse(TALLOC_CTX *ctx, void *out, void *base, CONF_ITEM *ci, conf_parser_t const *rule);
 
-/** Per-topic subsection hook used by KAFKA_PRODUCER_CONFIG / KAFKA_CONSUMER_CONFIG.
+/** Per-topic subsection hook used by KAFKA_PRODUCER_CONFIG / KAFKA_CONSUMER_CONFIG
  *
  * Runs the inner rules against each `topic { <name> { ... } }` block
  * then inserts an `fr_kafka_topic_t` into the parent `fr_kafka_conf_t.topics`
  * tree so callers can look topics up by name without re-walking CONF_SECTIONs.
  */
 int kafka_topic_subsection_parse(TALLOC_CTX *ctx, void *out, void *base, CONF_ITEM *ci, conf_parser_t const *rule);
 
-/** Look up a declared topic by name on an `fr_kafka_conf_t`.
+/** Look up a declared topic by name on an `fr_kafka_conf_t`
  *
  * @return the `fr_kafka_topic_t`, or NULL if no topic of that name was
  *         declared (or if no topics have been parsed yet).
  */
 fr_kafka_topic_t	*kafka_topic_find(fr_kafka_conf_t const *kc, char const *name);
 
-/** @name Nested config arrays referenced by `KAFKA_BASE_PRODUCER_CONFIG`.
+/** @name Nested config arrays referenced by `KAFKA_BASE_PRODUCER_CONFIG`
  *
  * Extern so the macro's FR_CONF_SUBSECTION_GLOBAL entries can name them
  * from any TU.  Not part of the stable API - treat as implementation
@@ -145,7 +145,7 @@ extern conf_parser_t const kafka_base_properties_config[];
 extern conf_parser_t const kafka_base_topic_properties_config[];
 /** @} */
 
-/** Config entries common to producer and consumer clients.
+/** Config entries common to producer and consumer clients
  *
  * Broker list, client identity, TLS / SASL, metadata / version /
  * connection tuning, debug / plugin knobs.  Usually composed with a
@@ -190,7 +190,7 @@ extern conf_parser_t const kafka_base_topic_properties_config[];
 	 * the user writes librdkafka-native units (e.g. "500" for ms). */ \
 	{ FR_CONF_SUBSECTION_GLOBAL("properties", 0, kafka_base_properties_config) }
 
-/** Producer-only delta: librdkafka producer tuning + declared topics.
+/** Producer-only delta: librdkafka producer tuning + declared topics
  *
  * Compose with @ref KAFKA_BASE_CONFIG.  Callers must embed
  * `fr_kafka_conf_t` as the first member of their instance struct so