# Doxygen configuration for AfterAPro.
# Only the settings that differ from the defaults are listed, so this file
# stays readable. `make docs-api` must finish with zero warnings.

PROJECT_NAME           = "AfterAPro"
PROJECT_BRIEF          = "Non-destructive RAW photo editor"
OUTPUT_DIRECTORY       = docs/api
CREATE_SUBDIRS         = NO
OPTIMIZE_OUTPUT_FOR_C  = YES
EXTRACT_ALL            = NO
EXTRACT_STATIC         = YES
INPUT                  = include src
FILE_PATTERNS          = *.c *.h
RECURSIVE              = YES
GENERATE_HTML          = YES
HTML_OUTPUT            = html
GENERATE_LATEX         = NO
GENERATE_TREEVIEW      = YES
JAVADOC_AUTOBRIEF      = YES
QUIET                  = YES
WARNINGS               = YES
WARN_IF_UNDOCUMENTED   = YES
WARN_IF_DOC_ERROR      = YES
WARN_NO_PARAMDOC       = YES
# FAIL_ON_WARNINGS rather than YES: YES stops at the first one, which turns a
# run with forty seven warnings in it into forty seven runs. This prints them
# all and then fails, which is the only way the zero above is a rule rather
# than a wish.
WARN_AS_ERROR          = FAIL_ON_WARNINGS
WARN_LOGFILE           = doxygen_warn.log
MACRO_EXPANSION        = YES
PREDEFINED             = __cplusplus=0

# main.c includes every module: its graph is over the default 50 nodes, and
# a graph cut off is a warning, which the docs gate refuses.
DOT_GRAPH_MAX_NODES    = 100
