General option interface

We will use the expression <group> to represent read, print, debug or evaluator.

Low level

primitive: <group>-options-interface

primitive: read-options-interface [SOME-INT]

primitive: print-options-interface [SOME-INT]

primitive: evaluator-traps-interface [SOME-INT]

primitive: read-options-interface [SOME-INT]

[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.

User level

procedure: <group>-options [arg]

procedure: read-options [arg]

procedure: print-options [arg]

procedure: debug-options [arg]

procedure: traps [arg]

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>-options returns 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.

procedure: <group>-enable option-symbol

procedure: read-enable option-symbol

procedure: print-enable option-symbol

procedure: debug-enable option-symbol

procedure: trap-enable option-symbol

These functions set the specified option-symbol in their options group. They only work if the option is boolean, and throw an error otherwise.

procedure: <group>-disable option-symbol

procedure: read-disable option-symbol

procedure: print-disable option-symbol

procedure: debug-disable option-symbol

procedure: trap-disable option-symbol

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.

syntax: <group>-set! option-symbol value

syntax: read-set! option-symbol value

syntax: print-set! option-symbol value

syntax: debug-set! option-symbol value

syntax: trap-set! option-symbol value

These functions set a non-boolean option-symbol to the specified value.

Go to the first, previous, next, last section, table of contents.