| Dave Rodgman | e23d647 | 2024-01-22 15:45:49 +0000 | [diff] [blame] | 1 | PROJECT_NAME = "Mbed TLS v3.5.2" |
| Krzysztof Stachowiak | a0188d6 | 2018-01-19 16:21:11 +0100 | [diff] [blame] | 2 | OUTPUT_DIRECTORY = ../apidoc/ |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 3 | FULL_PATH_NAMES = NO |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 4 | OPTIMIZE_OUTPUT_FOR_C = YES |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 5 | EXTRACT_ALL = YES |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 6 | EXTRACT_PRIVATE = YES |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 7 | EXTRACT_STATIC = YES |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 8 | CASE_SENSE_NAMES = NO |
| Gilles Peskine | 5186014 | 2024-01-23 17:45:33 +0100 | [diff] [blame] | 9 | INPUT = ../include input ../tests/include/alt-dummy |
| Manuel Pégourié-Gonnard | 27d8139 | 2015-03-10 17:37:30 +0000 | [diff] [blame] | 10 | FILE_PATTERNS = *.h |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 11 | RECURSIVE = YES |
| Gilles Peskine | 11d3cf4 | 2017-12-22 15:34:37 +0100 | [diff] [blame] | 12 | EXCLUDE_SYMLINKS = YES |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 13 | SOURCE_BROWSER = YES |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 14 | REFERENCED_BY_RELATION = YES |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 15 | REFERENCES_RELATION = YES |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 16 | ALPHABETICAL_INDEX = NO |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 17 | HTML_OUTPUT = . |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 18 | HTML_TIMESTAMP = YES |
| Andrzej Kurek | 47cfd15 | 2022-01-21 08:43:44 -0500 | [diff] [blame] | 19 | SEARCHENGINE = YES |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 20 | GENERATE_LATEX = NO |
| David Horstmann | dbee883 | 2023-03-22 17:35:14 +0000 | [diff] [blame] | 21 | GENERATE_XML = YES |
| Mateusz Starzyk | beb95b4 | 2021-05-20 14:41:22 +0200 | [diff] [blame] | 22 | MACRO_EXPANSION = YES |
| Mateusz Starzyk | beb95b4 | 2021-05-20 14:41:22 +0200 | [diff] [blame] | 23 | EXPAND_ONLY_PREDEF = YES |
| Andrzej Kurek | 593adc8 | 2020-03-27 12:58:13 -0400 | [diff] [blame] | 24 | INCLUDE_PATH = ../include |
| Mateusz Starzyk | beb95b4 | 2021-05-20 14:41:22 +0200 | [diff] [blame] | 25 | EXPAND_AS_DEFINED = MBEDTLS_PRIVATE |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 26 | CLASS_DIAGRAMS = NO |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 27 | HAVE_DOT = YES |
| Paul Bakker | 13a94a1 | 2013-09-10 16:17:15 +0200 | [diff] [blame] | 28 | DOT_GRAPH_MAX_NODES = 200 |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 29 | MAX_DOT_GRAPH_DEPTH = 1000 |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 30 | DOT_TRANSPARENT = YES |
| Gilles Peskine | 8ea7d85 | 2023-02-14 19:15:40 +0100 | [diff] [blame] | 31 | |
| Gilles Peskine | 2fb4e14 | 2023-02-23 13:37:54 +0100 | [diff] [blame] | 32 | # We mostly use \retval declarations to document which error codes a function |
| Gilles Peskine | 4348a83 | 2023-02-23 13:03:30 +0100 | [diff] [blame] | 33 | # can return. The reader can follow the hyperlink to the definition of the |
| 34 | # constant to get the generic documentation of that error code. If we don't |
| 35 | # have anything to say about the specific error code for the specific |
| 36 | # function, we can leave the description part of the \retval command blank. |
| 37 | # This is perfectly valid as far as Doxygen is concerned. However, with |
| 38 | # Clang >=15, the -Wdocumentation option emits a warning for empty |
| 39 | # descriptions. |
| Gilles Peskine | 8ea7d85 | 2023-02-14 19:15:40 +0100 | [diff] [blame] | 40 | # https://github.com/Mbed-TLS/mbedtls/issues/6960 |
| 41 | # https://github.com/llvm/llvm-project/issues/60315 |
| Gilles Peskine | 4348a83 | 2023-02-23 13:03:30 +0100 | [diff] [blame] | 42 | # As a workaround, you can write something like |
| Gilles Peskine | 787f7c8 | 2023-02-21 10:21:12 +0100 | [diff] [blame] | 43 | # \retval #PSA_ERROR_INSUFFICIENT_MEMORY \emptydescription |
| Gilles Peskine | 4348a83 | 2023-02-23 13:03:30 +0100 | [diff] [blame] | 44 | # This avoids writing redundant text and keeps Clang happy. |
| Gilles Peskine | 8ea7d85 | 2023-02-14 19:15:40 +0100 | [diff] [blame] | 45 | ALIASES += emptydescription="" |
| David Horstmann | 1d46bfb | 2023-03-14 14:20:38 +0000 | [diff] [blame] | 46 | |
| David Horstmann | b9f0674 | 2023-03-16 16:07:12 +0000 | [diff] [blame] | 47 | # Define away Mbed TLS macros that make parsing definitions difficult. |
| 48 | # MBEDTLS_DEPRECATED is not included in this list as it's important to |
| 49 | # display deprecated status in the documentation. |
| 50 | PREDEFINED = "MBEDTLS_CHECK_RETURN_CRITICAL=" \ |
| 51 | "MBEDTLS_CHECK_RETURN_TYPICAL=" \ |
| 52 | "MBEDTLS_CHECK_RETURN_OPTIONAL=" \ |
| 53 | "MBEDTLS_PRINTF_ATTRIBUTE(a,b)=" \ |
| Andrzej Kurek | 2b3c06e | 2023-07-03 06:52:37 -0400 | [diff] [blame] | 54 | "__DOXYGEN__" \ |
| David Horstmann | b9f0674 | 2023-03-16 16:07:12 +0000 | [diff] [blame] | 55 | |