From ac9f536fb83161b88678575ce6250c1cf5f8b176 Mon Sep 17 00:00:00 2001 From: Diego Escalante Urrelo Date: Tue, 1 Dec 2009 21:05:24 -0500 Subject: docs: ephy-tree-model-sort Also disable incomplete documentation. Bug #503852 --- doc/reference/Makefile.am | 2 - doc/reference/epiphany-docs.sgml | 11 +- doc/reference/epiphany-sections.txt | 250 ++++++------------------------------ doc/reference/epiphany.types | 32 +---- lib/widgets/ephy-tree-model-sort.c | 30 +++++ lib/widgets/ephy-tree-model-sort.h | 10 +- 6 files changed, 75 insertions(+), 260 deletions(-) diff --git a/doc/reference/Makefile.am b/doc/reference/Makefile.am index e0814367e..13232a3ae 100644 --- a/doc/reference/Makefile.am +++ b/doc/reference/Makefile.am @@ -50,8 +50,6 @@ IGNORE_HFILES = \ ephy-stock-icons.h \ ephy-string.h \ ephy-zoom.h \ - ephy-tree-model-node.h \ - ephy-tree-model-sort.h \ downloader-view.h \ ephy-embed-dialog.h \ ephy-embed-event.h \ diff --git a/doc/reference/epiphany-docs.sgml b/doc/reference/epiphany-docs.sgml index 1c69fb7ad..ccddd27d9 100644 --- a/doc/reference/epiphany-docs.sgml +++ b/doc/reference/epiphany-docs.sgml @@ -8,13 +8,6 @@ Epiphany - - - - - - - Widgets @@ -22,14 +15,12 @@ + Incomplete - - - diff --git a/doc/reference/epiphany-sections.txt b/doc/reference/epiphany-sections.txt index 1ffd4958c..9faeac855 100644 --- a/doc/reference/epiphany-sections.txt +++ b/doc/reference/epiphany-sections.txt @@ -1,190 +1,3 @@ -
-ephy-permission-manager -EphyPermissionManager -EphyPermissionInfo -EphyPermission -ephy_permission_info_free - -EPHY_PERMISSION_MANAGER -EPHY_IS_PERMISSION_MANAGER -EPHY_TYPE_PERMISSION_MANAGER -EPHY_TYPE_PERMISSION_INFO -ephy_permission_info_get_type -EPHY_PERMISSION_MANAGER_GET_IFACE -EPHY_IS_PERMISSION_MANAGER_IFACE -EPHY_PERMISSION_MANAGER_IFACE -ephy_permission_manager_get_type -
- -
-ephy-window -EphyWindow -EphyWindow -ephy_window_new -ephy_window_new_with_chrome -ephy_window_get_notebook -ephy_window_get_toolbar -ephy_window_get_statusbar -ephy_window_set_zoom -ephy_window_activate_location -ephy_window_load_url - -EPHY_WINDOW -EPHY_IS_WINDOW -EPHY_TYPE_WINDOW -ephy_window_get_type -EPHY_WINDOW_CLASS -EPHY_IS_WINDOW_CLASS -EPHY_WINDOW_GET_CLASS -
- -
-ephy-embed -EphyEmbed -EphyEmbed - -ephy_embed_get_type -EPHY_EMBED -EPHY_IS_EMBED -EPHY_TYPE_EMBED -
- -
-ephy-embed-single -EphyEmbedSingle -ephy_embed_single_clear_cache -ephy_embed_single_clear_auth_cache -ephy_embed_single_open_window - -EPHY_EMBED_SINGLE -EPHY_IS_EMBED_SINGLE -EPHY_TYPE_EMBED_SINGLE -ephy_embed_single_get_type -EPHY_EMBED_SINGLE_GET_IFACE -EPHY_EMBED_SINGLE_IFACE -EPHY_IS_EMBED_SINGLE_IFACE -
- -
-ephy-embed-persist -EphyEmbedPersist -ephy_embed_persist_set_dest -ephy_embed_persist_set_embed -ephy_embed_persist_set_fc_title -ephy_embed_persist_set_fc_parent -ephy_embed_persist_set_flags -ephy_embed_persist_set_max_size -ephy_embed_persist_set_persist_key -ephy_embed_persist_set_source -ephy_embed_persist_get_dest -ephy_embed_persist_get_embed -ephy_embed_persist_get_fc_title -ephy_embed_persist_get_fc_parent -ephy_embed_persist_get_flags -ephy_embed_persist_get_max_size -ephy_embed_persist_get_persist_key -ephy_embed_persist_get_source -ephy_embed_persist_save -ephy_embed_persist_cancel -ephy_embed_persist_to_string - -EPHY_EMBED_PERSIST -EPHY_IS_EMBED_PERSIST -EPHY_TYPE_EMBED_PERSIST -ephy_embed_persist_get_type -EPHY_EMBED_PERSIST_CLASS -EPHY_IS_EMBED_PERSIST_CLASS -EPHY_EMBED_PERSIST_GET_CLASS -
- -
-ephy-node-db -EphyNodeDb -EphyNodeDb -ephy_node_db_new -ephy_node_db_load_from_file -ephy_node_db_write_to_xml_safe -ephy_node_db_get_name -ephy_node_db_is_immutable -ephy_node_db_set_immutable -ephy_node_db_get_node_from_id - -EPHY_NODE_DB -EPHY_IS_NODE_DB -EPHY_TYPE_NODE_DB -ephy_node_db_get_type -EPHY_NODE_DB_CLASS -EPHY_IS_NODE_DB_CLASS -EPHY_NODE_DB_GET_CLASS -
- -
-ephy-extensions-manager -EphyExtensionsManager -ephy_extensions_manager_load -ephy_extensions_manager_unload - -EPHY_EXTENSIONS_MANAGER -EPHY_IS_EXTENSIONS_MANAGER -EPHY_TYPE_EXTENSIONS_MANAGER -ephy_extensions_manager_get_type -EPHY_EXTENSIONS_MANAGER_CLASS -EPHY_IS_EXTENSIONS_MANAGER_CLASS -EPHY_EXTENSIONS_MANAGER_GET_CLASS -
- - - -
-ephy-session -ephy_session_get_active_window -ephy_session_save -ephy_session_load -ephy_session_close -ephy_session_get_windows -ephy_session_add_window -ephy_session_remove_window - -EPHY_SESSION -EPHY_IS_SESSION -EPHY_TYPE_SESSION -ephy_session_get_type -EPHY_SESSION_CLASS -EPHY_IS_SESSION_CLASS -EPHY_SESSION_GET_CLASS -
- -
-ephy-shell -ephy_shell -EphyNewTabFlags -ephy_shell_new_tab -ephy_shell_get_session -ephy_shell_get_bookmarks -ephy_shell_get_toolbars_model -ephy_shell_get_extensions_manager -ephy_shell_get_bookmarks_editor -ephy_shell_get_history_window -ephy_shell_get_pdm_dialog -ephy_shell_get_prefs_dialog - -EPHY_SHELL -EPHY_IS_SHELL -EPHY_TYPE_SHELL -ephy_shell_get_type -EPHY_SHELL_CLASS -EPHY_IS_SHELL_CLASS -EPHY_SHELL_GET_CLASS -
- -
-ephy-password-manager -EPHY_TYPE_PASSWORD_INFO -ephy_password_info_new - -ephy_password_info_get_type -
-
ephy-location-entry EphyLocationEntry @@ -206,6 +19,28 @@ ephy_location_entry_set_completion ephy_location_entry_set_match_func
+
+ephy-node-view +EphyNodeView +EphyNodeView +EphyNodeViewPriority +EphyNodeViewFlags +ephy_node_view_new +ephy_node_view_add_toggle +ephy_node_view_add_column +ephy_node_view_add_data_column +ephy_node_view_set_sort +ephy_node_view_set_priority +ephy_node_view_remove +ephy_node_view_get_selection +ephy_node_view_select_node +ephy_node_view_enable_drag_source +ephy_node_view_enable_drag_dest +ephy_node_view_edit +ephy_node_view_is_target +ephy_node_view_popup +
+
ephy-search-entry EphySearchEntry @@ -214,14 +49,6 @@ ephy_search_entry_new ephy_search_entry_clear
-
-ephy-zoom-control -EphyZoomControl -EphyZoomControl -ephy_zoom_control_set_zoom_level -ephy_zoom_control_get_zoom_level -
-
ephy-spinner EphySpinner @@ -232,6 +59,15 @@ ephy_spinner_stop ephy_spinner_set_size
+
+ephy-tree-model-sort +EphyTreeModelSort +EphyTreeModelSort +ephy_tree_model_sort_new +ephy_tree_model_sort_set_base_drag_column_id +ephy_tree_model_sort_set_extra_drag_column_id +
+
ephy-zoom-action EphyZoomAction @@ -241,23 +77,9 @@ ephy_zoom_action_get_zoom_level
-ephy-node-view -EphyNodeView -EphyNodeView -EphyNodeViewPriority -EphyNodeViewFlags -ephy_node_view_new -ephy_node_view_add_toggle -ephy_node_view_add_column -ephy_node_view_add_data_column -ephy_node_view_set_sort -ephy_node_view_set_priority -ephy_node_view_remove -ephy_node_view_get_selection -ephy_node_view_select_node -ephy_node_view_enable_drag_source -ephy_node_view_enable_drag_dest -ephy_node_view_edit -ephy_node_view_is_target -ephy_node_view_popup +ephy-zoom-control +EphyZoomControl +EphyZoomControl +ephy_zoom_control_set_zoom_level +ephy_zoom_control_get_zoom_level
diff --git a/doc/reference/epiphany.types b/doc/reference/epiphany.types index a690abf7c..160214bdc 100644 --- a/doc/reference/epiphany.types +++ b/doc/reference/epiphany.types @@ -1,45 +1,17 @@ -#include -#include -#include -#include #include #include #include #include +#include #include #include -ephy_dialog_get_type -ephy_file_chooser_get_type -ephy_node_db_get_type -ephy_node_filter_get_type ephy_node_view_get_type ephy_location_entry_get_type ephy_search_entry_get_type ephy_spinner_get_type +ephy_tree_model_sort_get_type ephy_zoom_action_get_type ephy_zoom_control_get_type -#include -#include -#include -#include -#include -#include -#include -ephy_embed_get_type -downloader_view_get_type -ephy_embed_dialog_get_type -ephy_embed_event_get_type -ephy_embed_persist_get_type -ephy_embed_single_get_type -ephy_permission_manager_get_type - -#include -#include -#include - -ephy_window_get_type -ephy_shell_get_type -ephy_session_get_type diff --git a/lib/widgets/ephy-tree-model-sort.c b/lib/widgets/ephy-tree-model-sort.c index 6f67c6d21..263d7dc30 100644 --- a/lib/widgets/ephy-tree-model-sort.c +++ b/lib/widgets/ephy-tree-model-sort.c @@ -29,6 +29,14 @@ #include "ephy-marshal.h" #include "ephy-debug.h" +/** + * SECTION:ephy-tree-model-sort + * @short_description: A #GtkTreeModelSort wrapper + * + * #EphyTreeModelSort is a simple wrapper for models, it implements some extra + * functionalities like drag and dropping, mostly relevant to Epiphany only. + */ + static void ephy_tree_model_sort_class_init (EphyTreeModelSortClass *klass); static void ephy_tree_model_sort_init (EphyTreeModelSort *ma); static void ephy_tree_model_sort_finalize (GObject *object); @@ -121,6 +129,14 @@ ephy_tree_model_sort_finalize (GObject *object) G_OBJECT_CLASS (parent_class)->finalize (object); } +/** + * ephy_tree_model_sort_new: + * @child_model: model to wrap + * + * Creates a new #EphyTreeModelSort around @child_model. + * + * Returns: a new #EphyTreeModelSort, as a #GtkWidget + **/ GtkTreeModel* ephy_tree_model_sort_new (GtkTreeModel *child_model) { @@ -149,6 +165,13 @@ ephy_tree_model_sort_multi_row_draggable (EggTreeMultiDragSource *drag_source, G return (EPHY_TREE_MODEL_SORT (drag_source)->priv->base_drag_column_id >= 0); } +/** + * ephy_tree_model_sort_set_base_drag_column_id: + * @ms: an #EphyTreeModelSort + * @id: base drag column id + * + * Sets @id as the column for the base drag data + **/ void ephy_tree_model_sort_set_base_drag_column_id (EphyTreeModelSort *ms, int id) @@ -156,6 +179,13 @@ ephy_tree_model_sort_set_base_drag_column_id (EphyTreeModelSort *ms, ms->priv->base_drag_column_id = id; } +/** + * ephy_tree_model_sort_set_extra_drag_column_id: + * @ms: an #EphyTreeModelSort + * @id: extra drag column id + * + * Sets @id as the column for extra drag data. + **/ void ephy_tree_model_sort_set_extra_drag_column_id (EphyTreeModelSort *ms, int id) diff --git a/lib/widgets/ephy-tree-model-sort.h b/lib/widgets/ephy-tree-model-sort.h index a21f31b87..4044704ee 100644 --- a/lib/widgets/ephy-tree-model-sort.h +++ b/lib/widgets/ephy-tree-model-sort.h @@ -36,22 +36,24 @@ G_BEGIN_DECLS #define EPHY_IS_TREE_MODEL_SORT_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), EPHY_TYPE_TREE_MODEL_SORT)) #define EPHY_TREE_MODEL_SORT_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), EPHY_TYPE_TREE_MODEL_SORT, EphyTreeModelSortClass)) +typedef struct _EphyTreeModelSort EphyTreeModelSort; +typedef struct _EphyTreeModelSortClass EphyTreeModelSortClass; typedef struct _EphyTreeModelSortPrivate EphyTreeModelSortPrivate; -typedef struct +struct _EphyTreeModelSort { GtkTreeModelSort parent; /*< private >*/ EphyTreeModelSortPrivate *priv; -} EphyTreeModelSort; +}; -typedef struct +struct _EphyTreeModelSortClass { GtkTreeModelSortClass parent_class; void (*node_from_iter) (EphyTreeModelSort *model, GtkTreeIter *iter, void **node); -} EphyTreeModelSortClass; +}; GType ephy_tree_model_sort_get_type (void); -- cgit v1.2.3