fdtuicfg.h File Reference

FDOSTUI configuration loader. Allows a user to set options to control an FDOSTUI application without requiring a recompilation. More...

Go to the source code of this file.

Functions
void	fdtuicfg_load ()
	Load FDTUIDOS configuration data. More...
void	fdtuicfg_load_file (char const *i_path)
	Load FDOSTUI configuration data. More...

Detailed Description

FDOSTUI configuration loader. Allows a user to set options to control an FDOSTUI application without requiring a recompilation.

FDOSTUI configuration files are named "fdostui.ini." The placement of the file depends upon the operating system. fdtuicfg_load will perform the following search:

  Check current directory (ALL)
  Check directory program was executed (DOS, WINDOWS)
  Check $XDG_CONFIG_HOME directory (GNU/Linux, BSD)
  Check "$HOME/.config" directory (GNU/Liniux, BSD)

Theme

A theme in an FDOSTUI appliction is limited and is in alpha stage (not stable). That is, actual data structures that hold attribute data such as foreground and background colors may change.

It will most likely go through a number of revisions before it is complete and reliable. Using the feature, however, would help by reporting bugs and making suggestions.

There is more work to be done with implementing colors on all platforms. Currently, color is limited to the least common denominator (with the exception of the absence of color). This will most likely change in future releases.

See also

page_themeing

Function Documentation

fdtuicfg_load()

void fdtuicfg_load

(

)

Load FDTUIDOS configuration data.

Returns

none

Attempts to resolve the configuration file path and then calls fdtuicfg_load_file to load data.

This routine is called within wm_init.

fdtuicfg_load_file()

void fdtuicfg_load_file

(

char const *

i_path

)

Load FDOSTUI configuration data.

Parameters

[in]

i_path

INI file

Returns

none

When errors are encountered diagnostic messages are printed to stderr.