Re: gtk-doc confused about symbols

[Stefan Kost <ensonic hora-obscura de>]

hi,

glib has probably copied code from somewhere that uses /** but not
follows the gtk-doc syntax.
I temporily added the locations where the things are found to the output
(see attached file). Should be easy to fix.
Either make them follow the gtk-doc syntax or change the comment into /*.

Stefan

Matthias Clasen schrieb:
> Lately, I notice that gtk-doc throws some odd things into the
> -undocumented.txt file, things that don't look like function names,
> but rather like the beginning of sentences:
>
> Adds
> Adjust
> Cancels
> Get
> ...
>
> How does that happen ?
>
>
> Matthias
> _______________________________________________
> gtk-doc-list mailing list
> gtk-doc-list gnome org
> http://mail.gnome.org/mailman/listinfo/gtk-doc-list
>   

99% symbol docs coverage.
3367 symbols documented.
7 symbols incomplete.
30 not documented.


Adds
	2b: defined at ../../../gio/inotify/inotify-helper.c:107
Adjust
	2b: defined at ../../../gio/fen/fen-data.c:389
Cancels
	2b: defined at ../../../gio/inotify/inotify-helper.c:122
GIOFlags (G_IO_FLAG_MASK, G_IO_FLAG_GET_MASK, G_IO_FLAG_SET_MASK)
	0: defined at ./tmpl/iochannels.sgml:517
GIOFuncs (io_read, io_write, io_seek, io_close, io_create_watch, io_free, io_set_flags, io_get_flags)
	0: defined at ./tmpl/iochannels.sgml:455
GPollFD (fd, fd, events, revents)
	0: defined at ./tmpl/main.sgml:701
GScanner (user_data, max_parse_errors, parse_errors, input_name, qdata, config, symbol_table, input_fd, text, text_end, buffer, scope_id)
	0: defined at ./tmpl/scanner.sgml:26
GScannerConfig (cset_skip_characters, cset_identifier_first, cset_identifier_nth, cpair_comment_single, case_sensitive, skip_comment_multi, skip_comment_single, scan_comment_multi, scan_identifier, scan_identifier_1char, scan_identifier_NULL, scan_symbols, scan_binary, scan_octal, scan_float, scan_hex, scan_hex_dollar, scan_string_sq, scan_string_dq, numbers_2_int, int_2_float, identifier_2_string, char_2_token, symbol_2_token, scope_0_fallback, store_int64, padding_dummy)
	0: defined at ./tmpl/scanner.sgml:69
GSourceFuncs (closure_callback, closure_marshal)
	0: defined at ./tmpl/main.sgml:763
GThreadFunctions (mutex_new, mutex_lock, mutex_trylock, mutex_unlock, mutex_free, cond_new, cond_signal, cond_broadcast, cond_wait, cond_timed_wait, cond_free, private_new, private_get, private_set, thread_create, thread_yield, thread_join, thread_exit, thread_set_priority, thread_self, thread_equal)
	0: defined at ./tmpl/threads.sgml:137
G_HAVE_GNUC_VISIBILITY
	2b: defined at ./tmpl/macros_misc.sgml:356
G_PASTE_ARGS
	2b: defined at ./tmpl/macros_misc.sgml:117
Get
	2b: defined at ../../../gio/fen/fen-kernel.c:479
_g_local_directory_monitor_new
	2b: defined at ../../../gio/glocaldirectorymonitor.c:254
_g_local_file_new
	2b: defined at ../../../gio/glocalfile.c:319
_g_mount_get_for_mount_path
	2b: defined at ../../../gio/gunionvolumemonitor.c:568
_g_unix_volume_monitor_lookup_volume_for_mount_path
	2b: defined at ../../../gio/gunixvolumemonitor.c:289
_g_win32_mount_new
	2b: defined at ../../../gio/gwin32mount.c:127
_g_winhttp_file_new
	2b: defined at ../../../gio/win32/gwinhttpfile.c:85
delete
	2b: defined at ../../../gio/fen/fen-node.c:280
depth
	2b: defined at ../../../gio/fen/fen-node.c:421
fdata_add_event
	2b: defined at ../../../gio/fen/fen-data.c:594
g_dummy_file_new
	2b: defined at ../../../gio/gdummyfile.c:113
g_io_channel_error_quark
	2b: defined at ../../../glib/giochannel.c:2381
g_local_file_input_stream_new
	2b: defined at ../../../gio/glocalfileinputstream.c:121
g_local_file_monitor_new
	2b: defined at ../../../gio/glocalfilemonitor.c:178
g_unix_volume_disconnected
	2b: defined at ../../../gio/gunixvolume.c:163
g_unix_volume_monitor_new
	2b: defined at ../../../gio/gunixvolumemonitor.c:228
g_unix_volume_new
	2b: defined at ../../../gio/gunixvolume.c:113
g_unix_volume_set_mount
	2b: defined at ../../../gio/gunixvolume.c:179
g_unix_volume_unset_mount
	2b: defined at ../../../gio/gunixvolume.c:203
g_winhttp_file_input_stream_new
	2b: defined at ../../../gio/win32/gwinhttpfileinputstream.c:98
g_winhttp_file_output_stream_new
	2b: defined at ../../../gio/win32/gwinhttpfileoutputstream.c:95


gfilterinputstream:Long_Description
gfilteroutputstream:Long_Description
shell:Long_Description
spawn:Long_Description