7.4.16 SET_OPT_name - Force an option to be set

This macro gets emitted only when the given option has the settable attribute specified.

The form of the macro will actually depend on whether the option is equivalenced to another, has an option argument and/or has an assigned handler procedure. If the option has an argument, then this macro will too. Beware that the argument is not reallocated, so the value must not be on the stack or deallocated in any other way for as long as the value might get referenced.

If you have supplied at least one `homerc' file (see section 7.3.1 Program Description Attributes), this macro will be emitted for the --save-opts option.

SET_OPT_SAVE_OPTS( "filename" );

See section 7.3.6 Automatically Supported Options, for a discussion of the implications of using this particular example.