1a8e1175bSopenharmony_ciPROJECT_NAME           = "Mbed TLS v3.6.0"
2a8e1175bSopenharmony_ciOUTPUT_DIRECTORY       = ../apidoc/
3a8e1175bSopenharmony_ciFULL_PATH_NAMES        = NO
4a8e1175bSopenharmony_ciOPTIMIZE_OUTPUT_FOR_C  = YES
5a8e1175bSopenharmony_ciEXTRACT_ALL            = YES
6a8e1175bSopenharmony_ciEXTRACT_PRIVATE        = YES
7a8e1175bSopenharmony_ciEXTRACT_STATIC         = YES
8a8e1175bSopenharmony_ciCASE_SENSE_NAMES       = NO
9a8e1175bSopenharmony_ciINPUT                  = ../include input ../tests/include/alt-dummy
10a8e1175bSopenharmony_ciFILE_PATTERNS          = *.h
11a8e1175bSopenharmony_ciRECURSIVE              = YES
12a8e1175bSopenharmony_ciEXCLUDE_SYMLINKS       = YES
13a8e1175bSopenharmony_ciSOURCE_BROWSER         = YES
14a8e1175bSopenharmony_ciREFERENCED_BY_RELATION = YES
15a8e1175bSopenharmony_ciREFERENCES_RELATION    = YES
16a8e1175bSopenharmony_ciALPHABETICAL_INDEX     = NO
17a8e1175bSopenharmony_ciHTML_OUTPUT            = .
18a8e1175bSopenharmony_ciHTML_TIMESTAMP         = YES
19a8e1175bSopenharmony_ciSEARCHENGINE           = YES
20a8e1175bSopenharmony_ciGENERATE_LATEX         = NO
21a8e1175bSopenharmony_ciGENERATE_XML           = YES
22a8e1175bSopenharmony_ciMACRO_EXPANSION        = YES
23a8e1175bSopenharmony_ciEXPAND_ONLY_PREDEF     = YES
24a8e1175bSopenharmony_ciINCLUDE_PATH           = ../include
25a8e1175bSopenharmony_ciEXPAND_AS_DEFINED      = MBEDTLS_PRIVATE
26a8e1175bSopenharmony_ciCLASS_DIAGRAMS         = NO
27a8e1175bSopenharmony_ciHAVE_DOT               = YES
28a8e1175bSopenharmony_ciDOT_GRAPH_MAX_NODES    = 200
29a8e1175bSopenharmony_ciMAX_DOT_GRAPH_DEPTH    = 1000
30a8e1175bSopenharmony_ciDOT_TRANSPARENT        = YES
31a8e1175bSopenharmony_ci
32a8e1175bSopenharmony_ci# We mostly use \retval declarations to document which error codes a function
33a8e1175bSopenharmony_ci# can return. The reader can follow the hyperlink to the definition of the
34a8e1175bSopenharmony_ci# constant to get the generic documentation of that error code. If we don't
35a8e1175bSopenharmony_ci# have anything to say about the specific error code for the specific
36a8e1175bSopenharmony_ci# function, we can leave the description part of the \retval command blank.
37a8e1175bSopenharmony_ci# This is perfectly valid as far as Doxygen is concerned. However, with
38a8e1175bSopenharmony_ci# Clang >=15, the -Wdocumentation option emits a warning for empty
39a8e1175bSopenharmony_ci# descriptions.
40a8e1175bSopenharmony_ci#   https://github.com/Mbed-TLS/mbedtls/issues/6960
41a8e1175bSopenharmony_ci#   https://github.com/llvm/llvm-project/issues/60315
42a8e1175bSopenharmony_ci# As a workaround, you can write something like
43a8e1175bSopenharmony_ci#     \retval #PSA_ERROR_INSUFFICIENT_MEMORY \emptydescription
44a8e1175bSopenharmony_ci# This avoids writing redundant text and keeps Clang happy.
45a8e1175bSopenharmony_ciALIASES += emptydescription=""
46a8e1175bSopenharmony_ci
47a8e1175bSopenharmony_ci# Define away Mbed TLS macros that make parsing definitions difficult.
48a8e1175bSopenharmony_ci# MBEDTLS_DEPRECATED is not included in this list as it's important to
49a8e1175bSopenharmony_ci# display deprecated status in the documentation.
50a8e1175bSopenharmony_ciPREDEFINED             = "MBEDTLS_CHECK_RETURN_CRITICAL="   \
51a8e1175bSopenharmony_ci                         "MBEDTLS_CHECK_RETURN_TYPICAL="    \
52a8e1175bSopenharmony_ci                         "MBEDTLS_CHECK_RETURN_OPTIONAL="   \
53a8e1175bSopenharmony_ci                         "MBEDTLS_PRINTF_ATTRIBUTE(a,b)="   \
54a8e1175bSopenharmony_ci                         "__DOXYGEN__"                      \
55a8e1175bSopenharmony_ci
56