Index: channels/chan_h323.c =================================================================== --- channels/chan_h323.c (revision 66822) +++ channels/chan_h323.c (working copy) @@ -1938,9 +1938,10 @@ return info; } -/*! \brief +/* * Definition taken from rtp.c for rtpPayloadType because we need it here. */ + struct rtpPayloadType { int isAstFormat; /* whether the following code is an AST_FORMAT */ int code; Index: channels/chan_sip.c =================================================================== --- channels/chan_sip.c (revision 66822) +++ channels/chan_sip.c (working copy) @@ -1252,8 +1252,9 @@ /*! \brief A per-thread temporary pvt structure */ AST_THREADSTORAGE_CUSTOM(ts_temp_pvt, temp_pvt_init, temp_pvt_cleanup); -/*! \todo Move the sip_auth list to AST_LIST */ -static struct sip_auth *authl = NULL; /*!< Authentication list for realm authentication */ +/*! \breif Authentication list for realm authentication + * \todo Move the sip_auth list to AST_LIST */ +static struct sip_auth *authl = NULL; /* --- Sockets and networking --------------*/ @@ -2456,12 +2457,13 @@ \return pointer to terminated stripped string \param tmp input string that will be modified Examples: - +\verbatim "foo" valid input, returns bar foo returns the whole string < "foo ... > returns the string between brackets < "foo... bogus (missing closing bracket), returns the whole string XXX maybe should still skip the opening bracket +\endverbatim */ static char *get_in_brackets(char *tmp) { @@ -2510,7 +2512,9 @@ * Init pointers to empty string so we never get NULL dereferencing. * Overwrites the string. * return 0 on success, other values on error. + * \verbatim * general form we are expecting is sip[s]:username[:password][;parameter]@host[:port][;...] + * \endverbatim */ static int parse_uri(char *uri, char *scheme, char **ret_name, char **pass, char **domain, char **port, char **options) @@ -5947,7 +5951,9 @@ \note If the client indicates that it wishes to know the port we received from, it adds ;rport without an argument to the topmost via header. We need to add the port number (from our point of view) to that parameter. +\verbatim We always add ;received= to the topmost via header. +\endverbatim Received: RFC 3261, rport RFC 3581 */ static int copy_via_headers(struct sip_pvt *p, struct sip_request *req, const struct sip_request *orig, const char *field) { @@ -7467,7 +7473,11 @@ /*! \brief Build REFER/INVITE/OPTIONS message and transmit it \param init 0 = Prepare request within dialog, 1= prepare request, new branch, 2= prepare new request and new dialog. do_proxy_auth calls this with init!=2 - */ + \param p sip_pvt structure + \param sdp unknown + \param sipmethod unknown + +*/ static int transmit_invite(struct sip_pvt *p, int sipmethod, int sdp, int init) { struct sip_request req; @@ -8962,10 +8972,12 @@ * Terminate the uri at the first ';' or space. * Technically we should ignore escaped space per RFC3261 (19.1.1 etc) * but don't do it for the time being. Remember the uri format is: + *\verbatim * * sip:user:password@host:port;uri-parameters?headers * sips:user:password@host:port;uri-parameters?headers * + *\endverbatim */ static char *terminate_uri(char *uri) { Index: apps/app_skel.c =================================================================== --- apps/app_skel.c (revision 66822) +++ apps/app_skel.c (working copy) @@ -20,7 +20,7 @@ * * \brief Skeleton application * - * \author\verbatim <> \endvebatim + * \author\verbatim <> \endverbatim * * This is a skeleton for development of an Asterisk application * \ingroup applications Index: funcs/func_shell.c =================================================================== --- funcs/func_shell.c (revision 66822) +++ funcs/func_shell.c (working copy) @@ -16,7 +16,7 @@ /*! \file * - * \SHELL function to return the value of a system call. + * SHELL function to return the value of a system call. * * \note Inspiration and Guidance from Russell! Thank You! * Index: include/asterisk/manager.h =================================================================== --- include/asterisk/manager.h (revision 66822) +++ include/asterisk/manager.h (working copy) @@ -35,11 +35,15 @@ Manager protocol packages are text fields of the form a: b. There is always exactly one space after the colon. +\verbatim + The first header type is the "Event" header. Other headers vary from event to event. Headers end with standard \r\n termination. The last line of the manager response or event is an empty line. (\r\n) +\endverbatim + ** Please try to re-use existing headers to simplify manager message parsing in clients. Don't re-use an existing header with a new meaning, please. You can find a reference of standard headers in doc/manager.txt Index: include/asterisk/http.h =================================================================== --- include/asterisk/http.h (revision 66822) +++ include/asterisk/http.h (working copy) @@ -141,9 +141,11 @@ return the content, allocated with malloc(). Status should be changed to reflect the status of the request if it isn't 200 and title may be set to a malloc()'d string to an appropriate title for non-200 responses. Content length may also be specified. +\verbatim The return value may include additional headers at the front and MUST include a blank line with \r\n to provide separation between user headers and content (even if no content is specified) +\endverbatim */ typedef struct ast_str *(*ast_http_callback)(struct sockaddr_in *requestor, const char *uri, struct ast_variable *params, int *status, char **title, int *contentlength); Index: include/asterisk/event.h =================================================================== --- include/asterisk/event.h (revision 66822) +++ include/asterisk/event.h (working copy) @@ -280,7 +280,7 @@ /*! * \brief Retrieve an event from the cache * - * \param event_type The type of event to retrieve from the cache + * \param ast_event_type The type of event to retrieve from the cache * * The rest of the arguments to this function specify information elements to * match for retrieving events from the cache. They are specified in the form: Index: include/asterisk/devicestate.h =================================================================== --- include/asterisk/devicestate.h (revision 66822) +++ include/asterisk/devicestate.h (working copy) @@ -59,7 +59,7 @@ const char *ast_devstate_str(enum ast_device_state devstate); /*! \brief Convert device state from text to integer value - * \param The text representing the device state. Valid values are anything + * \param val The text representing the device state. Valid values are anything * that comes after AST_DEVICE_ in one of the defined values. * \return The AST_DEVICE_ integer value */ Index: include/asterisk/strings.h =================================================================== --- include/asterisk/strings.h (revision 66822) +++ include/asterisk/strings.h (working copy) @@ -47,7 +47,7 @@ /*! \brief Gets a pointer to the first non-whitespace character in a string. \param ast_skip_blanks function being used - \param str the input string + \arg str the input string \return a pointer to the first non-whitespace character */ AST_INLINE_API( @@ -61,8 +61,8 @@ /*! \brief Trims trailing whitespace characters from a string. - \param ast_trim_blanks function being used - \param str the input string + \param ast_skip_blanks function being used + \arg str the input string \return a pointer to the modified string */ AST_INLINE_API( @@ -88,7 +88,7 @@ /*! \brief Gets a pointer to first whitespace character in a string. \param ast_skip_noblanks function being used - \param str the input string + \arg str the input string \return a pointer to the first whitespace character */ AST_INLINE_API( @@ -102,7 +102,8 @@ /*! \brief Strip leading/trailing whitespace from a string. - \param s The string to be stripped (will be modified). + \param ast_strip function ast_strip being used. + \arg s The string to be stripped (will be modified). \return The stripped string. This functions strips all leading and trailing whitespace @@ -147,10 +148,9 @@ /*! \brief Size-limited null-terminating string copy. - \param ast_copy_string function being used - \param dst The destination buffer. - \param src The source string - \param size The size of the destination buffer + \arg dst The destination buffer. + \arg src The source string + \arg size The size of the destination buffer \return Nothing. This is similar to \a strncpy, with two important differences: @@ -183,9 +183,9 @@ This is a wrapper for snprintf, that properly handles the buffer pointer and buffer space available. - \param buffer current position in buffer to place string into (will be updated on return) - \param space remaining space in buffer (will be updated on return) - \param fmt printf-style format string + \arg buffer current position in buffer to place string into (will be updated on return) + \arg space remaining space in buffer (will be updated on return) + \arg fmt printf-style format string \return 0 on success, non-zero on failure. */ int ast_build_string(char **buffer, size_t *space, const char *fmt, ...) __attribute__ ((format (printf, 3, 4))); Index: include/asterisk/stringfields.h =================================================================== --- include/asterisk/stringfields.h (revision 66822) +++ include/asterisk/stringfields.h (working copy) @@ -319,7 +319,8 @@ \param x Pointer to a structure containing fields \param field Name of the field to set \param fmt printf-style format string - \param argslist a va_list of the args + \param args1 arguement one + \param args2 arguement two \return nothing */ #define ast_string_field_build_va(x, field, fmt, args1, args2) \ Index: include/asterisk/doxyref.h =================================================================== --- include/asterisk/doxyref.h (revision 66822) +++ include/asterisk/doxyref.h (working copy) @@ -16,7 +16,7 @@ * at the top of the source tree. */ -/*! \file This file generates Doxygen pages from files in the /doc +/*! \file doxyref.h This file generates Doxygen pages from files in the /doc directory of the Asterisk source code tree */ Index: main/manager.c =================================================================== --- main/manager.c (revision 66822) +++ main/manager.c (working copy) @@ -2877,10 +2877,13 @@ * * General: the unformatted text is used as a value of * XML output: to be completed + * + * \verbatim * Each section is within * where xxx is taken from ajaxdest variable or defaults to unknown * Each row is reported as an attribute Name="value" of an XML * entity named from the variable ajaxobjtype, default to "generic" + * \endverbatim * * HTML output: * each Name-value pair is output as a single row of a two-column table. Index: main/ast_expr2f.c =================================================================== --- main/ast_expr2f.c (revision 66822) +++ main/ast_expr2f.c (working copy) @@ -2866,7 +2866,7 @@ } /** Set the current column. - * @param line_number + * @param column_no * @param yyscanner The scanner object. */ void ast_yyset_column (int column_no , yyscan_t yyscanner) Index: main/rtp.c =================================================================== --- main/rtp.c (revision 66822) +++ main/rtp.c (working copy) @@ -774,6 +774,7 @@ * \param data * \param len * \param seqno + * \param timestamp * \returns */ static struct ast_frame *process_rfc2833(struct ast_rtp *rtp, unsigned char *data, int len, unsigned int seqno, unsigned int timestamp) Index: main/devicestate.c =================================================================== --- main/devicestate.c (revision 66822) +++ main/devicestate.c (working copy) @@ -93,13 +93,13 @@ * and reported back. * * - Extension states - * \arg \ref enum ast_extension_states + * \arg \ref ENUM ast_extension_states * \arg \ref pbx.c * \arg \ref pbx.h * - Structures - * - \ref struct ast_state_cb Callbacks for watchers + * - \ref ast_state_cb struct. Callbacks for watchers * - Callback ast_state_cb_type - * - \ref struct ast_hint + * - \ref ast_hint struct. * - Functions * - ast_extension_state_add() * - ast_extension_state_del() Index: res/res_jabber.c =================================================================== --- res/res_jabber.c (revision 66822) +++ res/res_jabber.c (working copy) @@ -304,7 +304,7 @@ /*! * \brief Detects the highest bit in a number. - * \param Number you want to have evaluated. + * \param number number you want to have evaluated. * \return the highest power of 2 that can go into the number. */ static int aji_highest_bit(int number) @@ -343,7 +343,8 @@ /*! * \brief Dial plan function status(). puts the status of watched user into a channel variable. - * \param channel, and username,watched user, status var + * \param chan struct. + * \param data * \return 0. */ static int aji_status_exec(struct ast_channel *chan, void *data) @@ -407,7 +408,8 @@ /*! * \brief Dial plan function to send a message. - * \param channel, and data, data is sender, reciever, message. + * \param chan struct. + * \param data Data is sender|reciever|message. * \return 0. */ static int aji_send_exec(struct ast_channel *chan, void *data) @@ -444,7 +446,10 @@ /*! * \brief the debug loop. - * \param aji_client structure, xml data as string, size of string, direction of packet, 1 for inbound 0 for outbound. + * \param data struct. + * \param xmpp xml data as string + * \param size of string + * \param is_incoming direction of packet 1 for inbound 0 for outbound. */ static void aji_log_hook(void *data, const char *xmpp, size_t size, int is_incoming) { @@ -470,7 +475,9 @@ /*! * \brief The action hook parses the inbound packets, constantly running. - * \param aji client structure, type of packet, the actual packet. + * \param data aji client structure. + * \param type type of packet. + * \param node the actual packet. * \return IKS_OK or IKS_HOOK . */ static int aji_act_hook(void *data, int type, iks *node) @@ -1091,7 +1098,8 @@ /*! * \brief Handles \verbatim \endverbatim tags. - * \param client structure and the iq node. + * \param client struct. + * \param node struct. * \return void. */ static void aji_handle_iq(struct aji_client *client, iks *node) @@ -1101,7 +1109,8 @@ /*! * \brief Handles presence packets. - * \param client structure and the node. + * \param client struct. + * \param pak struct. the node * \return void. */ static void aji_handle_message(struct aji_client *client, ikspak *pak) @@ -1333,7 +1342,8 @@ /*! * \brief handles subscription requests. - * \param aji_client struct and xml packet. + * \param client struct. + * \param pak xml packet. * \return void. */ static void aji_handle_subscribe(struct aji_client *client, ikspak *pak) @@ -1383,7 +1393,9 @@ /*! * \brief sends messages. - * \param aji_client struct , reciever, message. + * \param client struct. + * \param address + * \param message * \return 1. */ int ast_aji_send(struct aji_client *client, const char *address, const char *message) @@ -1407,7 +1419,10 @@ /*! * \brief create a chatroom. - * \param aji_client struct , room, server, topic for the room. + * \param client struct. + * \param room + * \param server + * \param topic topic for the room. * \return 0. */ int ast_aji_create_chat(struct aji_client *client, char *room, char *server, char *topic) @@ -1428,7 +1443,8 @@ /*! * \brief join a chatroom. - * \param aji_client struct , room. + * \param client struct. + * \param room * \return res. */ int ast_aji_join_chat(struct aji_client *client, char *room) @@ -1456,7 +1472,10 @@ /*! * \brief invite to a chatroom. - * \param aji_client struct ,user, room, message. + * \param client struct. + * \param user + * \param room + * \param message * \return res. */ int ast_aji_invite_chat(struct aji_client *client, char *user, char *room, char *message) @@ -1491,7 +1510,7 @@ /*! * \brief receive message loop. - * \param aji_client struct. + * \param data struct. * \return void. */ static void *aji_recv_loop(void *data) @@ -1529,7 +1548,7 @@ /*! * \brief increments the mid field for messages and other events. - * \param message id. + * \param mid char. * \return void. */ void ast_aji_increment_mid(char *mid) @@ -1636,7 +1655,7 @@ */ /*! * \brief goes through roster and prunes users not needed in list, or adds them accordingly. - * \param aji_client struct. + * \param client struct. * \return void. */ static void aji_pruneregister(struct aji_client *client) @@ -1689,7 +1708,8 @@ /*! * \brief filters the roster packet we get back from server. - * \param aji_client struct, and xml packet. + * \param data struct. + * \param pak xml packet. * \return IKS_FILTER_EAT. */ static int aji_filter_roster(void *data, ikspak *pak) @@ -1800,7 +1820,8 @@ /*! * \brief connects as a client to jabber server. - * \param aji_client struct, and xml packet. + * \param data aji_client struct + * \param pak XML packet * \return res. */ static int aji_client_connect(void *data, ikspak *pak) @@ -1826,7 +1847,7 @@ /*! * \brief prepares client for connect. - * \param aji_client struct. + * \param client struct. aji_client * \return 1. */ static int aji_client_initialize(struct aji_client *client) @@ -1848,7 +1869,7 @@ /*! * \brief prepares component for connect. - * \param aji_client struct. + * \param client struct. aji_client * \return 1. */ static int aji_component_initialize(struct aji_client *client) @@ -1869,7 +1890,7 @@ /*! * \brief disconnect from jabber server. - * \param aji_client struct. + * \param client struct. aji_client * \return 1. */ int ast_aji_disconnect(struct aji_client *client) @@ -1887,7 +1908,11 @@ /*! * \brief set presence of client. - * \param aji_client struct, user to send it to, and from, level, description. + * \param client struct. + * \param to user send it to + * \param from user it came from + * \param level + * \param desc * \return void. */ static void aji_set_presence(struct aji_client *client, char *to, char *from, int level, char *desc) @@ -1919,7 +1944,9 @@ /*! * \brief turnon console debugging. - * \param fd, number of args, args. + * \param fd + * \param argc Integer. number of args + * \param argv list of arguements * \return RESULT_SUCCESS. */ static int aji_do_debug(int fd, int argc, char *argv[]) @@ -1935,7 +1962,9 @@ /*! * \brief reload jabber module. - * \param fd, number of args, args. + * \param fd + * \param argc Integer. number of args + * \param argv list of arguements * \return RESULT_SUCCESS. */ static int aji_do_reload(int fd, int argc, char *argv[]) @@ -1947,7 +1976,9 @@ /*! * \brief turnoff console debugging. - * \param fd, number of args, args. + * \param fd + * \param argc Integer. number of args + * \param argv list of arguements * \return RESULT_SUCCESS. */ static int aji_no_debug(int fd, int argc, char *argv[]) @@ -1963,7 +1994,9 @@ /*! * \brief show client status. - * \param fd, number of args, args. + * \param fd + * \param argc Integer. number of args + * \param argv list of arguements * \return RESULT_SUCCESS. */ static int aji_show_clients(int fd, int argc, char *argv[]) @@ -1997,7 +2030,9 @@ /*! * \brief send test message for debugging. - * \param fd, number of args, args. + * \param fd + * \param argc Integer. number of args + * \param argv list of arguements * \return RESULT_SUCCESS. */ static int aji_test(int fd, int argc, char *argv[]) @@ -2048,7 +2083,9 @@ /*! * \brief creates aji_client structure. - * \param label, ast_variable, debug, pruneregister, component/client, aji_client to dump into. + * \param label + * \param var struct. + * \param debug * \return 0. */ static int aji_create_client(char *label, struct ast_variable *var, int debug) @@ -2238,7 +2275,8 @@ /*! * \brief creates buddy. - * \param label, buddy to dump it into. + * \param label char. + * \param client struct. buddy to dump it into. * \return 0. */ static int aji_create_buddy(char *label, struct aji_client *client) @@ -2268,11 +2306,7 @@ return 1; } -/*! - * \brief load config file. - * \param void. - * \return 1. - */ +/*!< load config file. \return 1. */ static int aji_load_config(void) { char *cat = NULL; @@ -2311,7 +2345,7 @@ /*! * \brief grab a aji_client structure by label name. - * \param void. + * \param name label name * \return 1. */ struct aji_client *ast_aji_get_client(const char *name) Index: res/res_config_sqlite.c =================================================================== --- res/res_config_sqlite.c (revision 66822) +++ res/res_config_sqlite.c (working copy) @@ -94,7 +94,7 @@ */ /*! - * \file res_sqlite.c + * \file * \brief res_sqlite module. */ @@ -304,6 +304,7 @@ * \param table the table to use * \param file the file to load from the database * \param cfg the struct ast_config object to use when storing variables + * \param withcomments Integer. Flag * \return NULL if an error occurred, cfg otherwise * \see add_cfg_entry() */ Index: contrib/asterisk-ng-doxygen =================================================================== --- contrib/asterisk-ng-doxygen (revision 66822) +++ contrib/asterisk-ng-doxygen (working copy) @@ -1,4 +1,4 @@ -# Doxyfile 1.4.2 +# Doxyfile 1.5.2 # This file describes the settings to be used by the documentation system # doxygen (www.doxygen.org) for a project @@ -14,12 +14,25 @@ # Project related configuration options #--------------------------------------------------------------------------- +# This tag specifies the encoding used for all characters in the config file that +# follow. The default is UTF-8 which is also the encoding used for all text before +# the first occurrence of this tag. Doxygen uses libiconv (or the iconv built into +# libc) for the transcoding. See http://www.gnu.org/software/libiconv for the list of +# possible encodings. + +DOXYFILE_ENCODING = UTF-8 + # The PROJECT_NAME tag is a single word (or a sequence of words surrounded # by quotes) that should identify the project. PROJECT_NAME = "Asterisk - the Open Source PBX" +# The PROJECT_NUMBER tag can be used to enter a project or revision number. +# This could be handy for archiving the generated documentation or +# if some version control system is used. +PROJECT_NUMBER = + # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) # base path where the generated documentation will be put. # If a relative path is entered, it will be relative to the location @@ -40,24 +53,14 @@ # documentation generated by doxygen is written. Doxygen will use this # information to generate all constant output in the proper language. # The default language is English, other supported languages are: -# Brazilian, Catalan, Chinese, Chinese-Traditional, Croatian, Czech, Danish, -# Dutch, Finnish, French, German, Greek, Hungarian, Italian, Japanese, -# Japanese-en (Japanese with English messages), Korean, Korean-en, Norwegian, -# Polish, Portuguese, Romanian, Russian, Serbian, Slovak, Slovene, Spanish, -# Swedish, and Ukrainian. +# Afrikaans, Arabic, Brazilian, Catalan, Chinese, Chinese-Traditional, +# Croatian, Czech, Danish, Dutch, Finnish, French, German, Greek, Hungarian, +# Italian, Japanese, Japanese-en (Japanese with English messages), Korean, +# Korean-en, Lithuanian, Norwegian, Polish, Portuguese, Romanian, Russian, +# Serbian, Slovak, Slovene, Spanish, Swedish, and Ukrainian. OUTPUT_LANGUAGE = English -# This tag can be used to specify the encoding used in the generated output. -# The encoding is not always determined by the language that is chosen, -# but also whether or not the output is meant for Windows or non-Windows users. -# In case there is a difference, setting the USE_WINDOWS_ENCODING tag to YES -# forces the Windows encoding (this is the default for the Windows binary), -# whereas setting the tag to NO uses a Unix-style encoding (the default for -# all platforms other than Windows). - -USE_WINDOWS_ENCODING = NO - # If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will # include brief member descriptions after the members that are listed in # the file and class documentation (similar to JavaDoc). @@ -156,13 +159,6 @@ INHERIT_DOCS = YES -# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC -# tag is set to YES, then doxygen will reuse the documentation of the first -# member in the group (if any) for the other members of the group. By default -# all members of a group must be documented explicitly. - -DISTRIBUTE_GROUP_DOC = NO - # If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce # a new page for each member. If set to NO, the documentation of a member will # be part of the file/class/namespace that contains it. @@ -181,7 +177,7 @@ # will result in a user-defined paragraph with heading "Side Effects:". # You can put \n's in the value part of an alias to insert newlines. -ALIASES += "extref=\xrefitem extref \"ExtRef\" \"External references\"" +ALIASES = "extref=\xrefitem extref \"ExtRef\" \"External references\"" # Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C # sources only. Doxygen will then generate output that is more tailored for C. @@ -190,13 +186,34 @@ OPTIMIZE_OUTPUT_FOR_C = YES -# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java sources -# only. Doxygen will then generate output that is more tailored for Java. +# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java +# sources only. Doxygen will then generate output that is more tailored for Java. # For instance, namespaces will be presented as packages, qualified scopes # will look different, etc. OPTIMIZE_OUTPUT_JAVA = NO +# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want to +# include (a tag file for) the STL sources as input, then you should +# set this tag to YES in order to let doxygen match functions declarations and +# definitions whose arguments contain STL classes (e.g. func(std::string); v.s. +# func(std::string) {}). This also make the inheritance and collaboration +# diagrams that involve STL classes more complete and accurate. + +BUILTIN_STL_SUPPORT = NO + +# If you use Microsoft's C++/CLI language, you should set this option to YES to +# enable parsing support. + +CPP_CLI_SUPPORT = NO + +# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC +# tag is set to YES, then doxygen will reuse the documentation of the first +# member in the group (if any) for the other members of the group. By default +# all members of a group must be documented explicitly. + +DISTRIBUTE_GROUP_DOC = NO + # Set the SUBGROUPING tag to YES (the default) to allow class member groups of # the same type (for instance a group of public functions) to be put as a # subgroup of that type (e.g. under the Public Functions section). Set it to @@ -371,7 +388,7 @@ # If the sources in your project are distributed over multiple directories # then setting the SHOW_DIRECTORIES tag to YES will show the directory hierarchy -# in the documentation. +# in the documentation. The default is NO. SHOW_DIRECTORIES = YES @@ -380,7 +397,7 @@ # version control system). Doxygen will invoke the program by executing (via # popen()) the command , where is the value of # the FILE_VERSION_FILTER tag, and is the name of an input file -# provided by doxygen. Whatever the progam writes to standard output +# provided by doxygen. Whatever the program writes to standard output # is used as the file version. See the manual for examples. FILE_VERSION_FILTER = @@ -446,27 +463,34 @@ # with spaces. INPUT = ./ \ - main \ - include \ + main \ + include \ include/asterisk \ - channels \ - channels/misdn \ - funcs \ - main/stdtime \ - apps \ - cdr \ - codecs \ - formats \ - pbx \ - agi \ - res + channels \ + channels/misdn \ + funcs \ + main/stdtime \ + apps \ + cdr \ + codecs \ + formats \ + pbx \ + agi \ + res +# This tag can be used to specify the character encoding of the source files that +# doxygen parses. Internally doxygen uses the UTF-8 encoding, which is also the default +# input encoding. Doxygen uses libiconv (or the iconv built into libc) for the transcoding. +# See http://www.gnu.org/software/libiconv for the list of possible encodings. + +INPUT_ENCODING = UTF-8 + # If the value of the INPUT tag contains directories, you can use the # FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp # and *.h) to filter out the source-files in the directories. If left # blank the following patterns are tested: # *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx -# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm +# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py FILE_PATTERNS = *.c \ *.h @@ -491,17 +515,26 @@ # If the value of the INPUT tag contains directories, you can use the # EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude -# certain files from those directories. +# certain files from those directories. Note that the wildcards are matched +# against the file with absolute path, so to exclude all test directories +# for example use the pattern */test/* EXCLUDE_PATTERNS = +# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names +# (namespaces, classes, functions, etc.) that should be excluded from the output. +# The symbol name can be a fully qualified name, a word, or if the wildcard * is used, +# a substring. Examples: ANamespace, AClass, AClass::ANamespace, ANamespace::*Test + +EXCLUDE_SYMBOLS = + # The EXAMPLE_PATH tag can be used to specify one or more files or # directories that contain example code fragments that are included (see # the \include command). EXAMPLE_PATH = ./ \ - doc \ - configs + doc \ + configs # If the value of the EXAMPLE_PATH tag contains directories, you can use the # EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp @@ -582,6 +615,21 @@ REFERENCES_RELATION = YES +# If the REFERENCES_LINK_SOURCE tag is set to YES (the default) +# and SOURCE_BROWSER tag is set to YES, then the hyperlinks from +# functions in REFERENCES_RELATION and REFERENCED_BY_RELATION lists will +# link to the source code. Otherwise they will link to the documentstion. + +REFERENCES_LINK_SOURCE = YES + +# If the USE_HTAGS tag is set to YES then the references to source code +# will point to the HTML generated by the htags(1) tool instead of doxygen +# built-in source browser. The htags tool is part of GNU's global source +# tagging system (see http://www.gnu.org/software/global/global.html). You +# will need version 4.8.6 or higher. + +USE_HTAGS = NO + # If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen # will generate a verbatim copy of the header file for each class for # which an include is specified. Set to NO to disable this. @@ -968,7 +1016,7 @@ # If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES # then the macro expansion is limited to the macros specified with the -# PREDEFINED and EXPAND_AS_PREDEFINED tags. +# PREDEFINED and EXPAND_AS_DEFINED tags. EXPAND_ONLY_PREDEF = YES @@ -1071,6 +1119,14 @@ CLASS_DIAGRAMS = NO +# You can define message sequence charts within doxygen comments using the \msc +# command. Doxygen will then run the mscgen tool (see http://www.mcternan.me.uk/mscgen/) to +# produce the chart and insert it in the documentation. The MSCGEN_PATH tag allows you to +# specify the directory where the mscgen tool resides. If left empty the tool is assumed to +# be found in the default search path. + +MSCGEN_PATH = + # If set to YES, the inheritance and collaboration graphs will hide # inheritance and usage relations if the target is undocumented # or is not a class. @@ -1082,8 +1138,7 @@ # toolkit from AT&T and Lucent Bell Labs. The other options in this section # have no effect if this option is set to NO (the default) -#Created by Asterisk Makefile -#HAVE_DOT = NO +HAVE_DOT = NO # If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen # will generate a graph for each documented class showing the direct and @@ -1137,6 +1192,14 @@ CALL_GRAPH = NO +# If the CALLER_GRAPH and HAVE_DOT tags are set to YES then doxygen will +# generate a caller dependency graph for every global function or class method. +# Note that enabling this option will significantly increase the time of a run. +# So in most cases it will be better to enable caller graphs for selected +# functions only using the \callergraph command. + +CALLER_GRAPH = NO + # If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen # will graphical hierarchy of all classes instead of a textual one. @@ -1166,34 +1229,14 @@ DOTFILE_DIRS = -# The MAX_DOT_GRAPH_WIDTH tag can be used to set the maximum allowed width -# (in pixels) of the graphs generated by dot. If a graph becomes larger than -# this value, doxygen will try to truncate the graph, so that it fits within -# the specified constraint. Beware that most browsers cannot cope with very -# large images. +# The MAX_DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of +# nodes that will be shown in the graph. If the number of nodes in a graph +# becomes larger than this value, doxygen will truncate the graph, which is +# visualized by representing a node as a red box. Note that doxygen will always +# show the root nodes and its direct children regardless of this setting. -MAX_DOT_GRAPH_WIDTH = 1024 +DOT_GRAPH_MAX_NODES = 50 -# The MAX_DOT_GRAPH_HEIGHT tag can be used to set the maximum allows height -# (in pixels) of the graphs generated by dot. If a graph becomes larger than -# this value, doxygen will try to truncate the graph, so that it fits within -# the specified constraint. Beware that most browsers cannot cope with very -# large images. - -MAX_DOT_GRAPH_HEIGHT = 1024 - -# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the -# graphs generated by dot. A depth value of 3 means that only nodes reachable -# from the root by following a path via at most 3 edges will be shown. Nodes -# that lay further from the root node will be omitted. Note that setting this -# option to 1 or 2 may greatly reduce the computation time needed for large -# code bases. Also note that a graph may be further truncated if the graph's -# image dimensions are not sufficient to fit the graph (see MAX_DOT_GRAPH_WIDTH -# and MAX_DOT_GRAPH_HEIGHT). If 0 is used for the depth value (the default), -# the graph is not depth-constrained. - -MAX_DOT_GRAPH_DEPTH = 0 - # Set the DOT_TRANSPARENT tag to YES to generate images with a transparent # background. This is disabled by default, which results in a white background. # Warning: Depending on the platform used, enabling this option may lead to