optionSaveFile - saves the option state to a file

       This  routine will save the state of option processing to a file.  The name of that file can be specified
       with the argument to the --save-opts option, or by appending the rcfile  attribute  to  the  last  homerc
       attribute.   If  no  rcfile  attribute  was specified, it will default to .programnamerc.Ifyouwishtospecifyanotherfile,youshouldinvoketheSET_OPT_SAVE_OPTS(filename)macro.Therecommendusageisasfollows:optionProcess(&progOptions,argc,argv);if(i_want_a_non_standard_place_for_this)SET_OPT_SAVE_OPTS("myfilename");optionSaveFile(&progOptions);opts   program options descriptor

       If no homerc file was specified, this routine will silently return and do nothing.  If  the  output  file
       cannot be created or updated, a message will be printed to stderr and the routine will return.

       optionSaveFile - saves the option state to a file

       The info documentation for the -lopts library.
       ao_string_tokenize(3),  configFileLoad(3), optionFileLoad(3), optionFindNextValue(3), optionFindValue(3),
       optionFree(3),    optionGetValue(3),    optionLoadLine(3),    optionMemberList(3),    optionNextValue(3),
       optionOnlyUsage(3),      optionPrintVersion(3),     optionPrintVersionAndReturn(3),     optionProcess(3),
       optionRestore(3),    optionSaveState(3),    optionUnloadNested(3),    optionVersion(3),     strequate(3),
       streqvcmp(3), streqvmap(3), strneqvcmp(3), strtransform(3),

                                                   2018-08-26                                  optionSaveFile(3)

       #include <your-opts.h>
       cc [...] -o outfile infile.c -lopts [...]

       void optionSaveFile(tOptions * opts);