We will use the expression
<group> to represent
[FIXME: I have just taken the comments for C routine scm_options that implements all of these. It needs to be presented better.]
If scm_options is called without arguments, the current option setting is returned. If the argument is an option setting, options are altered and the old setting is returned. If the argument isn't a list, a list of sublists is returned, where each sublist contains option name, value and documentation string.
These functions list the options in their group. The optional argument arg is a symbol which modifies the form in which the options are presented.
With no arguments,
<group>-optionsreturns the values of the options in that particular group. If arg is
'help, a description of each option is given. If arg is
'full, programmers' options are also shown.
arg can also be a list representing the state of all options. In this case, the list contains single symbols (for enabled boolean options) and symbols followed by values.
These functions set the specified option-symbol in their options group. They only work if the option is boolean, and throw an error otherwise.
These functions turn off the specified option-symbol in their options group. They only work if the option is boolean, and throw an error otherwise.