The Doxygen wizard reported warnings that exposed these problems.
/**
* Check if capabilities support ambient, using special libcap function/macro.
*
- * @param code
- * The capability code.
- *
* @return
* TRUE if ambient is supported.
* FALSE otherwise.
*
* 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.
* 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.
* 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.
* 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.
* 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.
* 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.
*
* @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.
*
* @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.
*
* @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.
* @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.
*
* @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.
*
* @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.
*
* @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.
*
* @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.
*
* @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.
* @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.
*
* @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.
*
* @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.
*
* @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.
*
/**
* 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
* 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
*
* 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.
*
/**
* 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.
*
* @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.
* 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.
*
* @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
*
* 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
*
* @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.
*