copysym: Merge tables into a single static allocation.

[dxcommon.git] / src / help.h

diff --git a/src/help.h b/src/help.h
index 9eb26540a19d4139d91a8024a71367e3db391f5c..7dbb65de4efb7998bd0ea2b9b357aab3c8738b4c 100644 (file)
--- a/src/help.h
+++ b/src/help.h
@@ -1,5 +1,5 @@
 /*
- * Copyright © 2021 Nick Bowler
+ * Copyright © 2021, 2023 Nick Bowler
  *
  * Helper functions for formatting --help program output.
  *
@@ -23,10 +23,14 @@ struct option;
 int help_print_optstring(const struct option *opt, const char *argname, int l);
 
 /*
- * Print an option description with each line indented.  The string is first
- * localized (if NLS is enabled).  The first line will be indented by i-w
- * spaces (to account for the cursor being in some other column), all other
- * lines are indented by i spaces.
+ * Print an option description with each line indented.  If opt is not NULL,
+ * then the string is first localized (if NLS is enabled) via pgettext_expr
+ * with the context set to opt->name.  The first line will be indented by
+ * i-w spaces (to account for the cursor being in some other column), all
+ * other lines are indented by i spaces.
+ *
+ * The output always ends with a newline, regardless of whether or not the
+ * input string ends with a newline.
  */
 void help_print_desc(const struct option *opt, const char *desc, int i, int w);