Hey folks, just ran a build of make doxygen and found 29 warnings for missing doxygen descriptions.
I'm pretty sure that's not all there is, but it's a start! If you have a clue about the function/method/class/parameter in question please fix the offending comments, patches from are non-committers are much encouraged and warmly welcomed. So long, and thanks for all the <>< i -- Igor Galić Tel: +43 (0) 664 886 22 883 Mail: i.ga...@brainsware.org URL: http://brainsware.org/
trafficserver/iocore/cache/CacheDir.cc:164: warning: documented function `int OpenDirEntry::wait' was not declared or defined. <ink_res_mkquery>:1: warning: The following parameters of ink_res_mkquery(ink_res_state statp, int op, const char *dname, int _class, int type, const u_char *data, int datalen, const u_char *newrr_in, u_char *buf, int buflen) are not documented: parameter 'statp' parameter '_class' trafficserver/proxy/api/ts/ts.h:1756: warning: argument 'retrieved_str' of command @param is not found in the argument list of TSMimeHdrFieldAppend(TSMBuffer bufp, TSMLoc hdr, TSMLoc field) trafficserver/proxy/api/ts/ts.h:1756: warning: The following parameters of TSMimeHdrFieldAppend(TSMBuffer bufp, TSMLoc hdr, TSMLoc field) are not documented: parameter 'field' trafficserver/proxy/api/ts/ts.h:2363: warning: argument 'ip' of command @param is not found in the argument list of TSNetVConnRemoteIPGet(TSVConn vc) trafficserver/proxy/api/ts/ts.h:2519: warning: argument 'new' of command @param is not found in the argument list of TSIOBufferSizedCreate(TSIOBufferSizeIndex index) trafficserver/proxy/hdrs/MIME.cc:1165: warning: Found unknown command `\src_base' trafficserver/proxy/api/ts/ts.h:2304: warning: argument 'log_ip' of command @param is not found in the argument list of TSHttpConnect(struct sockaddr const *addr) trafficserver/proxy/api/ts/ts.h:2304: warning: argument 'log_port' of command @param is not found in the argument list of TSHttpConnect(struct sockaddr const *addr) trafficserver/proxy/api/ts/ts.h:2304: warning: argument 'vc' of command @param is not found in the argument list of TSHttpConnect(struct sockaddr const *addr) trafficserver/proxy/api/ts/ts.h:2304: warning: The following parameters of TSHttpConnect(struct sockaddr const *addr) are not documented: parameter 'addr' trafficserver/proxy/api/ts/ts.h:2519: warning: argument 'new' of command @param is not found in the argument list of TSIOBufferSizedCreate(TSIOBufferSizeIndex index) trafficserver/proxy/api/ts/ts.h:1756: warning: argument 'retrieved_str' of command @param is not found in the argument list of TSMimeHdrFieldAppend(TSMBuffer bufp, TSMLoc hdr, TSMLoc field) trafficserver/proxy/api/ts/ts.h:1756: warning: The following parameters of TSMimeHdrFieldAppend(TSMBuffer bufp, TSMLoc hdr, TSMLoc field) are not documented: parameter 'field' trafficserver/proxy/api/ts/ts.h:2363: warning: argument 'ip' of command @param is not found in the argument list of TSNetVConnRemoteIPGet(TSVConn vc) trafficserver/iocore/eventsystem/I_EventProcessor.h:120: warning: argument 'atimeout_at' of command @param is not found in the argument list of EventProcessor::schedule_imm(Continuation *c, EventType event_type=ET_CALL, int callback_event=EVENT_IMMEDIATE, void *cookie=NULL) trafficserver/iocore/eventsystem/I_EventProcessor.h:120: warning: argument 'ethread' of command @param is not found in the argument list of EventProcessor::schedule_imm(Continuation *c, EventType event_type=ET_CALL, int callback_event=EVENT_IMMEDIATE, void *cookie=NULL) trafficserver/iocore/eventsystem/I_EventProcessor.h:120: warning: The following parameters of EventProcessor::schedule_imm(Continuation *c, EventType event_type=ET_CALL, int callback_event=EVENT_IMMEDIATE, void *cookie=NULL) are not documented: parameter 'event_type' trafficserver/iocore/eventsystem/I_EventProcessor.h:95: warning: The following parameters of EventProcessor::spawn_thread(Continuation *cont, const char *thr_name, ink_sem *sem=NULL) are not documented: parameter 'thr_name' trafficserver/iocore/net/I_NetProcessor.h:91: warning: The following parameters of NetProcessor::accept(Continuation *cont, int port, int domain=AF_INET, int accept_threads=-1, bool frequent_accept=false, unsigned int accept_ip=INADDR_ANY, char *accept_ip_str=NULL, bool callback_on_open=false, SOCKET listen_socket_in=NO_FD, int accept_pool_size=ACCEPTEX_POOL_SIZE, bool accept_only=false, sockaddr *bound_sockaddr=0, int *bound_sockaddr_size=0, int recv_bufsize=0, int send_bufsize=0, uint32_t sockopt_flag=0, EventType etype=ET_NET) are not documented: parameter 'accept_threads' trafficserver/iocore/net/I_NetProcessor.h:214: warning: argument 'options' of command @param is not found in the argument list of NetProcessor::connect_s(Continuation *cont, unsigned int ip, int port, int timeout=NET_CONNECT_TIMEOUT, NetVCOptions *opts=NULL) trafficserver/iocore/net/I_NetProcessor.h:214: warning: The following parameters of NetProcessor::connect_s(Continuation *cont, unsigned int ip, int port, int timeout=NET_CONNECT_TIMEOUT, NetVCOptions *opts=NULL) are not documented: parameter 'opts' trafficserver/iocore/net/I_NetProcessor.h:147: warning: argument 'port' of command @param is not found in the argument list of NetProcessor::main_accept(Continuation *cont, SOCKET listen_socket_in, sockaddr *bound_sockaddr=NULL, int *bound_sockaddr_size=NULL, bool accept_only=false, bool localhost_only=false, AcceptOptions const &opt=DEFAULT_ACCEPT_OPTIONS) trafficserver/iocore/net/I_NetProcessor.h:147: warning: argument 'recv_bufsize' of command @param is not found in the argument list of NetProcessor::main_accept(Continuation *cont, SOCKET listen_socket_in, sockaddr *bound_sockaddr=NULL, int *bound_sockaddr_size=NULL, bool accept_only=false, bool localhost_only=false, AcceptOptions const &opt=DEFAULT_ACCEPT_OPTIONS) trafficserver/iocore/net/I_NetProcessor.h:147: warning: argument 'send_bufsize' of command @param is not found in the argument list of NetProcessor::main_accept(Continuation *cont, SOCKET listen_socket_in, sockaddr *bound_sockaddr=NULL, int *bound_sockaddr_size=NULL, bool accept_only=false, bool localhost_only=false, AcceptOptions const &opt=DEFAULT_ACCEPT_OPTIONS) trafficserver/iocore/net/I_NetProcessor.h:147: warning: argument 'sockopt_flag' of command @param is not found in the argument list of NetProcessor::main_accept(Continuation *cont, SOCKET listen_socket_in, sockaddr *bound_sockaddr=NULL, int *bound_sockaddr_size=NULL, bool accept_only=false, bool localhost_only=false, AcceptOptions const &opt=DEFAULT_ACCEPT_OPTIONS) trafficserver/iocore/net/I_NetProcessor.h:147: warning: argument 'etype' of command @param is not found in the argument list of NetProcessor::main_accept(Continuation *cont, SOCKET listen_socket_in, sockaddr *bound_sockaddr=NULL, int *bound_sockaddr_size=NULL, bool accept_only=false, bool localhost_only=false, AcceptOptions const &opt=DEFAULT_ACCEPT_OPTIONS) trafficserver/iocore/net/I_NetProcessor.h:147: warning: argument 'callback_on_open' of command @param is not found in the argument list of NetProcessor::main_accept(Continuation *cont, SOCKET listen_socket_in, sockaddr *bound_sockaddr=NULL, int *bound_sockaddr_size=NULL, bool accept_only=false, bool localhost_only=false, AcceptOptions const &opt=DEFAULT_ACCEPT_OPTIONS) trafficserver/iocore/net/I_NetProcessor.h:147: warning: The following parameters of NetProcessor::main_accept(Continuation *cont, SOCKET listen_socket_in, sockaddr *bound_sockaddr=NULL, int *bound_sockaddr_size=NULL, bool accept_only=false, bool localhost_only=false, AcceptOptions const &opt=DEFAULT_ACCEPT_OPTIONS) are not documented: parameter 'localhost_only' parameter 'opt'
