external/bsd/libevent/dist/Doxyfile

   1 # Doxyfile 1.5.1
   2
   3 # This file describes the settings to be used by the documentation system
   4 # doxygen (www.doxygen.org) for a project
   5 #
   6 # All text after a hash (#) is considered a comment and will be ignored
   7 # The format is:
   8 #       TAG = value [value, ...]
   9 # For lists items can also be appended using:
  10 #       TAG += value [value, ...]
  11 # Values that contain spaces should be placed between quotes (" ")
  12
  13 #---------------------------------------------------------------------------
  14 # Project related configuration options
  15 #---------------------------------------------------------------------------
  16
  17 # The PROJECT_NAME tag is a single word (or a sequence of words surrounded
  18 # by quotes) that should identify the project.
  19
  20 PROJECT_NAME           = libevent
  21
  22 # Place all output under 'doxygen/'
  23
  24 OUTPUT_DIRECTORY        = doxygen/
  25
  26 # If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen
  27 # will interpret the first line (until the first dot) of a JavaDoc-style
  28 # comment as the brief description. If set to NO, the JavaDoc
  29 # comments will behave just like the Qt-style comments (thus requiring an
  30 # explicit @brief command for a brief description.
  31
  32 JAVADOC_AUTOBRIEF      = YES
  33
  34 # Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C
  35 # sources only. Doxygen will then generate output that is more tailored for C.
  36 # For instance, some of the names that are used will be different. The list
  37 # of all members will be omitted, etc.
  38
  39 OPTIMIZE_OUTPUT_FOR_C  = YES
  40
  41 # If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the
  42 # brief documentation of file, namespace and class members alphabetically
  43 # by member name. If set to NO (the default) the members will appear in
  44 # declaration order.
  45
  46 SORT_BRIEF_DOCS        = YES
  47
  48 # If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag
  49 # can be used to strip a user-defined part of the path. Stripping is
  50 # only done if one of the specified strings matches the left-hand part of
  51 # the path. The tag can be used to show relative paths in the file list.
  52 # If left blank the directory from which doxygen is run is used as the
  53 # path to strip.
  54
  55 STRIP_FROM_PATH        = include/
  56
  57 #---------------------------------------------------------------------------
  58 # configuration options related to the input files
  59 #---------------------------------------------------------------------------
  60
  61 # The INPUT tag can be used to specify the files and/or directories that contain
  62 # documented source files. You may enter file names like "myfile.cpp" or
  63 # directories like "/usr/src/myproject". Separate the files or directories
  64 # with spaces.
  65
  66 INPUT                  = \
  67         include/event2/buffer.h \
  68         include/event2/buffer_compat.h \
  69         include/event2/bufferevent.h \
  70         include/event2/bufferevent_compat.h \
  71         include/event2/bufferevent_ssl.h \
  72         include/event2/dns.h \
  73         include/event2/dns_compat.h \
  74         include/event2/event.h \
  75         include/event2/event_compat.h \
  76         include/event2/http.h \
  77         include/event2/http_compat.h \
  78         include/event2/listener.h \
  79         include/event2/rpc.h \
  80         include/event2/rpc_compat.h \
  81         include/event2/tag.h \
  82         include/event2/tag_compat.h \
  83         include/event2/thread.h \
  84         include/event2/util.h
  85
  86 #---------------------------------------------------------------------------
  87 # configuration options related to the HTML output
  88 #---------------------------------------------------------------------------
  89
  90 # If the GENERATE_HTML tag is set to YES (the default) Doxygen will
  91 # generate HTML output.
  92
  93 GENERATE_HTML          = YES
  94
  95 #---------------------------------------------------------------------------
  96 # configuration options related to the LaTeX output
  97 #---------------------------------------------------------------------------
  98
  99 # If the GENERATE_LATEX tag is set to YES (the default) Doxygen will
 100 # generate Latex output.
 101
 102 GENERATE_LATEX         = YES
 103
 104 # The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put.
 105 # If a relative path is entered the value of OUTPUT_DIRECTORY will be
 106 # put in front of it. If left blank `latex' will be used as the default path.
 107
 108 LATEX_OUTPUT           = latex
 109
 110 # The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be
 111 # invoked. If left blank `latex' will be used as the default command name.
 112
 113 LATEX_CMD_NAME         = latex
 114
 115 # The MAKEINDEX_CMD_NAME tag can be used to specify the command name to
 116 # generate index for LaTeX. If left blank `makeindex' will be used as the
 117 # default command name.
 118
 119 MAKEINDEX_CMD_NAME     = makeindex
 120
 121 # If the COMPACT_LATEX tag is set to YES Doxygen generates more compact
 122 # LaTeX documents. This may be useful for small projects and may help to
 123 # save some trees in general.
 124
 125 COMPACT_LATEX          = NO
 126
 127 # The PAPER_TYPE tag can be used to set the paper type that is used
 128 # by the printer. Possible values are: a4, a4wide, letter, legal and
 129 # executive. If left blank a4wide will be used.
 130
 131 PAPER_TYPE             = a4wide
 132
 133 # The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX
 134 # packages that should be included in the LaTeX output.
 135
 136 EXTRA_PACKAGES         =
 137
 138 # The LATEX_HEADER tag can be used to specify a personal LaTeX header for
 139 # the generated latex document. The header should contain everything until
 140 # the first chapter. If it is left blank doxygen will generate a
 141 # standard header. Notice: only use this tag if you know what you are doing!
 142
 143 LATEX_HEADER           =
 144
 145 # If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated
 146 # is prepared for conversion to pdf (using ps2pdf). The pdf file will
 147 # contain links (just like the HTML output) instead of page references
 148 # This makes the output suitable for online browsing using a pdf viewer.
 149
 150 PDF_HYPERLINKS         = NO
 151
 152 # If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of
 153 # plain latex in the generated Makefile. Set this option to YES to get a
 154 # higher quality PDF documentation.
 155
 156 USE_PDFLATEX           = YES
 157
 158 # If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode.
 159 # command to the generated LaTeX files. This will instruct LaTeX to keep
 160 # running if errors occur, instead of asking the user for help.
 161 # This option is also used when generating formulas in HTML.
 162
 163 LATEX_BATCHMODE        = NO
 164
 165 # If LATEX_HIDE_INDICES is set to YES then doxygen will not
 166 # include the index chapters (such as File Index, Compound Index, etc.)
 167 # in the output.
 168
 169 LATEX_HIDE_INDICES     = NO
 170
 171 #---------------------------------------------------------------------------
 172 # configuration options related to the man page output
 173 #---------------------------------------------------------------------------
 174
 175 # If the GENERATE_MAN tag is set to YES (the default) Doxygen will
 176 # generate man pages
 177
 178 GENERATE_MAN           = YES
 179
 180 # The MAN_EXTENSION tag determines the extension that is added to
 181 # the generated man pages (default is the subroutine's section .3)
 182
 183 MAN_EXTENSION          = .3
 184
 185 # If the MAN_LINKS tag is set to YES and Doxygen generates man output,
 186 # then it will generate one additional man file for each entity
 187 # documented in the real man page(s). These additional files
 188 # only source the real man page, but without them the man command
 189 # would be unable to find the correct page. The default is NO.
 190
 191 MAN_LINKS              = YES
 192
 193 #---------------------------------------------------------------------------
 194 # Configuration options related to the preprocessor
 195 #---------------------------------------------------------------------------
 196
 197 # If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will
 198 # evaluate all C-preprocessor directives found in the sources and include
 199 # files.
 200
 201 ENABLE_PREPROCESSING   = YES
 202
 203 # If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro
 204 # names in the source code. If set to NO (the default) only conditional
 205 # compilation will be performed. Macro expansion can be done in a controlled
 206 # way by setting EXPAND_ONLY_PREDEF to YES.
 207
 208 MACRO_EXPANSION        = NO
 209
 210 # If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES
 211 # then the macro expansion is limited to the macros specified with the
 212 # PREDEFINED and EXPAND_AS_DEFINED tags.
 213
 214 EXPAND_ONLY_PREDEF     = NO
 215
 216 # If the SEARCH_INCLUDES tag is set to YES (the default) the includes files
 217 # in the INCLUDE_PATH (see below) will be search if a #include is found.
 218
 219 SEARCH_INCLUDES        = YES
 220
 221 # The INCLUDE_PATH tag can be used to specify one or more directories that
 222 # contain include files that are not input files but should be processed by
 223 # the preprocessor.
 224
 225 INCLUDE_PATH           =
 226
 227 # You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard
 228 # patterns (like *.h and *.hpp) to filter out the header-files in the
 229 # directories. If left blank, the patterns specified with FILE_PATTERNS will
 230 # be used.
 231
 232 INCLUDE_FILE_PATTERNS  =
 233
 234 # The PREDEFINED tag can be used to specify one or more macro names that
 235 # are defined before the preprocessor is started (similar to the -D option of
 236 # gcc). The argument of the tag is a list of macros of the form: name
 237 # or name=definition (no spaces). If the definition and the = are
 238 # omitted =1 is assumed. To prevent a macro definition from being
 239 # undefined via #undef or recursively expanded use the := operator
 240 # instead of the = operator.
 241
 242 PREDEFINED             = TAILQ_ENTRY RB_ENTRY _EVENT_DEFINED_TQENTRY _EVENT_IN_DOXYGEN
 243
 244 # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then
 245 # this tag can be used to specify a list of macro names that should be expanded.
 246 # The macro definition that is found in the sources will be used.
 247 # Use the PREDEFINED tag if you want to use a different macro definition.
 248
 249 EXPAND_AS_DEFINED      =
 250
 251 # If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then
 252 # doxygen's preprocessor will remove all function-like macros that are alone
 253 # on a line, have an all uppercase name, and do not end with a semicolon. Such
 254 # function macros are typically used for boiler-plate code, and will confuse
 255 # the parser if not removed.
 256
 257 SKIP_FUNCTION_MACROS   = YES