more doxygen warnings

[Miika Komu]

I stumbled across a way to trigger more Doxygen warnings -
if anybody is interested, see below.

Diego

biurrun@passion:~/src/hipl/hipl $ make doxygen 2>&1 | grep -v 'is not documented' | less
doxygen doc/Doxyfile
/home/biurrun/src/hipl/hipl/firewall/helpers.c:105: warning: explicit link request to 'MAX_COMMAND_LINE' could not be resolved
/home/biurrun/src/hipl/hipl/firewall/port_bindings.c:250: warning: parameters of member hip_port_bindings_trigger_reload are not (all) documented
<HIP_FW_CONFIG_FILE_EX>:1: warning: parameters of member HIP_FW_CONFIG_FILE_EX are not (all) documented
<ESP_PACKET_SIZE>:1: warning: parameters of member ESP_PACKET_SIZE are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/dh.c:54: warning: parameters of member hip_insert_dh are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hadb.c:173: warning: parameters of member hip_ha_LHASH_COMP are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hadb.c:140: warning: parameters of member hip_ha_LHASH_HASH are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hadb.c:330: warning: parameters of member hip_hadb_insert_state are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hadb.c:1135: warning: parameters of member hip_hadb_rec_free_LHASH_DOALL are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hiprelay.c:1076: warning: parameters of member hip_relay_handle_relay_to are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hiprelay.c:1284: warning: parameters of member hip_relay_handle_relay_to_in_client are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hiprelay.c:297: warning: parameters of member hip_relht_LHASH_COMP are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hiprelay.c:271: warning: parameters of member hip_relht_LHASH_HASH are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hiprelay.c:421: warning: parameters of member hip_relht_rec_free_expired_LHASH_DOALL are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hiprelay.c:395: warning: parameters of member hip_relht_rec_free_LHASH_DOALL are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hiprelay.c:231: warning: parameters of member hip_relht_rec_free_type_LHASH_DOALL_ARG are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hiprelay.c:687: warning: parameters of member hip_relwl_hit_free_LHASH_DOALL are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hiprelay.c:584: warning: parameters of member hip_relwl_LHASH_COMP are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hiprelay.c:559: warning: parameters of member hip_relwl_LHASH_HASH are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hiprelay.c:1076: warning: parameters of member hip_relay_handle_relay_to are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/hiprelay.c:1284: warning: parameters of member hip_relay_handle_relay_to_in_client are not (all) documented
<hex_digits>:1: warning: parameters of member hex_digits are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/nat.h:53: warning: parameters of member hip_get_nat_mode are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/nat.c:206: warning: parameters of member hip_user_nat_mode are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/nat.h:53: warning: parameters of member hip_get_nat_mode are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/nat.c:206: warning: parameters of member hip_user_nat_mode are not (all) documented
/home/biurrun/src/hipl/hipl/hipd/netdev.c:1318: warning: explicit link request to 'HIP_HIT_DEV' could not be resolved
/home/biurrun/src/hipl/hipl/hipd/netdev.c:1279: warning: explicit link request to 'HIP_HIT_DEV' could not be resolved
/home/biurrun/src/hipl/hipl/hipd/netdev.c:1304: warning: explicit link request to 'HIP_HIT_DEV' could not be resolved
/home/biurrun/src/hipl/hipl/hipd/netdev.c:1318: warning: explicit link request to 'HIP_HIT_DEV' could not be resolved
<BEET_OVERHEAD>:1: warning: parameters of member BEET_OVERHEAD are not (all) documented
<dhgen>:1: warning: parameters of member dhgen are not (all) documented
<dhprime>:1: warning: parameters of member dhprime are not (all) documented
<dhprime_384>:1: warning: parameters of member dhprime_384 are not (all) documented
<dhprime_len>:1: warning: parameters of member dhprime_len are not (all) documented
<dhprime_modp_1536>:1: warning: parameters of member dhprime_modp_1536 are not (all) documented
<dhprime_oakley_1>:1: warning: parameters of member dhprime_oakley_1 are not (all) documented
<debug2syslog_map>:1: warning: parameters of member debug2syslog_map are not (all) documented
/home/biurrun/src/hipl/hipl/lib/core/hostid.c:149: warning: parameters of member hip_rsa_host_id_to_hit are not (all) documented
/home/biurrun/src/hipl/hipl/lib/core/modularization.c:513: warning: parameters of member lmod_get_packet_identifier are not (all) documented
/home/biurrun/src/hipl/hipl/lib/core/modularization.c:685: warning: parameters of member lmod_get_parameter_identifier are not (all) documented
/home/biurrun/src/hipl/hipl/lib/core/modularization.c:513: warning: parameters of member lmod_get_packet_identifier are not (all) documented
/home/biurrun/src/hipl/hipl/lib/core/modularization.c:685: warning: parameters of member lmod_get_parameter_identifier are not (all) documented
<HIP_ARRAY_INIT_REG_FAILURES>:1: warning: parameters of member HIP_ARRAY_INIT_REG_FAILURES are not (all) documented
<HIP_KHI_CONTEXT_ID_INIT>:1: warning: parameters of member HIP_KHI_CONTEXT_ID_INIT are not (all) documented
/home/biurrun/src/hipl/hipl/lib/core/solve.c:108: warning: explicit link request to 'MAX_PUZZLE_SOLUTION_TRIES' could not be resolved
/home/biurrun/src/hipl/hipl/lib/tool/pk.c:236: warning: parameters of member bn2bin_safe are not (all) documented
<A_ALGO_NAMES_NEW>:1: warning: parameters of member A_ALGO_NAMES_NEW are not (all) documented
<A_ALGO_NAMES_OLD>:1: warning: parameters of member A_ALGO_NAMES_OLD are not (all) documented
<E_ALGO_NAMES_NEW>:1: warning: parameters of member E_ALGO_NAMES_NEW are not (all) documented
<E_ALGO_NAMES_OLD>:1: warning: parameters of member E_ALGO_NAMES_OLD are not (all) documented
<hip_hb_update_trigger>:1: warning: parameters of member hip_hb_update_trigger are not (all) documented
/home/biurrun/src/hipl/hipl/modules/update/hipd/update.c:469: warning: parameters of member hip_update_init_state are not (all) documented
<main>:1: warning: parameters of member main are not (all) documented

[Miika Komu (miika-iki)]

Copying here from the mailing list:

> How exactly did you trigger the additional warnings?

Heh, I don't remember :)

I just tried again and the following settings:

EXTRACT_ALL = NO
EXTRACT_LOCAL_METHODS = YES
EXTRACT_ANON_NSPACES = YES
WARN_IF_UNDOCUMENTED = NO

produce the following extra warnings:

firewall/helpers.c:105: warning: explicit link request to 'MAX_COMMAND_LINE' could not be resolved
hipd/netdev.c:1318: warning: explicit link request to 'HIP_HIT_DEV' could not be resolved
hipd/netdev.c:1279: warning: explicit link request to 'HIP_HIT_DEV' could not be resolved
hipd/netdev.c:1304: warning: explicit link request to 'HIP_HIT_DEV' could not be resolved
hipd/netdev.c:1318: warning: explicit link request to 'HIP_HIT_DEV' could not be resolved
lib/core/solve.c:108: warning: explicit link request to 'MAX_PUZZLE_SOLUTION_TRIES' could not be resolved