46275 – libgnomedb 1.0.3 doc won't compile (gtk-doc 1.2 issue ?)

Bug 46275 - libgnomedb 1.0.3 doc won't compile (gtk-doc 1.2 issue ?)

Summary: libgnomedb 1.0.3 doc won't compile (gtk-doc 1.2 issue ?)

Status:	RESOLVED FIXED

Alias:	None

Product:	Gentoo Linux
Classification:	Unclassified
Component:	[OLD] GNOME (show other bugs)
Hardware:	All Linux

Importance:	High normal (vote)
Assignee:	Gentoo Linux Gnome Desktop Team

URL:
Whiteboard:
Keywords:

Depends on:
Blocks:	46268
	Show dependency tree

Reported:	2004-03-30 12:06 UTC by Stephane Loeuillet
Modified:	2004-04-02 00:00 UTC (History)
CC List:	0 users

See Also:
Package list:
Runtime testing required:	---

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.

Description Stephane Loeuillet 2004-03-30 12:06:43 UTC

gtkdoc-scan --module=libgnomedb --source-dir=../../libgnomedb --ignore-headers="config.h acconfig.h gnome-db-intl.h"
touch scan-build.stamp
*** Rebuilding template files ***
cd . && gtkdoc-mktmpl --module=libgnomedb
=============================================================================
WARNING: 50 unused declarations.
  These can be found in libgnomedb-unused.txt.
  They should be added to libgnomedb-sections.txt in the appropriate place.
=============================================================================
touch tmpl-build.stamp
*** Building SGML ***
cd . && \
gtkdoc-mkdb --module=libgnomedb --source-dir=../../libgnomedb --main-sgml-file=libgnomedb-docs.sgml
ERROR parsing comment block file : parameter expected -
 ../../libgnomedb/gnome-db-error-dialog.c:182
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_combo_set_model Param: pos.
WARNING: Parameter described in source code comment block but does not exist -
         Func: gnome_db_combo_set_model Param: col.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_connection_properties_get_connection Param: props.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_connection_properties_get_connection Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_connection_properties_new Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_connection_properties_set_connection Param: props.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_connection_properties_set_connection Param: cnc.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_control_widget_get_objref Param: wid.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_control_widget_get_objref Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_control_widget_new_from_corba Param: control.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_control_widget_new_from_corba Param: uic.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_control_widget_new_from_corba Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_control_widget_construct Param: wid.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_control_widget_construct Param: id.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_control_widget_construct Param: uic.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_control_widget_construct Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_control_widget_get_ui_container Param: wid.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_control_widget_get_ui_container Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_control_construct Param: control.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_control_construct Param: widget.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_control_construct Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_dsn_config_druid_new Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_dsn_config_druid_get_dsn Param: druid.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_dsn_config_druid_get_dsn Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_dsn_config_get_info Param: config.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_dsn_config_get_info Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_dsn_config_new Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_dsn_config_set_info Param: config.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_dsn_config_set_info Param: dsn_info.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_error_dialog_new Param: title.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_error_show Param: errors.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_error_clear Param: error_widget.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_form_get_model Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_form_set_form_type Param: form.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_form_set_form_type Param: type.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_form_get_form_type Param: form.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_form_get_form_type Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_grid_hide_column_titles Param: grid.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_grid_unselect_all Param: grid.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_grid_show_column_titles Param: grid.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_grid_get_model Param: grid.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_grid_get_model Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_grid_select_all Param: grid.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_grid_set_model Param: grid.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_grid_set_model Param: model.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_grid_new_with_model Param: model.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_grid_new_with_model Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_grid_get_selection_mode Param: grid.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_grid_get_selection_mode Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_grid_new Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_list_new_with_model Param: model.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_list_new_with_model Param: col.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_list_new_with_model Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_list_get_model Param: list.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_list_get_model Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_dialog_run Param: dialog.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_dialog_run Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_dialog_get_dsn Param: dialog.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_dialog_get_dsn Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_dialog_new Param: title.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_dialog_new Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_dialog_get_username Param: dialog.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_dialog_get_username Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_dialog_get_password Param: dialog.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_dialog_get_password Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_get_dsn Param: login.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_get_dsn Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_new Param: dsn.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_new Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_get_password Param: login.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_login_get_password Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_window_set_status Param: window.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_window_set_status Param: status.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_window_get_ui_component Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_window_get_contents Param: window.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_window_get_contents Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_window_set_contents Param: window.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_window_set_contents Param: contents.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_window_get_ui_container Param: window.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_window_get_ui_container Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_window_close Param: window.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_window_new Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_window_show Param: window.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_gray_bar_set_text Param: text.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_gray_bar_new Param: text.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_gray_bar_new Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_config_free_component_list Param: list.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_entry_widget Param: max_length.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_entry_widget Param: editable.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_entry_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_vseparator_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_select_file_dialog Param: parent.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_select_file_dialog Param: title.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_select_file_dialog Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_cut_clipboard Param: text.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_show_error Param: format.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_show_error Param: Varargs.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_set_widget_bg_color Param: widget.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_set_widget_bg_color Param: color.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_label_widget Param: text.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_label_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_hseparator_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_set_widget_fg_color Param: widget.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_set_widget_fg_color Param: color.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_paste_clipboard Param: text.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_insert_at_cursor Param: text.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_insert_at_cursor Param: contents.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_insert_at_cursor Param: len.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_hpaned_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_hbox_widget Param: homogenous.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_hbox_widget Param: spacing.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_hbox_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_button_widget Param: label.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_button_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_option_menu_get_selection Param: option_menu.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_option_menu_get_selection Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_copy_clipboard Param: text.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_scrolled_window_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_grid_widget Param: model.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_grid_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_yes_no_dialog Param: parent.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_yes_no_dialog Param: format.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_yes_no_dialog Param: Varargs.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_yes_no_dialog Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_option_menu_add_item Param: option_menu.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_option_menu_add_item Param: label.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_toolbar_widget Param: orientation.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_toolbar_widget Param: style.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_toolbar_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_table_widget Param: rows.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_table_widget Param: cols.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_table_widget Param: homogenous.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_table_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_notebook_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_show_message Param: Varargs.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_get_text Param: text.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_get_text Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_get_char_count Param: text.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_get_char_count Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_vpaned_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_option_menu_set_selection Param: option_menu.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_option_menu_set_selection Param: selection.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_get_line_count Param: text.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_get_line_count Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_popup_menu Param: parent.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_popup_menu Param: ui_info.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_popup_menu Param: user_data.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_popup_menu Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_tree_view_widget Param: model.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_tree_view_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_status_bar_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_radio_button_widget Param: group.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_radio_button_widget Param: label.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_radio_button_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_hbutton_box_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_combo_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_set_text Param: text.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_set_text Param: contents.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_text_set_text Param: len.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_option_menu_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_text_widget Param: contents.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_text_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_vbox_widget Param: homogenous.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_vbox_widget Param: spacing.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_vbox_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_frame_widget Param: title.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_frame_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_button_widget_from_stock Param: stock_id.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_button_widget_from_stock Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_file_entry_widget Param: history_id.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_file_entry_widget Param: title.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_file_entry_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_check_button_widget Param: label.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_check_button_widget Param: Returns.
WARNING: Parameter description missing in source code comment block -
         Func: gnome_db_new_browser_widget Param: Returns.
38% symbol docs coverage (108 symbols documented, 177 not documented)
See libgnomedb-undocumented.txt for a list of missing docs.
The doc coverage percentage doesn't include intro sections.
touch sgml-build.stamp
*** Building HTML ***
test -d ./html || mkdir ./html
cd ./html && gtkdoc-mkhtml libgnomedb ../libgnomedb-docs.sgml
/usr/bin/openjade:../libgnomedb-docs.sgml:148:2:E: cannot find "fdl-appendix.sgml"; tried "../fdl-appendix.sgml", "/usr/share/sgml/fdl-appendix.sgml"
/usr/bin/openjade:/usr/share/sgml/docbook/dsssl-stylesheets-1.77/html/dblink.dsl:203:1:E: XRef LinkEnd to missing ID 'FDL'
make[2]: *** [html-build.stamp] Erreur 1
make[2]: Leaving directory `/usr/portage/tmp/portage/libgnomedb-1.0.3/work/libgnomedb-1.0.3/doc/C'
make[1]: *** [all-recursive] Erreur 1
make[1]: Leaving directory `/usr/portage/tmp/portage/libgnomedb-1.0.3/work/libgnomedb-1.0.3/doc'
make: *** [all-recursive] Erreur 1
 
!!! ERROR: gnome-extra/libgnomedb-1.0.3 failed.
!!! Function gnome2_src_compile, Line 39, Exitcode 2
!!! compile failure


Reproducible: Always
Steps to Reproduce:
1. emerge libgnomedb
2.
3.

Comment 1 foser (RETIRED) gentoo-dev

2004-03-30 12:16:34 UTC

http://bugzilla.gnome.org/show_bug.cgi?id=138197

upstream bugreport

Comment 2 Leonardo Boshell (RETIRED) gentoo-dev

2004-04-02 00:00:02 UTC

A patch that fixes this problem is now in the tree.
Thanks.