C-Menu Initialization

Capture Data from the Environment, Command Line, and Configuration File and Populate the Init and SIO Data Structures. More...

Functions
bool	derive_file_spec (char *file_spec, char *dir, char *file_name)
	Derive full file specification from directory and file name.
void	display_version ()
	Display the version information of the application.
void	mapp_initialization (Init *init, int argc, char **argv)
	Main initialization function for MAPP - Menu Application.
void	opt_prt_bool (const char *o, const char *name, bool value)
	Print an option and its value in a formatted manner for boolean values.
void	opt_prt_char (const char *o, const char *name, const char *value)
	Print an option and its value in a formatted manner.
void	opt_prt_double (const char *o, const char *name, double value)
	Print an option and its value in a formatted manner for double values.
void	opt_prt_int (const char *o, const char *name, int value)
	Print an option and its value in a formatted manner for integer values.
void	opt_prt_str (const char *o, const char *name, const char *value)
	Print an option and its value in a formatted manner for integer values.
int	parse_opt_args (Init *init, int argc, char **argv)
	Parse command-line options and set Init struct values accordingly.
int	process_config_files (Init *init)
	parse the configuration file specified in init->minitrc and set Init struct values accordingly
int	write_config (Init *init)
	Write the current configuration to a file specified in init->minitrc.
void	zero_opt_args (Init *init)
	Initialize optional arguments in the Init struct to default values.

Detailed Description

Capture Data from the Environment, Command Line, and Configuration File and Populate the Init and SIO Data Structures.

    SIO   Struct for screen I/O settings (colors, gamma, etc.)
    Init  Struct for application settings (file paths, commands, flags, etc.)

Function Documentation

derive_file_spec()

bool derive_file_spec	(	char *	file_spec,
		char *	dir,
		char *	file_name )

Derive full file specification from directory and file name.

Parameters

file_spec	- output full file specification
dir	- directory path
file_name	- file name

Returns

true if file_spec is derived, false otherwise

If dir is nullptr, use MAPP_DIR environment variable or default directory, ~/menuapp. file_spec should be a pre-allocated char array of size MAXLEN to hold the resulting file specification

Definition at line 1436 of file init.c.

                                                                   {
    char tmp_str[MAXLEN];
    char ts2[MAXLEN];
    char *e;
 
    if (!file_name || !*file_name) {
        *file_spec = '\0';
        return false;
    }
    if (dir) {
        strnz__cpy(tmp_str, dir, MAXLEN - 1);
    } else {
        e = getenv("MAPP_DIR");
        if (e) {
            strnz__cpy(tmp_str, e, MAXLEN - 1);
        } else {
            strnz__cpy(tmp_str, "~/menuapp", MAXLEN - 1);
        }
    }
    trim_path(tmp_str);
    strnz__cpy(ts2, tmp_str, MAXLEN - 1);
    // construct the full file specification
    // check that the file exists and is readable
    strnz__cpy(file_spec, ts2, MAXLEN - 1);
    strnz__cat(file_spec, "/", MAXLEN - 1);
    strnz__cat(file_spec, file_name, MAXLEN - 1);
    return true;
}

References strnz__cat(), strnz__cpy(), and trim_path().

Here is the call graph for this function:

display_version()

void display_version

(

)

Display the version information of the application.

The version information is defined in the mapp_version variable and is printed to stdout when this function is called.

Definition at line 1468 of file init.c.

                       {
    fprintf(stdout, "\nC-Menu %s\n", CM_VERSION);
    fprintf(stdout, "\nC-Menu %s\n", CM_VERSION);
    fprintf(stdout, "C version: %ld\n", __STDC_VERSION__);
}

mapp_initialization()

void mapp_initialization	(	Init *	init,
		int	argc,
		char **	argv )

Main initialization function for MAPP - Menu Application.

Parameters

init	- pointer to Init struct to be initialized
argc	- argument count from main()
argv	- argument vector from main() 1. Read environment variables and set defaults 2. Parse configuration file 3. Parse command-line options 4. Set up SIO struct with colors and other settings 5. Handle special options like help and version

< menu specification file

< default border style

< erase remainder on enter

< field enclosure brackets

< field fill character

Definition at line 498 of file init.c.

                                                            {
    char term[MAXLEN];
    char tmp_str[MAXLEN];
    char *e;
    setlocale(LC_ALL, "en_US.UTF-8");
 
    init->sio = (SIO *)calloc(1, sizeof(SIO));
    if (!init->sio) {
        ui_perror(_("calloc init->sio failed"));
        exit(EXIT_FAILURE);
    }
    SIO *sio = init->sio;
    if (!init) {
        ssnprintf(tmp_str, sizeof(tmp_str), "%s",
                  _("init struct not allocated on entry"));
        ui_abend(-1, tmp_str);
        exit(-1);
    }
    e = getenv("CMENU_HOME");
    if (!e || *e == '\0')
        strnz__cpy(init->mapp_home, "~/menuapp", MAXLEN);
    else
        strnz__cpy(init->mapp_home, e, MAXLEN);
 
    if (init->mapp_home[0] != '\0') {
        expand_tilde(init->mapp_home, MAXLEN - 1);
        if (!verify_dir(init->mapp_home, R_OK))
            ui_abend(-1, _("MAPP_HOME directory invalid"));
    }
    // CMENU_RC should be an absolute path
    e = getenv("CMENU_RC");
    if (!e || *e == '\0') {
        strnz__cpy(init->minitrc, init->mapp_home, MAXLEN - 1);
        strnz__cat(init->minitrc, "/.minitrc", MAXLEN);
    } else
        strnz__cpy(init->minitrc, e, MAXLEN);
    if (init->mapp_user[0] == '\0') {
        strnz__cpy(init->mapp_user, init->mapp_home, MAXLEN - 1);
        strnz__cat(init->mapp_user, "/user", MAXLEN - 1);
    }
    if (init->mapp_theme[0] == '\0') {
        strnz__cpy(init->mapp_theme, init->mapp_home, MAXLEN - 1);
        strnz__cat(init->mapp_theme, "/themes/default", MAXLEN - 1);
    }
    if (init->mapp_msrc[0] == '\0') {
        strnz__cpy(init->mapp_msrc, init->mapp_home, MAXLEN - 1);
        strnz__cat(init->mapp_msrc, "/msrc", MAXLEN - 1);
    }
    if (init->mapp_data[0] == '\0') {
        strnz__cpy(init->mapp_data, init->mapp_home, MAXLEN - 1);
        strnz__cat(init->mapp_data, "/data", MAXLEN - 1);
    }
    if (init->mapp_help[0] == '\0') {
        strnz__cpy(init->mapp_help, init->mapp_home, MAXLEN - 1);
        strnz__cat(init->mapp_help, "/help", MAXLEN - 1);
    }
    init->mapp_spec[0] = '\0'; 
    // Set default colors and settings in SIO struct
    // These can be overridden by the config file or command-line options
    // Included here to ensure SIO has valid defaults even if config parsing fails
 
    sio->border = 'r'; 
    sio->bg = 0x000000;
    sio->fg = 0xc0c0c0;
    sio->border = 'r';
    sio->box_fg = 0xf00000;
    sio->box_bg = 0x000000;
    sio->ind_fg = 0xf00000;
    sio->ind_bg = 0x000000;
    sio->ran_fg = 0xf00000;
    sio->ran_bg = 0x000000;
    sio->title_fg = 0xf0f0f0;
    sio->title_bg = 0x000000;
    sio->nt_fg = 0xc0c0c0;
    sio->nt_bg = 0x000000;
    sio->nt_rev_fg = 0x000000;
    sio->nt_rev_bg = 0xc0c0c0;
    sio->nt_hl_fg = 0xf00000;
    sio->nt_hl_bg = 0x000000;
    sio->nt_hl_rev_fg = 0x000000;
    sio->nt_hl_rev_bg = 0xc0c0c0;
    sio->ln_fg = 0x0070ff;
    sio->ln_bg = 0x101010;
    sio->cmdln_fg = 0xd0d0d0;
    sio->cmdln_bg = 0x000000;
    init->f_erase_remainder = true;               
    init->brackets[0] = '\0';                     
    strnz__cpy(init->fill_char, " ", MAXLEN - 1); 
    e = getenv("TERM");
    if (e == nullptr || *e == '\0')
        strnz__cpy(term, "xterm-256color", MAXLEN);
    else
        strnz__cpy(term, e, MAXLEN - 1);
    e = getenv("EDITOR");
    if (e && *e != '\0')
        strnz__cpy(init->editor, "vi", MAXLEN - 1);
    else
        strnz__cpy(init->editor, e, MAXLEN - 1);
    process_config_files(init);
    ui_min_log_level = init->min_log_level;
    ui_log_fp = ui_open_log();
    ui_log(INFO, "mapp_initialization");
    ui_log(INFO, _("config files processed"));
    init->mapp_spec[0] = '\0';
    init->argc = argc;
    argp_parse(&argp, argc, argv, 0, 0, init);
    strnz__cpy(sio->fill_char, init->fill_char, 1);
    strnz__cpy(sio->brackets, init->brackets, 2);
    if (f_write_config) {
        write_config(init);
        exit(EXIT_SUCCESS);
    }
}

References Init::argc, SIO::bg, SIO::border, SIO::box_bg, SIO::box_fg, Init::brackets, SIO::brackets, SIO::cmdln_bg, SIO::cmdln_fg, Init::editor, expand_tilde(), Init::f_erase_remainder, f_write_config, SIO::fg, Init::fill_char, SIO::fill_char, SIO::ind_bg, SIO::ind_fg, SIO::ln_bg, SIO::ln_fg, Init::mapp_data, Init::mapp_help, Init::mapp_home, Init::mapp_msrc, Init::mapp_spec, Init::mapp_theme, Init::mapp_user, Init::min_log_level, Init::minitrc, SIO::nt_bg, SIO::nt_fg, SIO::nt_hl_bg, SIO::nt_hl_fg, SIO::nt_hl_rev_bg, SIO::nt_hl_rev_fg, SIO::nt_rev_bg, SIO::nt_rev_fg, process_config_files(), SIO::ran_bg, SIO::ran_fg, Init::sio, ssnprintf(), strnz__cat(), strnz__cpy(), SIO::title_bg, SIO::title_fg, ui_abend(), ui_log_fp, ui_min_log_level, ui_open_log(), ui_perror(), verify_dir(), and write_config().

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

opt_prt_bool()

void opt_prt_bool	(	const char *	o,
		const char *	name,
		bool	value )

Print an option and its value in a formatted manner for boolean values.

Parameters

o	- option flag (e.g., "-z")
name	- option name (e.g., "f_squeeze")
value	- boolean option value to print

This function is used to display the current configuration options and their boolean values in a readable format, printing "true" or "false" based on the value.

Definition at line 1525 of file init.c.

                                                               {
    fprintf(stdout, "%3s %-15s: %s\n", o, name, value ? "true" : "false");
}

opt_prt_char()

void opt_prt_char	(	const char *	o,
		const char *	name,
		const char *	value )

Print an option and its value in a formatted manner.

Parameters

o	- option flag (e.g., "-a:")
name	- option name (e.g., "--minitrc")
value	- option value to print

This function is used to display the current configuration options and their values in a readable format.

Definition at line 1480 of file init.c.

                                                                      {
    fprintf(stdout, "%3s %-15s: %s\n", o, name, value);
}

opt_prt_double()

void opt_prt_double	(	const char *	o,
		const char *	name,
		double	value )

Print an option and its value in a formatted manner for double values.

Parameters

o	- option flag (e.g., "-r:")
name	- option name (e.g., "red_gamma")
value	- double option value to print

This function is used to display the current configuration options and their double values in a readable format.

Definition at line 1513 of file init.c.

                                                                   {
    fprintf(stdout, "%3s %-15s: %0.2f\n", o, name, value);
}

opt_prt_int()

void opt_prt_int	(	const char *	o,
		const char *	name,
		int	value )

Print an option and its value in a formatted manner for integer values.

Parameters

o	- option flag (e.g., "-C:")
name	- option name (e.g., "--cols")
value	- integer option value to print

This function is used to display the current configuration options and their integer values in a readable format.

Definition at line 1502 of file init.c.

                                                             {
    fprintf(stdout, "%3s %-15s: %d\n", o, name, value);
}

opt_prt_str()

void opt_prt_str	(	const char *	o,
		const char *	name,
		const char *	value )

Print an option and its value in a formatted manner for integer values.

Parameters

o	- option flag (e.g., "-C:")
name	- option name (e.g., "--cols")
value	- integer option value to print

This function is used to display the current configuration options and their integer values in a readable format.

Definition at line 1491 of file init.c.

                                                                     {
    fprintf(stdout, "%3s %-15s: %s\n", o, name, value);
}

parse_opt_args()

int parse_opt_args	(	Init *	init,
		int	argc,
		char **	argv )

Parse command-line options and set Init struct values accordingly.

Parameters

init	- pointer to Init struct to be populated with option values
argc	- argument count from main()
argv	- argument vector from main()

Returns

0 on success, -1 on failure

This function uses the argp library to parse command-line options defined in the options array. It updates the Init struct with values from the options and handles any special flags for dumping or writing configuration.

Definition at line 622 of file init.c.

                                                      {
    init->argc = destroy_argv(init->argc, init->argv);
    argp_parse(&argp, argc, argv, 0, 0, init);
    return 0;
}

References Init::argc, Init::argv, and destroy_argv().

Referenced by popup_form(), popup_menu(), popup_pick(), and popup_view().

Here is the call graph for this function:

Here is the caller graph for this function:

process_config_files()

int process_config_files

(

Init *

init

)

parse the configuration file specified in init->minitrc and set Init struct values accordingly

Returns

on success, -1 on failure

Lines beginning with '#" are comments, discard. Copy line to tmp_str removing quotes, spaces, semicolons, and newlines. Record structure is "parse key=value pairs". Skip lines without '='. Set init struct values based on key. Skip unknown keys.

Definition at line 673 of file init.c.

                                     {
    char config_file_name[MAXLEN];
    int rc;
    if (!init->minitrc[0]) {
        char *e = getenv("MINITRC");
        if (e)
            strnz__cpy(init->minitrc, e, MAXLEN - 1);
        else
            strnz__cpy(init->minitrc, "~/.minitrc", MAXLEN - 1);
    }
 
    expand_tilde(init->minitrc, MAXLEN - 1);
    strnz__cpy(config_file_name, init->minitrc, MAXLEN - 1);
    rc = process_config_file(config_file_name, init);
 
    expand_tilde(init->mapp_theme, MAXLEN - 1);
    strnz__cpy(config_file_name, init->mapp_theme, MAXLEN - 1);
    rc = process_config_file(config_file_name, init);
    return rc;
}

References expand_tilde(), Init::mapp_theme, Init::minitrc, process_config_file(), and strnz__cpy().

Referenced by mapp_initialization().

Here is the call graph for this function:

Here is the caller graph for this function:

write_config()

int write_config

(

Init *

init

)

Write the current configuration to a file specified in init->minitrc.

Parameters

init	- pointer to Init struct containing current configuration

Returns

0 on success, -1 on failure

The configuration is written in key=value format, one per line. Lines beginning with '#' are comments and are ignored when reading the config file. The file is created if it does not exist, and overwritten if it does exist

Definition at line 1160 of file init.c.

                             {
    char *e;
    char minitrc_dmp[MAXLEN];
    char tmp_str[MAXLEN];
    SIO *sio = init->sio;
    e = getenv("CMENU_HOME");
    minitrc_dmp[0] = '\0';
    char config_s[MAXLEN];
    if (e) {
        strnz__cpy(minitrc_dmp, e, MAXLEN - 1);
        strnz__cat(minitrc_dmp, "/", MAXLEN - 1);
    }
    strnz__cat(minitrc_dmp, "minitrc.dmp", MAXLEN - 1);
    ui_log(INFO, _("writing config file to: %s"), minitrc_dmp);
    FILE *minitrc_fp = fopen(minitrc_dmp, "w");
    if (minitrc_fp == (FILE *)0) {
        ssnprintf(em0, MAXLEN - 1, _("failed to open file: %s"), minitrc_dmp);
        ui_log(ERROR, "em0");
        return (-1);
    }
    (void)fprintf(minitrc_fp, "# %s\n", minitrc_dmp);
    char *doc_tbl[50] = {
        _("# C-Menu example configuration file"),
        "#",
        _("# This file is generated by C-Menu when run with the -W option."),
        _("# Copy this file and edit the copy because this file will be"),
        _("# overwritten each time C-Menu is run with the - W option."),
        "#",
        _("# C-Menu processes key value pairs in reading order from its"),
        _("# main configuraiton file, ~/ menuapp /.minitrc, and any other"),
        _("# configuration files sourced with include statements such as"),
        _("# the following:"),
        "#",
        _("# include = ~/menuapp/theme/default"),
        "#",
        _("# Assuming your configuration file is in ~/menuapp/theme/Red,"),
        _("# you could create a symbolic link named default that points to"),
        _("# Red, and then include default in your main configuration file."),
        _("# (Actually ~/menuapp/.minitrc already includes default, so you"),
        _("# would only need to create the theme file and the symbolic link."),
        "#",
        _("# ln -s Red default"),
        "#",
        _("# Key value pairs included from configuration files are"),
        _("# processed in reading order as they are included."),
        "#",
        _("# This is significant in the event that a key is included more"),
        _("# than once in the configuration file and / or included files."),
        _("# Only the last value read for a key will be used by C-Menu."),
        "#",
        _("# If you want to override key values in the C-Menu configuration"),
        _("# file, you can do so by inserting an include statement for a"),
        _("# supplemental configuration file below the keys you want to"),
        _("# override in the C-Menu configuration file. Conversely, if you"),
        _("# want to use a supplemental configuration as the default,"),
        _("# include it first."),
        "#",
        _("# Parsing: Lines beginning with # are comments and are ignored."),
        _("# Lines containing key=value pairs are parsed and the key and"),
        _("# value are extracted. Lines without an '=' are ignored. Values"),
        _("# are stripped of leading and trailing whitespace and quotes."),
        _("# Values can be enclosed in single or double quotes to preserve"),
        _("# leading and trailing whitespace. Values can also be specified"),
        _("# as hex color codes such as #ff0000 for red. If a value is"),
        _("# specified as a hex color code, it is parsed and stored as a"),
        _("# hex color code in the configuration. An unquoted '#' that is"),
        _("# not part of a six digit hex color code and after key values"),
        _("# have been extracted is the beginning of a comment."), ""};
    for (int i = 0; doc_tbl[i][0] != '\0'; i++)
        (void)fprintf(minitrc_fp, "%s\n", doc_tbl[i]);
    (void)fprintf(minitrc_fp, "#\n");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "parent_cmd", init->parent_cmd);
    print_argp_doc(minitrc_fp, config_s, "parent_cmd");
    ssnprintf(config_s, MAXLEN - 1, "%s=%d", "cols", init->cols);
    print_argp_doc(minitrc_fp, config_s, "cols");
    ssnprintf(config_s, MAXLEN - 1, "%s=%d", "lines", init->lines);
    print_argp_doc(minitrc_fp, config_s, "lines");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "title", init->title);
    print_argp_doc(minitrc_fp, config_s, "title");
    ssnprintf(config_s, MAXLEN - 1, "%s=%d", "begx", init->begx);
    print_argp_doc(minitrc_fp, config_s, "begx");
    ssnprintf(config_s, MAXLEN - 1, "%s=%d", "begy", init->begy);
    print_argp_doc(minitrc_fp, config_s, "begy");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "cmd_all", init->cmd_all);
    print_argp_doc(minitrc_fp, config_s, "cmd_all");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "cmd", init->cmd);
    print_argp_doc(minitrc_fp, config_s, "cmd");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "mapp_spec", init->mapp_spec);
    print_argp_doc(minitrc_fp, config_s, "mapp_spec");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "help_spec", init->help_spec);
    print_argp_doc(minitrc_fp, config_s, "help_spec");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "in_spec", init->in_spec);
    print_argp_doc(minitrc_fp, config_s, "in_spec");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "out_spec", init->out_spec);
    print_argp_doc(minitrc_fp, config_s, "out_spec");
 
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "log_file_spec", init->log_file_spec);
    print_argp_doc(minitrc_fp, config_s, "log_file_spec");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "log_level", ui_log_level_s[init->min_log_level]);
    print_argp_doc(minitrc_fp, config_s, "log_level");
 
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "receiver_cmd", init->receiver_cmd);
    print_argp_doc(minitrc_fp, config_s, "receiver_cmd");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "provider_cmd", init->provider_cmd);
    print_argp_doc(minitrc_fp, config_s, "provider_cmd");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "f_erase_remainder", init->f_erase_remainder ? "true" : "false");
    print_argp_doc(minitrc_fp, config_s, "f_erase_remainder");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "fill_char", init->fill_char);
    print_argp_doc(minitrc_fp, config_s, "fill_char");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "f_strip_ansi", init->f_strip_ansi ? "true" : "false");
    print_argp_doc(minitrc_fp, config_s, "f_strip_ansi");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "f_multiple_cmd_args", init->f_multiple_cmd_args ? "true" : "false");
    print_argp_doc(minitrc_fp, config_s, "f_multiple_cmd_args");
    ssnprintf(config_s, MAXLEN - 1, "%s=%d", "select_max", init->select_max);
    print_argp_doc(minitrc_fp, config_s, "select_max");
 
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "f_ln", init->f_ln ? "true" : "false");
    print_argp_doc(minitrc_fp, config_s, "f_ln");
 
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "f_squeeze", init->f_squeeze ? "true" : "false");
    print_argp_doc(minitrc_fp, config_s, "f_squeeze");
    ssnprintf(config_s, MAXLEN - 1, "%s=%d", "tab_stop", init->tab_stop);
    print_argp_doc(minitrc_fp, config_s, "tab_stop");
 
    ssnprintf(config_s, MAXLEN - 1, "%s=%d", "timeout_secs", init->timeout_secs);
    print_argp_doc(minitrc_fp, config_s, "timeout_secs");
 
    ssnprintf(config_s, MAXLEN - 1, "%s=%d", "h_shift", init->h_shift);
    print_argp_doc(minitrc_fp, config_s, "h_shift");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "brackets", init->brackets);
    print_argp_doc(minitrc_fp, config_s, "brackets");
 
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "wrap", init->wrap ? "true" : "false");
    print_argp_doc(minitrc_fp, config_s, "wrap");
 
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "f_ignore_case", init->f_ignore_case ? "true" : "false");
    print_argp_doc(minitrc_fp, config_s, "f_ignore_case");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "p_view_files", init->p_view_files ? "true" : "false");
    print_argp_doc(minitrc_fp, config_s, "p_view_files");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "f_read_theme", init->f_read_theme ? "true" : "false");
    print_argp_doc(minitrc_fp, config_s, "f_read_theme");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "editor", init->editor);
    print_argp_doc(minitrc_fp, config_s, "editor");
    ssnprintf(config_s, MAXLEN - 1, "%s=%c", "border", sio->border);
    print_argp_doc(minitrc_fp, config_s, "border");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "bg", sio->bg);
    print_argp_doc(minitrc_fp, config_s, "bg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%6x", "fg", sio->fg);
    print_argp_doc(minitrc_fp, config_s, "fg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "box_fg", sio->box_fg);
    print_argp_doc(minitrc_fp, config_s, "box_fg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "box_bg", sio->box_bg);
    print_argp_doc(minitrc_fp, config_s, "box_bg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "ind_fg", sio->ind_fg);
    print_argp_doc(minitrc_fp, config_s, "ind_fg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "ind_bg", sio->ind_bg);
    print_argp_doc(minitrc_fp, config_s, "ind_bg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "brackets_fg", sio->brackets_fg);
    print_argp_doc(minitrc_fp, config_s, "brackets_fg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "brackets_bg", sio->brackets_bg);
    print_argp_doc(minitrc_fp, config_s, "brackets_bg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "fill_char_fg", sio->fill_char_fg);
    print_argp_doc(minitrc_fp, config_s, "fill_char_fg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "fill_char_bg", sio->fill_char_bg);
    print_argp_doc(minitrc_fp, config_s, "fill_char_bg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "ln_bg", sio->ln_bg);
    print_argp_doc(minitrc_fp, config_s, "ln_bg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "ln_fg", sio->ln_fg);
    print_argp_doc(minitrc_fp, config_s, "ln_bg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "cmdln_bg", sio->cmdln_bg);
    print_argp_doc(minitrc_fp, config_s, "cmdln_bg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "cmdln_fg", sio->cmdln_fg);
    print_argp_doc(minitrc_fp, config_s, "cmdln_fg");
 
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "nt_fg", sio->nt_fg);
    print_argp_doc(minitrc_fp, config_s, "nt_fg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "nt_bg", sio->nt_bg);
    print_argp_doc(minitrc_fp, config_s, "nt_bg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "nt_hl_fg", sio->nt_hl_fg);
    print_argp_doc(minitrc_fp, config_s, "nt_hl_fg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "nt_hl_bg", sio->nt_hl_bg);
    print_argp_doc(minitrc_fp, config_s, "nt_hl_bg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "nt_rev_fg", sio->nt_rev_fg);
    print_argp_doc(minitrc_fp, config_s, "nt_rev_fg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "nt_rev_bg", sio->nt_rev_bg);
    print_argp_doc(minitrc_fp, config_s, "nt_rev_bg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "nt_hl_rev_fg", sio->nt_hl_rev_fg);
    print_argp_doc(minitrc_fp, config_s, "nt_hl_rev_fg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "nt_hl_rev_bg", sio->nt_hl_rev_bg);
    print_argp_doc(minitrc_fp, config_s, "nt_hl_rev_bg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "title_fg", sio->title_fg);
    print_argp_doc(minitrc_fp, config_s, "title_fg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "title_bg", sio->title_bg);
    print_argp_doc(minitrc_fp, config_s, "title_bg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "ran_fg", sio->ran_fg);
    print_argp_doc(minitrc_fp, config_s, "ran_fg");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "ran_bg", sio->ran_bg);
    print_argp_doc(minitrc_fp, config_s, "ran_bg");
    ssnprintf(config_s, MAXLEN - 1, "%s=%0.2f", "blue_gamma", sio->blue_gamma);
    print_argp_doc(minitrc_fp, config_s, "blue_gamma");
    ssnprintf(config_s, MAXLEN - 1, "%s=%0.2f", "gray_gamma", sio->gray_gamma);
    print_argp_doc(minitrc_fp, config_s, "gray_gamma");
    ssnprintf(config_s, MAXLEN - 1, "%s=%0.2f", "green_gamma", sio->green_gamma);
    print_argp_doc(minitrc_fp, config_s, "green_gamma");
    ssnprintf(config_s, MAXLEN - 1, "%s=%0.2f", "red_gamma", sio->red_gamma);
    print_argp_doc(minitrc_fp, config_s, "red_gamma");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "black", sio->black);
    print_argp_doc(minitrc_fp, config_s, "black");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "red", sio->red);
    print_argp_doc(minitrc_fp, config_s, "red");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "green", sio->green);
    print_argp_doc(minitrc_fp, config_s, "green");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "yellow", sio->yellow);
    print_argp_doc(minitrc_fp, config_s, "yellow");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "blue", sio->blue);
    print_argp_doc(minitrc_fp, config_s, "blue");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "magenta", sio->magenta);
    print_argp_doc(minitrc_fp, config_s, "magenta");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "cyan", sio->cyan);
    print_argp_doc(minitrc_fp, config_s, "cyan");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "white", sio->white);
    print_argp_doc(minitrc_fp, config_s, "white");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "bblack", sio->bblack);
    print_argp_doc(minitrc_fp, config_s, "bblack");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "bred", sio->bred);
    print_argp_doc(minitrc_fp, config_s, "bred");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "bgreen", sio->bgreen);
    print_argp_doc(minitrc_fp, config_s, "bgreen");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "byellow", sio->byellow);
    print_argp_doc(minitrc_fp, config_s, "byellow");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "bblue", sio->bblue);
    print_argp_doc(minitrc_fp, config_s, "bblue");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "bmagenta", sio->bmagenta);
    print_argp_doc(minitrc_fp, config_s, "bmagenta");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "bcyan", sio->bcyan);
    print_argp_doc(minitrc_fp, config_s, "bcyan");
    ssnprintf(config_s, MAXLEN - 1, "%s=#%06x", "bwhite", sio->bwhite);
    print_argp_doc(minitrc_fp, config_s, "bwhite");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "mapp_data", init->mapp_data);
    print_argp_doc(minitrc_fp, config_s, "mapp_data");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "mapp_help", init->mapp_help);
    print_argp_doc(minitrc_fp, config_s, "mapp_help");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "mapp_home", init->mapp_home);
    print_argp_doc(minitrc_fp, config_s, "mapp_home");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "mapp_msrc", init->mapp_msrc);
    print_argp_doc(minitrc_fp, config_s, "mapp_msrc");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "mapp_user", init->mapp_user);
    print_argp_doc(minitrc_fp, config_s, "mapp_user");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "mapp_theme", init->mapp_theme);
    print_argp_doc(minitrc_fp, config_s, "mapp_theme");
    ssnprintf(config_s, MAXLEN - 1, "%s=%s", "include", init->mapp_theme);
    (void)fprintf(minitrc_fp, "%-34s # default theme file\n", config_s);
    strnz__cpy(tmp_str, "Configuration written to file: ", MAXLEN - 1);
    strnz__cat(tmp_str, minitrc_dmp, MAXLEN - 1);
    ui_perror(tmp_str);
    return 0;
}

References SIO::bblack, SIO::bblue, SIO::bcyan, Init::begx, Init::begy, SIO::bg, SIO::bgreen, SIO::black, SIO::blue, SIO::blue_gamma, SIO::bmagenta, SIO::border, SIO::box_bg, SIO::box_fg, Init::brackets, SIO::brackets_bg, SIO::brackets_fg, SIO::bred, SIO::bwhite, SIO::byellow, Init::cmd, Init::cmd_all, SIO::cmdln_bg, SIO::cmdln_fg, Init::cols, SIO::cyan, Init::editor, em0, Init::f_erase_remainder, Init::f_ignore_case, Init::f_ln, Init::f_multiple_cmd_args, Init::f_read_theme, Init::f_squeeze, Init::f_strip_ansi, SIO::fg, Init::fill_char, SIO::fill_char_bg, SIO::fill_char_fg, SIO::gray_gamma, SIO::green, SIO::green_gamma, Init::h_shift, Init::help_spec, Init::in_spec, SIO::ind_bg, SIO::ind_fg, Init::lines, SIO::ln_bg, SIO::ln_fg, Init::log_file_spec, SIO::magenta, Init::mapp_data, Init::mapp_help, Init::mapp_home, Init::mapp_msrc, Init::mapp_spec, Init::mapp_theme, Init::mapp_user, Init::min_log_level, SIO::nt_bg, SIO::nt_fg, SIO::nt_hl_bg, SIO::nt_hl_fg, SIO::nt_hl_rev_bg, SIO::nt_hl_rev_fg, SIO::nt_rev_bg, SIO::nt_rev_fg, Init::out_spec, Init::p_view_files, Init::parent_cmd, print_argp_doc(), Init::provider_cmd, SIO::ran_bg, SIO::ran_fg, Init::receiver_cmd, SIO::red, SIO::red_gamma, Init::select_max, Init::sio, ssnprintf(), strnz__cat(), strnz__cpy(), Init::tab_stop, Init::timeout_secs, Init::title, SIO::title_bg, SIO::title_fg, ui_log_level_s, ui_perror(), SIO::white, Init::wrap, and SIO::yellow.

Referenced by mapp_initialization(), and menu_cmd_processor().

Here is the call graph for this function:

Here is the caller graph for this function:

zero_opt_args()

void zero_opt_args

(

Init *

init

)

Initialize optional arguments in the Init struct to default values.

Parameters

init	- pointer to Init struct to be initialized This function sets all optional argument fields in the Init struct to their default values before parsing command-line options or configuration file. This ensures that any fields not specified by the user will have known default values.

Definition at line 637 of file init.c.

                               {
    init->lines = 0;
    init->cols = 0;
    init->begx = 0;
    init->begy = 0;
    init->f_mapp_desc = false;
    init->f_provider_cmd = false;
    init->f_receiver_cmd = false;
    init->f_title = false;
    init->f_mapp_spec = false;
    init->f_help_spec = false;
    init->f_in_spec = false;
    init->f_out_spec = false;
    init->p_view_files = false;
    init->h_shift = 0;
    init->mapp_spec[0] = init->help_spec[0] = '\0';
    init->provider_cmd[0] = init->receiver_cmd[0] = '\0';
    init->title[0] = '\0';
    init->cmd[0] = init->cmd_all[0] = '\0';
    init->parent_cmd[0] = '\0';
    init->in_spec[0] = init->out_spec[0] = '\0';
    init->help_spec[0] = '\0';
    init->in_spec[0] = '\0';
    init->out_spec[0] = '\0';
}

References Init::begx, Init::begy, Init::cmd, Init::cmd_all, Init::cols, Init::f_help_spec, Init::f_in_spec, Init::f_mapp_desc, Init::f_mapp_spec, Init::f_out_spec, Init::f_provider_cmd, Init::f_receiver_cmd, Init::f_title, Init::h_shift, Init::help_spec, Init::in_spec, Init::lines, Init::mapp_spec, Init::out_spec, Init::p_view_files, Init::parent_cmd, Init::provider_cmd, Init::receiver_cmd, and Init::title.

Referenced by popup_form(), popup_menu(), popup_pick(), and popup_view().

Here is the caller graph for this function: