提问人:queeg 提问时间:11/6/2023 最后编辑:queeg 更新时间:11/6/2023 访问量:31
Doxygen 和未记录的物品
Doxygen and undocumented items
问:
最近我开始使用 Doxygen,我觉得它按预期工作。 现在我需要把重点放在未记录的项目上——好吧,你可以猜到。
我想创建一个单独的页面/组来列出未记录的项目,以便用户更容易找到它们(日志中的警告太容易被忽略)。但更重要的是,我想先整理出唾手可得的果实。让我解释一下......
在查看其他人编写的代码时,有时很难猜到它的作用。如果它调用其他未记录的方法,则尤其如此。不调用其他方法或仅使用记录的方法要容易得多。
那么,Doxygen 是否有可能跟踪调用堆栈并识别仅依赖于任何代码或已记录代码的代码,并且仅将这些项目添加到额外页面?-- 啊,如果所讨论的项目是一个结构或常量,它可以被视为不依赖于未记录的东西......
编辑: Doxygen 版本为 1.9.5
我相信 Doxygen 对代码的理解足够好,因为在日志中我看到的消息如下
Generating caller graph for function ExtractChannel_4
我的 Doxyfile 看起来像
$ doxygen -x Doxyfile
warning: ignoring unsupported tag 'PROJECT_ICON' at line 59, file Doxyfile
# Difference with default Doxyfile 1.9.1
PROJECT_NAME = Project
PROJECT_LOGO = icon.png
OUTPUT_DIRECTORY = ./doxygen/
ABBREVIATE_BRIEF =
EXTRACT_ALL = YES
EXTRACT_PRIVATE = YES
EXTRACT_PRIV_VIRTUAL = YES
EXTRACT_PACKAGE = YES
EXTRACT_STATIC = YES
EXTRACT_LOCAL_METHODS = YES
EXTRACT_ANON_NSPACES = YES
INTERNAL_DOCS = YES
INPUT = Doc/ApiDocIntro.dox \
./src
FILE_PATTERNS =
RECURSIVE = YES
EXAMPLE_PATTERNS =
SOURCE_BROWSER = YES
INLINE_SOURCES = YES
REFERENCED_BY_RELATION = YES
REFERENCES_RELATION = YES
REFERENCES_LINK_SOURCE = NO
HTML_TIMESTAMP = YES
HTML_DYNAMIC_SECTIONS = YES
MATHJAX_RELPATH = http://cdn.mathjax.org/mathjax/latest
GENERATE_LATEX = NO
LATEX_CMD_NAME = latex
CALL_GRAPH = YES
CALLER_GRAPH = YES
DOT_IMAGE_FORMAT = svg
INTERACTIVE_SVG = YES
DOT_GRAPH_MAX_NODES = 100
DOT_MULTI_TARGETS = YES
$
答: 暂无答案
评论
doxygen -x Doxyfile