]> Kevux Git Server - fll/commitdiff
Cleanup: Function documentation comments, removing or fixing invalid comments.
authorKevin Day <kevin@kevux.org>
Wed, 21 Feb 2024 03:37:38 +0000 (21:37 -0600)
committerKevin Day <kevin@kevux.org>
Wed, 21 Feb 2024 03:54:54 +0000 (21:54 -0600)
The Doxygen wizard reported warnings that exposed these problems.

14 files changed:
level_0/f_capability/c/capability.h
level_0/f_console/c/console.h
level_0/f_environment/c/environment.h
level_0/f_fss/c/fss.h
level_0/f_iki/c/iki/data.h
level_0/f_print/c/print.h
level_0/f_string/c/string/static.h
level_0/f_thread/c/thread.h
level_1/fl_control_group/c/control_group.h
level_1/fl_print/c/print.h
level_1/fl_string/c/string.h
level_1/fl_utf_file/c/utf_file.h
level_2/fll_control_group/c/control_group.h
level_2/fll_print/c/print.h

index 2efaa1d4b5618ecf3d8fcaea481011a4f971902c..4c97d182056744c64908f42431c38cd29ed1c10d 100644 (file)
@@ -892,9 +892,6 @@ extern "C" {
 /**
  * Check if capabilities support ambient, using special libcap function/macro.
  *
- * @param code
- *   The capability code.
- *
  * @return
  *   TRUE if ambient is supported.
  *   FALSE otherwise.
index 04319b9be96bbb9c382d5bca6b6271df96c326b3..c6c2681463d3f23026c05e54f77416596167b081 100644 (file)
@@ -33,8 +33,8 @@ extern "C" {
  *
  * All values are appended to the environment maps.
  *
- * @param parameters
- *   The parameters to process.
+ * @param arguments
+ *   The arguments to process.
  * @param environment
  *   Maps representing the environment variable names and values.
  *   Both the name and the value strings may not be NULL terminated.
index e00fcf10142868da102cec79b7b34c0eeb8ab8f5..edc9ca859cdc697d2d29cb875fc6268a2418b5db 100644 (file)
@@ -52,13 +52,9 @@ extern "C" {
  * The variable is copied into a new dynamically allocated string and is safe to alter.
  *
  * @param name
- *   The name of the environment variable to get.
+ *   The name of the environment variable to check the existence of.
  *   The name string must not contain the '=' character.
  *   The name must be NULL terminated.
- * @param value
- *   The value associated with name.
- *   The value will not be null terminated.
- *   The value will be appended (set value->used to 0 to replace).
  *
  * @return
  *   F_data_not if name.used is 0.
index 2ab5339c4ae9d3d2017a159711064829e7758124..2ec2e3275cd7fdadefb47cdbddebc0ab8f886cd1 100644 (file)
@@ -198,8 +198,6 @@ extern "C" {
  *   The string to process.
  * @param range
  *   The character at the start position will be checked against the graph.
- * @param header
- *   The header data to populate with results of this function.
  *
  * @return
  *   F_true if the character in the buffer is a combining character.
@@ -224,8 +222,6 @@ extern "C" {
  *   The string to process.
  * @param range
  *   The character at the start position will be checked against the graph.
- * @param header
- *   The header data to populate with results of this function.
  *
  * @return
  *   F_true if the character in the buffer is a graph character.
@@ -250,8 +246,6 @@ extern "C" {
  *   The string to process.
  * @param range
  *   The character at the start position will be checked against the graph.
- * @param header
- *   The header data to populate with results of this function.
  *
  * @return
  *   F_true if the character in the buffer is a space character.
@@ -282,8 +276,6 @@ extern "C" {
  *   The string to process.
  * @param range
  *   The character at the start position will be checked against the graph.
- * @param header
- *   The header data to populate with results of this function.
  *
  * @return
  *   F_true if the character in the buffer is a zero-width character.
index 4c1b00442271d1e3c41617d68810746c3006fa6c..a74e50d457f5e8163767022373f3c2a3bf1f4fe9 100644 (file)
@@ -63,8 +63,8 @@ extern "C" {
  *
  * @param length
  *   The new size to use.
- * @param iki_datas
- *   The iki_datas array to resize.
+ * @param datas
+ *   The array to resize.
  *
  * @return
  *   F_none on success.
@@ -126,8 +126,8 @@ extern "C" {
  *
  * @param amount
  *   A positive number representing how much to decimate the size by.
- * @param iki_datas
- *   The iki_datas array to resize.
+ * @param datas
+ *   The array to resize.
  *
  * @return
  *   F_none on success.
@@ -150,8 +150,8 @@ extern "C" {
  *
  * @param amount
  *   A positive number representing how much to decrease the size by.
- * @param iki_datas
- *   The iki_datas array to resize.
+ * @param datas
+ *   The array to resize.
  *
  * @return
  *   F_none on success.
@@ -174,8 +174,8 @@ extern "C" {
  * @param step
  *   The allocation step to use.
  *   Must be greater than 0.
- * @param iki_datas
- *   The iki_datas array to resize.
+ * @param datas
+ *   The array to resize.
  *
  * @return
  *   F_none on success.
@@ -199,8 +199,8 @@ extern "C" {
  *
  * @param amount
  *   A positive number representing how much to increase the size by.
- * @param iki_datas
- *   The iki_datas array to resize.
+ * @param datas
+ *   The array to resize.
  *
  * @return
  *   F_none on success.
@@ -220,8 +220,8 @@ extern "C" {
  *
  * @param length
  *   The new size to use.
- * @param iki_datas
- *   The iki_datas array to adjust.
+ * @param datas
+ *   The array to adjust.
  *
  * @return
  *   F_none on success.
@@ -239,8 +239,8 @@ extern "C" {
  *
  * @param length
  *   The new size to use.
- * @param iki_datass
- *   The iki_datass array to resize.
+ * @param datass
+ *   The array to resize.
  *
  * @return
  *   F_none on success.
@@ -303,8 +303,8 @@ extern "C" {
  *
  * @param amount
  *   A positive number representing how much to decimate the size by.
- * @param iki_datass
- *   The iki_datass array to resize.
+ * @param datass
+ *   The array to resize.
  *
  * @return
  *   F_none on success.
@@ -328,8 +328,8 @@ extern "C" {
  *
  * @param amount
  *   A positive number representing how much to decrease the size by.
- * @param iki_datass
- *   The iki_datass array to resize.
+ * @param datass
+ *   The array to resize.
  *
  * @return
  *   F_none on success.
@@ -353,8 +353,8 @@ extern "C" {
  * @param step
  *   The allocation step to use.
  *   Must be greater than 0.
- * @param iki_datass
- *   The iki_datass array to resize.
+ * @param datass
+ *   The array to resize.
  *
  * @return
  *   F_none on success.
@@ -378,8 +378,8 @@ extern "C" {
  *
  * @param amount
  *   A positive number representing how much to increase the size by.
- * @param iki_datass
- *   The iki_datass array to resize.
+ * @param datass
+ *   The array to resize.
  *
  * @return
  *   F_none on success.
@@ -399,8 +399,8 @@ extern "C" {
  *
  * @param length
  *   The new size to use.
- * @param iki_datass
- *   The iki_datass array to adjust.
+ * @param datass
+ *   The array to adjust.
  *
  * @return
  *   F_none on success.
index 5a4bbcaba3742c6ab0f951890fe0dd074e263ac5..ade3bf6b842160c42ae88495d20a52f61c07b52a 100644 (file)
@@ -1576,8 +1576,6 @@ extern "C" {
  *
  * @param string
  *   The string to output.
- * @param length
- *   The total number of characters to print.
  * @param stream
  *   The file stream to output to, including standard streams such as stdout and stderr.
  *
index 68d5c0c1b9328171f23c58ccde5fa7e9e3ea27b3..31a90c2b40addca3e3e9d7896e9a2117a25b19d3 100644 (file)
@@ -545,7 +545,7 @@ extern "C" {
 
 /**
  * Define the end of line character.
- * FLL forbids '\r' and '\r\n' as end of line characters, \r will be silently ignored.
+ * FLL forbids '\r' and '\r\n' as end of line characters, '\r' will be silently ignored.
  */
 #ifndef _di_f_string_eol_s_
   #define f_string_eol_s f_string_ascii_feed_line_s
index 88e539d10ceb01bbed39f906a499c003bc7fb7af..03f7f84984b1e7267db9f2ea9eaa6d8df957d374 100644 (file)
@@ -58,7 +58,7 @@ extern "C" {
  *   The function to call before forking.
  * @param after_parent
  *   The function called after forking, for the parent process.
- * @param child_parent
+ * @param after_child
  *   The function called after forking, for the child process.
  *
  * @return
@@ -2101,6 +2101,8 @@ extern "C" {
  *
  * Subsequent calls will not call the given routine.
  *
+ * @param routine
+ *   The callback.
  * @param once
  *   The once variable designating that the given routine will be called only once.
  *
index 2b343b2871ef0ee89e29f71a3b1194b1a24fe1a4..e541a8ccec941b7b7c9fd1c5cdd874673beaa2b1 100644 (file)
@@ -41,7 +41,7 @@ extern "C" {
 /**
  * Apply the given control groups to the process represented by the PID.
  *
- * @param control
+ * @param control_group
  *   The control group(s) to apply.
  * @param id
  *   The PID of the process to apply the control group(s) to.
index b3c519a4feb8e520cfe294dcc4fc320dcb8601ea..8fa7284e60a94eebd13f88376de75b3282a8d9d3 100644 (file)
@@ -1443,8 +1443,6 @@ extern "C" {
  *
  * @param buffer
  *   The string to output.
- * @param offset
- *   The inclusive start point to start printing.
  * @param except_at
  *   An array of locations within the given string to not print.
  *   The array of locations is required/assumed to be in linear order.
index f1e0f59692a651a489e050636c22dd842bb4c48d..ed2a882340b4bf524ee6c0cac4d9e9f47bc2eacb 100644 (file)
@@ -713,6 +713,8 @@ extern "C" {
  *   String to compare.
  * @param string2
  *   String to compare.
+ * @param range1
+ *   A range within the string1 to restrict the comparison to.
  * @param range2
  *   A range within the string2 to restrict the comparison to.
  *
index 7ab342abf341bc68485620c847146ad6dd80a286..60e0cd4aa5d5a7b146236a42e8acd8b9b479995e 100644 (file)
@@ -237,8 +237,8 @@ extern "C" {
  * @param file
  *   The file to write to.
  *   The file must already be open.
- * @param destination
- *   The destination to write to the file.
+ * @param buffer
+ *   The string to write to the file.
  * @param range
  *   An inclusive start an stop range within the destination to read.
  * @param written
index b72f1e6edcccfc66b6ba90e7aa0249d1fd3ffd62..760566efbd9c8cf111d22b3e8dca527a5980e4c3 100644 (file)
@@ -36,7 +36,7 @@ extern "C" {
  *
  * This does not, however, create the control_group.path and will error out if that directory does not exist.
  *
- * @param control
+ * @param control_group
  *   The control group(s) to ensure the directories exist.
  *
  * @return
index 78199e19c60c921d85a8b16630938d866bc5404d..f08313228642722cdd20226ca6c19c46d5477505 100644 (file)
@@ -1115,8 +1115,6 @@ extern "C" {
  *
  * @param string
  *   The string to output.
- * @param length
- *   The total number of characters to print.
  * @param output
  *   The file stream to output to, including standard streams such as stdout and stderr.
  *