0

(C++) クラスのプライベート セクションの後にパブリック セクションをドキュメント化するように Doxygen に指示するにはどうすればよいですか?

例えば

class Brg {

public:

    //! this function will be documented
    void documentedFunction1()

 private:

    void irrelevantFunction()

 public:


    //! this function will _not_ be documented
    void undocumentedFunction1()
};

最初の公開セクションがなくても、2 番目の公開セクションはまだ文書化されていません。

doxylog.txt レポート:

警告: ドキュメント化された関数 `Brg:: undocumentedFunction1' は宣言または定義されていません

# ドクシーファイル 1.5.2
#------------------------------------------------- --------------------------
# プロジェクト関連の設定オプション
#------------------------------------------------- --------------------------
DOXYFILE_ENCODING = UTF-8
PROJECT_NAME = "何とか"
プロジェクト番号 =
OUTPUT_DIRECTORY = ./gen_docs/
CREATE_SUBDIRS = いいえ
OUTPUT_LANGUAGE = 英語
BRIEF_MEMBER_DESC = はい
REPEAT_BRIEF = はい
ABBREVIATE_BRIEF =
常に_詳細_秒 = いいえ
INLINE_INHERITED_MEMB = いいえ
FULL_PATH_NAMES = いいえ
STRIP_FROM_PATH =
STRIP_FROM_INC_PATH =
SHORT_NAMES = いいえ
JAVADOC_AUTOBRIEF = いいえ
MULTILINE_CPP_IS_BRIEF = いいえ
DETAILS_AT_TOP = いいえ
INHERIT_DOCS = はい
SEPARATE_MEMBER_PAGES = いいえ
TAB_SIZE = 4
エイリアス =
OPTIMIZE_OUTPUT_FOR_C = いいえ
OPTIMIZE_OUTPUT_JAVA = いいえ
BUILTIN_STL_SUPPORT = いいえ
CPP_CLI_SUPPORT = いいえ
DISTRIBUTE_GROUP_DOC = いいえ
サブグループ化 = はい
#------------------------------------------------- --------------------------
# 関連する設定オプションを構築する
#------------------------------------------------- --------------------------
EXTRACT_ALL = はい
EXTRACT_PRIVATE = いいえ
EXTRACT_STATIC = はい
EXTRACT_LOCAL_CLASSES = いいえ
EXTRACT_LOCAL_METHODS = いいえ
HIDE_UNDOC_MEMBERS = いいえ
HIDE_UNDOC_CLASSES = はい
HIDE_FRIEND_COMPOUNDS = いいえ
HIDE_IN_BODY_DOCS = いいえ
INTERNAL_DOCS = いいえ
CASE_SENSE_NAMES = はい
HIDE_SCOPE_NAMES = いいえ
SHOW_INCLUDE_FILES = はい
INLINE_INFO = はい
SORT_MEMBER_DOCS = はい
SORT_BRIEF_DOCS = いいえ
SORT_BY_SCOPE_NAME = いいえ
GENERATE_TODOLIST = はい
GENERATE_TESTLIST = はい
GENERATE_BUGLIST = はい
GENERATE_DEPRECATEDLIST=はい
ENABLED_SECTIONS =
MAX_INITIALIZER_LINES = 30
SHOW_USED_FILES = はい
SHOW_DIRECTORIES = はい
ファイル_バージョン_フィルター =
#------------------------------------------------- --------------------------
# 警告と進行状況メッセージに関連する設定オプション
#------------------------------------------------- --------------------------
静かな = いいえ
警告 = はい
WARN_IF_UNDOCUMENTED = はい
WARN_IF_DOC_ERROR = はい
WARN_NO_PARAMDOC = いいえ
WARN_FORMAT = "$file:$line: $text"
WARN_LOGFILE = doxylog.txt
#------------------------------------------------- --------------------------
# 入力ファイルに関連する設定オプション
#------------------------------------------------- --------------------------
入力 = 。\
             ..\コード
IMAGE_PATH = .
入力_エンコード = UTF-8
ファイル_パターン = *.cpp \
                         *.cc \
                         *.h \
                         *.hpp\
                         *。TXT
例_パス = . \
             ..\コード\
EXAMPLE_PATTERNS = *.lua \
                         *.h
例_再帰 = はい
再帰 = はい
除外 =
EXCLUDE_SYMLINKS = いいえ
除外パターン =
EXCLUDE_SYMBOLS =
INPUT_FILTER =
FILTER_PATTERNS =
FILTER_SOURCE_FILES = いいえ
#------------------------------------------------- --------------------------
# ソース閲覧に関する設定オプション
#------------------------------------------------- --------------------------
SOURCE_BROWSER = いいえ
INLINE_SOURCES = いいえ
STRIP_CODE_COMMENTS = はい
REFERENCED_BY_RELATION = はい
REFERENCES_RELATION = はい
REFERENCES_LINK_SOURCE = はい
USE_HTAGS = いいえ
VERBATIM_HEADERS = はい
#------------------------------------------------- --------------------------
# アルファベット順のクラス インデックスに関連する設定オプション
#------------------------------------------------- --------------------------
ALPHABETICAL_INDEX = いいえ
COLS_IN_ALPHA_INDEX = 5
IGNORE_PREFIX =
#------------------------------------------------- --------------------------
# HTML 出力に関連する設定オプション
#------------------------------------------------- --------------------------
GENERATE_HTML = はい
HTML_OUTPUT = html
HTML_FILE_EXTENSION = .html
HTML_STYLESHEET =
HTML_ALIGN_MEMBERS = はい
GENERATE_HTMLHELP = はい
CHM_FILE =
HHC_LOCATION =
GENERATE_CHI = はい
BINARY_TOC = いいえ
TOC_EXPAND = いいえ
DISABLE_INDEX = いいえ
ENUM_VALUES_PER_LINE = 4
GENERATE_TREEVIEW = いいえ
TREEVIEW_WIDTH = 250
#------------------------------------------------- --------------------------
# LaTeX 出力に関連する設定オプション
#------------------------------------------------- --------------------------
GENERATE_LATEX = いいえ
LATEX_OUTPUT = ラテックス
LATEX_CMD_NAME = ラテックス
EXTRA_PACKAGES = アムスマス
MAKEINDEX_CMD_NAME = makeindex
COMPACT_LATEX = いいえ
PAPER_TYPE = a4ワイド
EXTRA_PACKAGES =
LATEX_HEADER =
PDF_HYPERLINKS = はい
USE_PDFLATEX = はい
LATEX_BATCHMODE = いいえ
LATEX_HIDE_INDICES = いいえ
#------------------------------------------------- --------------------------
# RTF 出力に関連する設定オプション
#------------------------------------------------- --------------------------
GENERATE_RTF = いいえ
RTF_OUTPUT = rtf
COMPACT_RTF = いいえ
RTF_HYPERLINKS = いいえ
RTF_STYLESHEET_FILE =
RTF_EXTENSIONS_FILE =
#------------------------------------------------- --------------------------
# man ページの出力に関連する設定オプション
#------------------------------------------------- --------------------------
GENERATE_MAN = いいえ
MAN_OUTPUT = 男
MAN_EXTENSION = .3
MAN_LINKS = いいえ
#------------------------------------------------- --------------------------
# XML 出力に関連する設定オプション
#------------------------------------------------- --------------------------
GENERATE_XML = いいえ
XML_OUTPUT = xml
XML_SCHEMA =
XML_DTD =
XML_PROGRAMLISTING = はい
#------------------------------------------------- --------------------------
# AutoGen Definitions 出力の構成オプション
#------------------------------------------------- --------------------------
GENERATE_AUTOGEN_DEF = いいえ
#------------------------------------------------- --------------------------
# Perl モジュール出力に関連する設定オプション
#------------------------------------------------- --------------------------
GENERATE_PERLMOD = いいえ
PERLMOD_LATEX = いいえ
PERLMOD_PRETTY = はい
PERLMOD_MAKEVAR_PREFIX =
#------------------------------------------------- --------------------------
# プリプロセッサに関連する設定オプション   
#------------------------------------------------- --------------------------
ENABLE_PREPROCESSING = はい
MACRO_EXPANSION = いいえ
EXPAND_ONLY_PREDEF = いいえ
SEARCH_INCLUDES = はい
INCLUDE_PATH =
INCLUDE_FILE_PATTERNS =
定義済み =
EXPAND_AS_DEFINED =
SKIP_FUNCTION_MACROS = はい
#------------------------------------------------- --------------------------
# Configuration::外部参照に関連する追加   
#------------------------------------------------- --------------------------
TAGFILES = ../ExternalModule/ExternalModule.tag=../../../ExternalModule/Docs/html
GENERATE_TAGFILE = モジュール名.tag
ALLEXTERNALS = いいえ
外部グループ = はい
PERL_PATH = /usr/bin/perl
#------------------------------------------------- --------------------------
# dot ツールに関連する設定オプション   
#------------------------------------------------- --------------------------
CLASS_DIAGRAMS = はい
MSCGEN_PATH =
HIDE_UNDOC_RELATIONS = はい
HAVE_DOT = はい
クラス_グラフ = はい
コラボレーション_グラフ = はい
GROUP_GRAPHS = はい
UML_LOOK = いいえ
テンプレート_関係 = はい
INCLUDE_GRAPH = はい
INCLUDED_BY_GRAPH = はい
CALL_GRAPH = いいえ
CALLER_GRAPH = いいえ
GRAPHICAL_HIERARCHY = はい
ディレクトリ_グラフ = はい
DOT_IMAGE_FORMAT = png
DOT_PATH =
DOTFILE_DIRS =
DOT_GRAPH_MAX_NODES = 50
DOT_TRANSPARENT = いいえ
DOT_MULTI_TARGETS = いいえ
GENERATE_LEGEND = はい
DOT_CLEANUP = はい
#------------------------------------------------- --------------------------
# Configuration::検索エンジン関連の追加   
#------------------------------------------------- --------------------------
検索エンジン = いいえ
4

1 に答える 1

0

上記のコードサンプル(セミコロンが追加されている)と提供されているdoxygen構成ファイルを考えると、両方の機能はDoxygen 1.5.2(構成ファイルに基づく作成者バージョン)とDoxygen 1.7.6.1(最新)で文書化されています。

The Doxygen configuration file appears to reference an external tag file as well as additional directories. Its possible there is some interaction with one of those files that would affect doxygen's behavior in this case, however there isn't enough information in the test case to investigate further.

于 2011-12-25T16:44:48.470 に答える