mirror/mbedtls
1
0
Fork 0
mirror of https://github.com/Mbed-TLS/mbedtls.git synced 2024-12-28 06:19:27 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
fdb2047b36
mbedtls/doxygen/mbedtls.doxyfile

57 lines
2.4 KiB
Plaintext
Raw Normal View History

Bump version to 4.0.0 Signed-off-by: David Horstmann <david.horstmann@arm.com>
2024-09-03 16:36:30 +00:00
PROJECT_NAME = "Mbed TLS v4.0.0"
Have doxygen run in the doxygen directory When the Doxywizzard GUI is used and the doxyfile is loaded, the workind directory for doxygen is set to the location of the doxyfile. However the Make and CMake build systems expect doxygen to be ran from the top level directory. This commit unifies the build system and the Doxywizzard GUI so that all of them expect doxygen to be executed in the doxygen directory.
2018-01-19 15:21:11 +00:00
OUTPUT_DIRECTORY = ../apidoc/
- Added Doxygen source code documentation parts (donated by Fox-IT)
2011-01-06 12:28:03 +00:00
FULL_PATH_NAMES = NO
OPTIMIZE_OUTPUT_FOR_C = YES
EXTRACT_ALL = YES
EXTRACT_PRIVATE = YES
EXTRACT_STATIC = YES
CASE_SENSE_NAMES = NO
Adapt make apidoc Signed-off-by: Ronald Cron <ronald.cron@arm.com>
2024-06-17 11:52:55 +00:00
INPUT = ../include ../tf-psa-crypto/include input ../tf-psa-crypto/drivers/builtin/include ../tests/include/alt-dummy
Switch to actual TF-PSA-Crypto build_info.h Signed-off-by: Ronald Cron <ronald.cron@arm.com>
2024-11-06 13:32:52 +00:00
EXCLUDE = ../tf-psa-crypto/drivers/builtin/include/mbedtls/build_info.h
Use only headers for doxygen (no doc in C files)
2015-03-10 17:37:30 +00:00
FILE_PATTERNS = *.h
- Added Doxygen source code documentation parts (donated by Fox-IT)
2011-01-06 12:28:03 +00:00
RECURSIVE = YES
Doxygen: don't traverse symbolic links We don't use symbolic links as part of our build process, so tell Doxygen not to traverse them. In particular, if I have a symbolic link to a directory outside the build tree, I don't want Doxygen to follow it.
2017-12-22 14:34:37 +00:00
EXCLUDE_SYMLINKS = YES
- Added Doxygen source code documentation parts (donated by Fox-IT)
2011-01-06 12:28:03 +00:00
SOURCE_BROWSER = YES
REFERENCED_BY_RELATION = YES
REFERENCES_RELATION = YES
ALPHABETICAL_INDEX = NO
HTML_OUTPUT = .
HTML_TIMESTAMP = YES
doxygen: enable the search engine Signed-off-by: Andrzej Kurek <andrzej.kurek@arm.com>
2022-01-21 13:43:44 +00:00
SEARCHENGINE = YES
- Added Doxygen source code documentation parts (donated by Fox-IT)
2011-01-06 12:28:03 +00:00
GENERATE_LATEX = NO
Improve positioning of GENERATE_XML option It is clearer to have this option next to the GENERATE_LATEX option. Signed-off-by: David Horstmann <david.horstmann@arm.com>
2023-03-22 17:35:14 +00:00
GENERATE_XML = YES
Adjust doxyfile to expand MBEDTLS_PRIVATE macro. Signed-off-by: Mateusz Starzyk <mateusz.starzyk@mobica.com>
2021-05-20 12:41:22 +00:00
MACRO_EXPANSION = YES
EXPAND_ONLY_PREDEF = YES
Adapt make apidoc Signed-off-by: Ronald Cron <ronald.cron@arm.com>
2024-06-17 11:52:55 +00:00
INCLUDE_PATH = ../include ../tf-psa-crypto/include ../tf-psa-crypto/drivers/builtin/include
Adjust doxyfile to expand MBEDTLS_PRIVATE macro. Signed-off-by: Mateusz Starzyk <mateusz.starzyk@mobica.com>
2021-05-20 12:41:22 +00:00
EXPAND_AS_DEFINED = MBEDTLS_PRIVATE
- Added Doxygen source code documentation parts (donated by Fox-IT)
2011-01-06 12:28:03 +00:00
CLASS_DIAGRAMS = NO
HAVE_DOT = YES
Upgraded doxygen config file
2013-09-10 14:17:15 +00:00
DOT_GRAPH_MAX_NODES = 200
- Added Doxygen source code documentation parts (donated by Fox-IT)
2011-01-06 12:28:03 +00:00
MAX_DOT_GRAPH_DEPTH = 1000
DOT_TRANSPARENT = YES
Define a workaround for empty \retval description Since Clang 15, `clang -Wdocumentation` warns about an empty description in a Doxygen `\retval` command: ``` include/psa/crypto.h:91:23: error: empty paragraph passed to '\retval' command [-Werror,-Wdocumentation] * \retval #PSA_SUCCESS ~~~~~~~~~~~~~~~~~~~^ ``` Ideally `\retval` directives should have a description that describes the precise meaning of the return value, but we commonly use an empty description when the return value is a status code and the status code's description is sufficient documentation. As a workaround, define a Doxygen command `\emptydescription` that we can use to make the description source code non-empty, without changing the appearance. Using the command will be done in a subsequent commit. Signed-off-by: Gilles Peskine <Gilles.Peskine@arm.com>
2023-02-14 18:15:40 +00:00
Words. Use them! Signed-off-by: Gilles Peskine <Gilles.Peskine@arm.com>
2023-02-23 12:37:54 +00:00
# We mostly use \retval declarations to document which error codes a function
Further documentation improvements Signed-off-by: Gilles Peskine <Gilles.Peskine@arm.com>
2023-02-23 12:03:30 +00:00
# can return. The reader can follow the hyperlink to the definition of the
# constant to get the generic documentation of that error code. If we don't
# have anything to say about the specific error code for the specific
# function, we can leave the description part of the \retval command blank.
# This is perfectly valid as far as Doxygen is concerned. However, with
# Clang >=15, the -Wdocumentation option emits a warning for empty
# descriptions.
Define a workaround for empty \retval description Since Clang 15, `clang -Wdocumentation` warns about an empty description in a Doxygen `\retval` command: ``` include/psa/crypto.h:91:23: error: empty paragraph passed to '\retval' command [-Werror,-Wdocumentation] * \retval #PSA_SUCCESS ~~~~~~~~~~~~~~~~~~~^ ``` Ideally `\retval` directives should have a description that describes the precise meaning of the return value, but we commonly use an empty description when the return value is a status code and the status code's description is sufficient documentation. As a workaround, define a Doxygen command `\emptydescription` that we can use to make the description source code non-empty, without changing the appearance. Using the command will be done in a subsequent commit. Signed-off-by: Gilles Peskine <Gilles.Peskine@arm.com>
2023-02-14 18:15:40 +00:00
# https://github.com/Mbed-TLS/mbedtls/issues/6960
# https://github.com/llvm/llvm-project/issues/60315
Further documentation improvements Signed-off-by: Gilles Peskine <Gilles.Peskine@arm.com>
2023-02-23 12:03:30 +00:00
# As a workaround, you can write something like
Improve documentation of documentation workaround Signed-off-by: Gilles Peskine <Gilles.Peskine@arm.com>
2023-02-21 09:21:12 +00:00
# \retval #PSA_ERROR_INSUFFICIENT_MEMORY \emptydescription
Further documentation improvements Signed-off-by: Gilles Peskine <Gilles.Peskine@arm.com>
2023-02-23 12:03:30 +00:00
# This avoids writing redundant text and keeps Clang happy.
Define a workaround for empty \retval description Since Clang 15, `clang -Wdocumentation` warns about an empty description in a Doxygen `\retval` command: ``` include/psa/crypto.h:91:23: error: empty paragraph passed to '\retval' command [-Werror,-Wdocumentation] * \retval #PSA_SUCCESS ~~~~~~~~~~~~~~~~~~~^ ``` Ideally `\retval` directives should have a description that describes the precise meaning of the return value, but we commonly use an empty description when the return value is a status code and the status code's description is sufficient documentation. As a workaround, define a Doxygen command `\emptydescription` that we can use to make the description source code non-empty, without changing the appearance. Using the command will be done in a subsequent commit. Signed-off-by: Gilles Peskine <Gilles.Peskine@arm.com>
2023-02-14 18:15:40 +00:00
ALIASES += emptydescription=""
Tell Doxygen to generate XML Signed-off-by: David Horstmann <david.horstmann@arm.com>
2023-03-14 14:20:38 +00:00
Ignore mbedtls macros causing warnings Sphinx's breathe plugin cannot readily parse the Mbed TLS macros, so define the less essential ones away at the doxygen step to reduce the number of warnings. Signed-off-by: David Horstmann <david.horstmann@arm.com>
2023-03-16 16:07:12 +00:00
# Define away Mbed TLS macros that make parsing definitions difficult.
# MBEDTLS_DEPRECATED is not included in this list as it's important to
# display deprecated status in the documentation.
PREDEFINED = "MBEDTLS_CHECK_RETURN_CRITICAL=" \
"MBEDTLS_CHECK_RETURN_TYPICAL=" \
"MBEDTLS_CHECK_RETURN_OPTIONAL=" \
"MBEDTLS_PRINTF_ATTRIBUTE(a,b)=" \
Enable certain documented defines only when generating doxygen Avoid an "unrecognized define" error. Signed-off-by: Andrzej Kurek <andrzej.kurek@arm.com>
2023-07-03 10:52:37 +00:00
"__DOXYGEN__" \
Ignore mbedtls macros causing warnings Sphinx's breathe plugin cannot readily parse the Mbed TLS macros, so define the less essential ones away at the doxygen step to reduce the number of warnings. Signed-off-by: David Horstmann <david.horstmann@arm.com>
2023-03-16 16:07:12 +00:00
Reference in New Issue Copy Permalink