--- a/th_args.c	Fri Jan 17 03:47:19 2020 +0200
+++ b/th_args.c	Fri Jan 17 04:16:32 2020 +0200
@@ -5,8 +5,6 @@
  *
  * Please read file 'COPYING' for information on license and distribution.
  */
-/// @file
-/// @brief Simple commandline argument processing functions
 #include "th_util.h"
 #include "th_args.h"
 #include "th_string.h"
@@ -330,12 +328,15 @@
 
 
 /**
- * Print help for commandline arguments/options
+ * Print neatly formatted help for specified array of commandline options.
+ * The function will attempt to find the best indentation and formatting of
+ * the output using a simple fitting algorithm. Option descriptions will be
+ * automatically split over several lines if necessary.
  * @param fh stdio file handle to output to
  * @param[in] opts options list array
- * @param[in] nopts number of elements in options list array
- * @param[in] flags flags (currently unused)
- * @param[in] width width of the terminal or desired width of the print out
+ * @param[in] nopts number of elements in the options list array @p opts
+ * @param[in] flags (currently unused)
+ * @param[in] width width of the output terminal or the desired maximum width of the printout
  */
 void th_args_help(FILE *fh, const th_optarg *opts,
     const int nopts, const int flags, const int width)