blob: 83d6a95f74b40b379f03b983bf4c842f3d273860 [file] [log] [blame]
Aditya Deshpande7428c612022-12-08 11:04:44 +00001PROJECT_NAME = "mbed TLS v2.28.2"
Krzysztof Stachowiaka0188d62018-01-19 16:21:11 +01002OUTPUT_DIRECTORY = ../apidoc/
Paul Bakker37ca75d2011-01-06 12:28:03 +00003FULL_PATH_NAMES = NO
Paul Bakker37ca75d2011-01-06 12:28:03 +00004OPTIMIZE_OUTPUT_FOR_C = YES
Paul Bakker37ca75d2011-01-06 12:28:03 +00005EXTRACT_ALL = YES
Paul Bakker37ca75d2011-01-06 12:28:03 +00006EXTRACT_PRIVATE = YES
Paul Bakker37ca75d2011-01-06 12:28:03 +00007EXTRACT_STATIC = YES
Paul Bakker37ca75d2011-01-06 12:28:03 +00008CASE_SENSE_NAMES = NO
Gilles Peskinea9daa5c2018-09-26 17:49:57 +02009INPUT = ../include input
Manuel Pégourié-Gonnard27d81392015-03-10 17:37:30 +000010FILE_PATTERNS = *.h
Paul Bakker37ca75d2011-01-06 12:28:03 +000011RECURSIVE = YES
Gilles Peskine11d3cf42017-12-22 15:34:37 +010012EXCLUDE_SYMLINKS = YES
Manuel Pégourié-Gonnard35d07bf2016-01-08 16:48:51 +010013EXCLUDE_PATTERNS = *_internal.h *_wrap.h
Paul Bakker37ca75d2011-01-06 12:28:03 +000014SOURCE_BROWSER = YES
Paul Bakker37ca75d2011-01-06 12:28:03 +000015REFERENCED_BY_RELATION = YES
Paul Bakker37ca75d2011-01-06 12:28:03 +000016REFERENCES_RELATION = YES
Paul Bakker37ca75d2011-01-06 12:28:03 +000017ALPHABETICAL_INDEX = NO
Paul Bakker37ca75d2011-01-06 12:28:03 +000018HTML_OUTPUT = .
Paul Bakker37ca75d2011-01-06 12:28:03 +000019HTML_TIMESTAMP = YES
Andrzej Kurekef3f27b2022-02-15 06:56:16 -050020SEARCHENGINE = YES
Paul Bakker37ca75d2011-01-06 12:28:03 +000021GENERATE_LATEX = NO
Andrzej Kurek593adc82020-03-27 12:58:13 -040022INCLUDE_PATH = ../include
Paul Bakker37ca75d2011-01-06 12:28:03 +000023CLASS_DIAGRAMS = NO
Paul Bakker37ca75d2011-01-06 12:28:03 +000024HAVE_DOT = YES
Paul Bakker13a94a12013-09-10 16:17:15 +020025DOT_GRAPH_MAX_NODES = 200
Paul Bakker37ca75d2011-01-06 12:28:03 +000026MAX_DOT_GRAPH_DEPTH = 1000
Paul Bakker37ca75d2011-01-06 12:28:03 +000027DOT_TRANSPARENT = YES
Gilles Peskine2fb14e92023-02-14 19:15:40 +010028
Gilles Peskine809c3d52023-02-23 13:37:54 +010029# We mostly use \retval declarations to document which error codes a function
Gilles Peskine8377f3d2023-02-23 13:03:30 +010030# can return. The reader can follow the hyperlink to the definition of the
31# constant to get the generic documentation of that error code. If we don't
32# have anything to say about the specific error code for the specific
33# function, we can leave the description part of the \retval command blank.
34# This is perfectly valid as far as Doxygen is concerned. However, with
35# Clang >=15, the -Wdocumentation option emits a warning for empty
36# descriptions.
Gilles Peskine2fb14e92023-02-14 19:15:40 +010037# https://github.com/Mbed-TLS/mbedtls/issues/6960
38# https://github.com/llvm/llvm-project/issues/60315
Gilles Peskine8377f3d2023-02-23 13:03:30 +010039# As a workaround, you can write something like
Gilles Peskine4b86f532023-02-21 10:21:12 +010040# \retval #PSA_ERROR_INSUFFICIENT_MEMORY \emptydescription
Gilles Peskine8377f3d2023-02-23 13:03:30 +010041# This avoids writing redundant text and keeps Clang happy.
Gilles Peskine2fb14e92023-02-14 19:15:40 +010042ALIASES += emptydescription=""
David Horstmann62ef6212023-03-14 14:20:38 +000043
44GENERATE_XML = YES