View lcov test coverage results on http://www.gnu.org/software/liquidwar6/coverage/src/lib/hlp/index.html.
keyword: the keyword we want to check out
Checks wether a given keyword is documented or not.
Return value: 1 if documented, 0 if not.
type: the type of the data associated to the keyword, will be written
default_value: the default value for the keyword, will be written
min_value: the min value for the keyword, will be written
max_value: the max value for the keyword, will be written
keyword: the keyword we want help about
Returns the documentation string associated to a keyword. The keyword might be a command-line option, a Guile function, an XML file entry. Raises a warning if the keyword is undocumented, but never returns NULL, you can use the returned value without checking it. String is localized if a translation is available. It's safe to call this function with type or other parameters being NULL.
Return value: a help string, never NULL, must not be freed. Additionnally, type will be updated.
keyword: the keyword we want the type of
Returns the type of a keyword. Calls lw6hlp_about internally.
Return value: the type, might be LW6HLP_TYPE_VOID.
keyword: the keyword we want the default for
Returns the default value for a keyword. Note that it can be NULL! The returned value is always a string, it's suitable to store in the config file, it's the value a user would pass on a command line, the one he wants documented.
Return value: a pointer, which can be NULL, must not be freed.
keyword: the keyword we want the min for
Returns the min value for a keyword. Wether this is relevant for a given keyword does not affect the fact that you can call this function. A min and max of zero means min and max make no sense.
Return value: the value (integer)
keyword: the keyword we want the max for
Returns the max value for a keyword. Wether this is relevant for a given keyword does not affect the fact that you can call this function. A min and max of zero means min and max make no sense.
Return value: the value (integer)
id: the id of the credits line to return
Returns a "credit line", that is a short sentence, about 30 to 50 chars, saying who developped the game, created graphics, giving important URLs, and so on. One can pass an arbitraty high
id
, no risk.Return value: the string, must be freed.
keyword1: the 1st keyword
keyword2: the 2nd keyword
Checks wether a keyword matches another. Not only a string comparison, will also try and guess if the error is only about dash "-" replaced by underscode "_", for instance.
Return value: 1 if matches, 0 if different.
Returns the list of keywords concerning quick options.
Return value: list of static strings (can't modify them)
Returns the list of keywords concerning self-documentation system.
Return value: list of static strings (can't modify them)
Returns the list of keywords concerning the show options.
Return value: list of static strings (can't modify them)
Returns the list of keywords concerning the path options.
Return value: list of static strings (can't modify them)
Returns the list of keywords concerning the players options.
Return value: list of static strings (can't modify them)
Returns the list of keywords concerning the input options.
Return value: list of static strings (can't modify them)
Returns the list of keywords concerning the graphics options.
Return value: list of static strings (can't modify them)
Returns the list of keywords concerning the sound options.
Return value: list of static strings (can't modify them)
Returns the list of keywords concerning the network options.
Return value: list of static strings (can't modify them)
Returns the list of keywords concerning the map options.
Return value: list of static strings (can't modify them)
Returns the list of keywords concerning the rules options.
Return value: list of static strings (can't modify them)
Returns the list of keywords concerning the hints options.
Return value: list of static strings (can't modify them)
Returns the list of keywords concerning the style options.
Return value: list of static strings (can't modify them)
Returns the list of keywords concerning the teams options.
Return value: list of static strings (can't modify them)
Returns the list of C-function exported to Guile.
Return value: list of static strings (can't modify them)
Returns the list of hooks.
Return value: list of static strings (can't modify them)
Returns the list of keywords concerning advanced options.
Return value: list of static strings (can't modify them)
Returns the list of command-line aliases.
Return value: list of static strings (can't modify them)
Returns the list of team_colors.
Return value: list of static strings (can't modify them)
Returns the list of weapons.
Return value: list of static strings (can't modify them)
Returns the list of all available keywords.
Return value: list of static strings (can't modify them)
list: a pointer to a list of keywords
f: the file to print the content to
Prints all the keywords from the list. One keyword per line.
Return value: none.
list: a pointer to a list of keywords
f: the file to print the content to
Prints all the keywords from the list, with the associated keyword help, to the given file. Output is formatted to fit on the standard terminal/console.
Return value: none.
keyword: the keyword to print help about
f: the file to print the content to
Displays the help about a keyword, to a file, directly. It's formatted for the purpose of the –about=<value> option.
Return value: none
Initializes the help reference, this must be called before any call to lw6hlp_about or such help related functions.
Return value: 1 on success, 0 if failed