output-flow: document the name field as for debugging only

Ticket: #7227

diff --git a/src/output-flow.c b/src/output-flow.c
index d73815295353ca028270a8dca3f52302bee25071..47c8b31f3071b2d7cd825742a93e01e67e07f2f3 100644 (file)
--- a/src/output-flow.c
+++ b/src/output-flow.c
@@ -42,7 +42,10 @@ typedef struct OutputFlowLogger_ {
     FlowLogger LogFunc;
     OutputCtx *output_ctx;
     struct OutputFlowLogger_ *next;
+
+    /** A name for this logger, used for debugging only. */
     const char *name;
+
     TmEcode (*ThreadInit)(ThreadVars *, const void *, void **);
     TmEcode (*ThreadDeinit)(ThreadVars *, void *);
     void (*ThreadExitPrintStats)(ThreadVars *, void *);
@@ -50,6 +53,14 @@ typedef struct OutputFlowLogger_ {
 
 static OutputFlowLogger *list = NULL;
 
+/**
+ * \brief Register a new low-level flow logger.
+ *
+ * \param name The name of this logger. Its only used for debugging,
+ *     so choose something unique.
+ *
+ * \retval 0 on success, -1 on failure.
+ */
 int OutputRegisterFlowLogger(const char *name, FlowLogger LogFunc,
     OutputCtx *output_ctx, ThreadInitFunc ThreadInit,
     ThreadDeinitFunc ThreadDeinit,