[asterisk-bugs] [JIRA] (ASTERISK-29754) odbc: Fix for Doxygen

[Joshua C. Colp (JIRA)]

     [ https://issues.asterisk.org/jira/browse/ASTERISK-29754?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Work on ASTERISK-29754 started by Alexander Traud.

> odbc: Fix for Doxygen
> ---------------------
>
>                 Key: ASTERISK-29754
>                 URL: https://issues.asterisk.org/jira/browse/ASTERISK-29754
>             Project: Asterisk
>          Issue Type: Bug
>      Security Level: None
>          Components: Documentation, Functions/func_odbc, Resources/res_odbc
>    Affects Versions: 16.22.0, 18.8.0, 19.0.0
>            Reporter: Alexander Traud
>            Assignee: Alexander Traud
>            Severity: Trivial
>
> If all {{WARN_}} are enabled in the file {{doc/asterisk-ng-doxygen.in}}, the following appears in the file {{doxygen.log}}:
> {code}
> funcs/func_odbc.c:299: warning: unable to resolve reference to 'release_dsn' for \ref command
> res/res_config_odbc.c:810: warning: argument 'ap' of command @param is not found in the argument list of destroy_odbc(const char *database, const char *table, const char *keyfield, const char *lookup, const struct ast_variable *fields)
> res/res_config_odbc.c:824: warning: The following parameter of destroy_odbc(const char *database, const char *table, const char *keyfield, const char *lookup, const struct ast_variable *fields) is not documented:
>   parameter 'fields'
> res/res_config_odbc.c:329: warning: argument 'ap' of command @param is not found in the argument list of realtime_multi_odbc(const char *database, const char *table, const struct ast_variable *fields)
> res/res_config_odbc.c:342: warning: The following parameter of realtime_multi_odbc(const char *database, const char *table, const struct ast_variable *fields) is not documented:
>   parameter 'fields'
> res/res_config_odbc.c:158: warning: argument 'ap' of command @param is not found in the argument list of realtime_odbc(const char *database, const char *table, const struct ast_variable *fields)
> res/res_config_odbc.c:170: warning: The following parameter of realtime_odbc(const char *database, const char *table, const struct ast_variable *fields) is not documented:
>   parameter 'fields'
> res/res_config_odbc.c:729: warning: argument 'ap' of command @param is not found in the argument list of store_odbc(const char *database, const char *table, const struct ast_variable *fields)
> res/res_config_odbc.c:741: warning: The following parameter of store_odbc(const char *database, const char *table, const struct ast_variable *fields) is not documented:
>   parameter 'fields'
> res/res_config_odbc.c:662: warning: argument 'ap' of command @param is not found in the argument list of update2_odbc(const char *database, const char *table, const struct ast_variable *lookup_fields, const struct ast_variable *update_fields)
> res/res_config_odbc.c:675: warning: The following parameters of update2_odbc(const char *database, const char *table, const struct ast_variable *lookup_fields, const struct ast_variable *update_fields) are not documented:
>   parameter 'lookup_fields'
>   parameter 'update_fields'
> res/res_config_odbc.c:502: warning: argument 'ap' of command @param is not found in the argument list of update_odbc(const char *database, const char *table, const char *keyfield, const char *lookup, const struct ast_variable *fields)
> res/res_config_odbc.c:516: warning: The following parameter of update_odbc(const char *database, const char *table, const char *keyfield, const char *lookup, const struct ast_variable *fields) is not documented:
>   parameter 'fields'
> res/res_odbc.c:30: warning: unable to resolve reference to 'cdr_odbc' for \ref command
> res/res_odbc.c:984: warning: The following parameters of _ast_odbc_request_obj(const char *name, int check, const char *file, const char *function, int lineno) are not documented:
>   parameter 'file'
>   parameter 'function'
>   parameter 'lineno'
> res/res_odbc.c:478: warning: The following parameter of ast_odbc_execute_sql(struct odbc_obj *obj, SQLHSTMT *stmt, const char *sql) is not documented:
>   parameter 'stmt'
> include/asterisk/res_odbc.h:167: warning: Found unknown command '\parma'
> res/res_odbc.c:463: warning: The following parameter of ast_odbc_prepare(struct odbc_obj *obj, SQLHSTMT *stmt, const char *sql) is not documented:
>   parameter 'sql'
> include/asterisk/res_odbc.h:119: warning: The following parameters of _ast_odbc_request_obj(const char *name, int check, const char *file, const char *function, int lineno) are not documented:
>   parameter 'file'
>   parameter 'function'
>   parameter 'lineno'
> include/asterisk/res_odbc.h:178: warning: The following parameter of ast_odbc_execute_sql(struct odbc_obj *obj, SQLHSTMT *stmt, const char *sql) is not documented:
>   parameter 'stmt'
> include/asterisk/res_odbc.h:191: warning: return value 'A' of ast_odbc_find_table has multiple documentation sections
> include/asterisk/res_odbc.h:191: warning: argument 'database' from the argument list of ast_odbc_find_table has multiple @param documentation sections
> include/asterisk/res_odbc.h:191: warning: argument 'tablename' from the argument list of ast_odbc_find_table has multiple @param documentation sections
> include/asterisk/res_odbc.h:167: warning: Found unknown command '\parma'
> include/asterisk/res_odbc.h:171: warning: The following parameter of ast_odbc_prepare(struct odbc_obj *obj, SQLHSTMT *stmt, const char *sql) is not documented:
>   parameter 'sql'
> {code}



--
This message was sent by Atlassian JIRA
(v6.2#6252)