PROJECT_NAME           = @PACKAGE_NAME@

PROJECT_NUMBER         = @PACKAGE_VERSION@

PROJECT_BRIEF          = Library implementing the XKB specification for parsing \
                         keyboard descriptions and handling keyboard state

OUTPUT_DIRECTORY       = @OUTPUT_DIRECTORY@

SITEMAP_URL            = https://xkbcommon.org/doc/@PACKAGE_VERSION@/

BRIEF_MEMBER_DESC      = NO

JAVADOC_AUTOBRIEF      = YES

OPTIMIZE_OUTPUT_FOR_C  = YES

EXTENSION_MAPPING      = no_extension=md \
                         txt=md

SORT_MEMBER_DOCS       = NO

QUIET                  = $(DOXYGEN_QUIET)

WARN_IF_UNDOCUMENTED   = NO

WARN_AS_ERROR          = $(DOXYGEN_WARN_AS_ERROR)

INPUT                  = @INPUT@

FILE_PATTERNS          = *.c \
                         *.h

FILTER_PATTERNS        = *include/xkbcommon/xkbcommon-keysyms.h=scripts/update-keysyms-docstring.py

# These are included in other file but we do not want them as standalone
EXCLUDE                = LICENSE NEWS.md meson.options

RECURSIVE              = YES

EXTRACT_PRIVATE        = YES

EXAMPLE_PATH           = test

USE_MDFILE_AS_MAINPAGE = README.md

VERBATIM_HEADERS       = NO

MARKDOWN_ID_STYLE      = GITHUB

ALPHABETICAL_INDEX     = NO

IGNORE_PREFIX          = xkb_ \
                         XKB_ \
                         rxkb_ \
                         RXKB_

DISABLE_INDEX          = NO

GENERATE_TREEVIEW      = NO

FULL_SIDEBAR           = NO

HTML_EXTRA_STYLESHEET  = doc/doxygen-extra.css

HTML_COLORSTYLE        = TOGGLE

TIMESTAMP              = NO

ENUM_VALUES_PER_LINE   = 1

SEARCHENGINE           = YES

GENERATE_LATEX         = NO

HAVE_DOT               = YES

DOTFILE_DIRS           = doc/diagrams

DOT_IMAGE_FORMAT       = svg

IMAGE_PATH             = doc/img

# Workaround HTML tags not supported by Doxygen
ALIASES                += figure="@htmlonly[block]<figure>@endhtmlonly"
ALIASES                += endfigure="@htmlonly[block]</figure>@endhtmlonly"
ALIASES                += figcaption="@htmlonly[block]<figcaption>@endhtmlonly"
ALIASES                += endfigcaption="@htmlonly[block]</figcaption>@endhtmlonly"
ALIASES                += rawHtml="@htmlonly<!--"
ALIASES                += endRawHtml="-->@endhtmlonly"