fdoc

modulefdoc_settings

The project settings: FORD's options, their defaults and their conversion from text.

Every source of settings (project file, fpm.toml, --config, command line) goes through set_option, which takes the option's values as a list of strings, the form the project file gives them.

Uses

Graphs

Uses

Used by

Variables

NameTypeAttributesDefaultDescription
INTEGER_OPTIONScharacter(len=*)privateparameter'graph_maxdepthgraph_maxnodesgraph_project_maxnodesmax_frontpage_itemsparallel'
LIST_OPTIONScharacter(len=*)privateparameter'copy_subdirdisplayexcludeexclude_dirextensionsextra_vartypesfixed_extensionsfpp_extensions'//'html_template_dirincludemacromd_extensionssrc_dir'
LOGICAL_OPTIONScharacter(len=*)privateparameter'coloured_edgesdbgdoxygenexternalizefixed_length_limitforcegraphhide_undocincl_srclowerpreprocess'//'print_creation_dateproc_internalsquietsearchshow_proc_parentsourcewarn'
MAP_OPTIONScharacter(len=*)privateparameter'aliasexternalextra_modsextra_filetypes'
PATH_LIST_OPTIONScharacter(len=*)privateparameter'copy_subdirexclude_dirhtml_template_dirincludesrc_dir'
PATH_OPTIONScharacter(len=*)privateparameter'cssfavicongraph_dirlogomathjax_configmd_base_dirmedia_diroutput_dirpage_dir'
STRING_OPTIONScharacter(len=*)privateparameter'authorauthor_descriptionauthor_picbitbucketcreation_datedoc_licensedocmarkdocmark_altemailencoding'//'facebookgithubgitlabgitter_sidecargoogle_pluslicenselinkedinpredocmarkpredocmark_altpreprocessor'//'privacy_policy_urlprojectproject_bitbucketproject_downloadproject_githubproject_gitlab'//'project_sourceforgeproject_urlproject_websiterevisionsortsummaryterms_of_service_urltwitterversion'//'websiteyear'

Types

file_type_t

An extra_filetypes entry.

map_entry_t

A key and its value.

settings_t

The project settings. Optional text options are not allocated unless set.

Functions

dump_settings

character(len=:) function dump_settings(s) result(text)

The settings as a JSON object, for comparison with FORD's. Unset options are null.

in_setpureprivate

pure logical function in_set(set, key)

True if key is one of the blank-separated words of set, which starts and ends with a blank.

is_optionpure

pure logical function is_option(key)

True if key is the name of an option.

new_settings

type(settings_t) function new_settings() result(s)

The defaults.

Subroutines

add_entryprivate

subroutine add_entry(entries, key, value)

Set key in entries, replacing any entry it has.

add_intrinsic_modulesprivate

subroutine add_intrinsic_modules(s)

Add the modules that come with compilers and common libraries to extra_mods.

check_settings

subroutine check_settings(s, stat, errmsg)

Validate the project file's settings and derive what depends on them, before the command line is applied.

finish_settings

subroutine finish_settings(s, directory, stat, errmsg)

Make paths absolute and format dates, after all settings are applied.

set_listprivate

subroutine set_list(s, key, values)

Set a list option.

set_logicalprivate

subroutine set_logical(s, key, value)

Set a logical option.

set_mapprivate

subroutine set_map(s, key, values, stat, errmsg)

Set a map option from strings of the form key<sep>value. Empty strings are ignored.

set_option

subroutine set_option(s, key, values, stat, errmsg)

Set option key, which must be one (see is_option), from its values as text.

set_textprivate

subroutine set_text(s, key, value)

Set a text or path option.