Move GtkSelection docs inline

At the same time, move private selection API to gtkselectionprivate.h

2 files changed, 1 insertions, 542 deletions

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 9f143317e7..dc9c131e6f 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -60,6 +60,7 @@ gtkscale.sgml
 gtkscalebutton.sgml
 gtkscrollbar.sgml
 gtkscrolledwindow.sgml
+gtkselection.sgml
 gtkseparator.sgml
 gtkseparatormenuitem.sgml
 gtkseparatortoolitem.sgml
diff --git a/docs/reference/gtk/tmpl/gtkselection.sgml b/docs/reference/gtk/tmpl/gtkselection.sgml
deleted file mode 100644
index 4d6542d720..0000000000
--- a/docs/reference/gtk/tmpl/gtkselection.sgml
+++ /dev/null
@@ -1,542 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-Selections
-
-<!-- ##### SECTION Short_Description ##### -->
-Functions for handling inter-process communication via selections
-
-<!-- ##### SECTION Long_Description ##### -->
-
-<para>
-The selection mechanism provides the basis for different types
-of communication between processes. In particular, drag and drop and
-#GtkClipboard work via selections. You will very seldom or
-never need to use most of the functions in this section directly;
-#GtkClipboard provides a nicer interface to the same functionality.
-</para>
-<para>
-Some of the datatypes defined this section are used in
-the #GtkClipboard and drag-and-drop API's as well. The
-#GtkTargetEntry structure and #GtkTargetList objects represent
-lists of data types that are supported when sending or
-receiving data. The #GtkSelectionData object is used to
-store a chunk of data along with the data type and other
-associated information.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-<variablelist>
-
-<varlistentry>
-<term>#GtkWidget</term>
-<listitem><para>Much of the operation of selections happens via
-             signals for #GtkWidget. In particular, if you are
-             using the functions in this section, you may need
-             to pay attention to ::selection_get,
-             ::selection_received,  and :selection_clear_event
-             signals.</para></listitem>
-</varlistentry>
-
-</variablelist>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkTargetEntry ##### -->
-<para>
-A #GtkTargetEntry structure represents a single type of
-data than can be supplied for by a widget for a selection
-or for supplied or received during drag-and-drop. It 
-contains a string representing the drag type, a flags
-field (used only for drag and drop - see #GtkTargetFlags),
-and an application assigned integer ID. The integer
-ID will later be passed as a signal parameter for signals
-like "selection_get". It allows the application to identify
-the target type without extensive string compares.
-</para>
-
-@target: 
-@flags: 
-@info: 
-
-<!-- ##### STRUCT GtkTargetList ##### -->
-<para>
-A #GtkTargetList structure is a reference counted list
-of #GtkTargetPair. It is used to represent the same
-information as a table of #GtkTargetEntry, but in
-an efficient form. This structure should be treated as
-opaque.
-</para>
-
-@list: 
-@ref_count: 
-
-<!-- ##### STRUCT GtkTargetPair ##### -->
-<para>
-Internally used structure in the drag-and-drop and 
-selection handling code.
-</para>
-
-@target: 
-@flags: 
-@info: 
-
-<!-- ##### FUNCTION gtk_target_entry_new ##### -->
-<para>
-
-</para>
-
-@target: 
-@flags: 
-@info: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_target_entry_copy ##### -->
-<para>
-
-</para>
-
-@data: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_target_entry_free ##### -->
-<para>
-
-</para>
-
-@data: 
-
-
-<!-- ##### FUNCTION gtk_target_list_new ##### -->
-<para>
-</para>
-
-@targets: 
-@ntargets: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_target_list_ref ##### -->
-<para>
-</para>
-
-@list: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_target_list_unref ##### -->
-<para>
-</para>
-
-@list: 
-
-
-<!-- ##### FUNCTION gtk_target_list_add ##### -->
-<para>
-</para>
-
-@list: 
-@target: 
-@flags: 
-@info: 
-
-
-<!-- ##### FUNCTION gtk_target_list_add_table ##### -->
-<para>
-</para>
-
-@list: 
-@targets: 
-@ntargets: 
-
-
-<!-- ##### FUNCTION gtk_target_list_add_text_targets ##### -->
-<para>
-
-</para>
-
-@list: 
-@info: 
-
-
-<!-- ##### FUNCTION gtk_target_list_add_image_targets ##### -->
-<para>
-
-</para>
-
-@list: 
-@info: 
-@writable: 
-
-
-<!-- ##### FUNCTION gtk_target_list_add_uri_targets ##### -->
-<para>
-
-</para>
-
-@list: 
-@info: 
-
-
-<!-- ##### FUNCTION gtk_target_list_add_rich_text_targets ##### -->
-<para>
-
-</para>
-
-@list: 
-@info: 
-@deserializable: 
-@buffer: 
-
-
-<!-- ##### FUNCTION gtk_target_list_remove ##### -->
-<para>
-</para>
-
-@list: 
-@target: 
-
-
-<!-- ##### FUNCTION gtk_target_list_find ##### -->
-<para>
-</para>
-
-@list: 
-@target: 
-@info: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_target_table_free ##### -->
-<para>
-
-</para>
-
-@targets: 
-@n_targets: 
-
-
-<!-- ##### FUNCTION gtk_target_table_new_from_list ##### -->
-<para>
-
-</para>
-
-@list: 
-@n_targets: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_owner_set ##### -->
-<para>
-</para>
-
-@widget: 
-@selection: 
-@time_: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_owner_set_for_display ##### -->
-<para>
-
-</para>
-
-@display: 
-@widget: 
-@selection: 
-@time_: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_add_target ##### -->
-<para>
-</para>
-
-@widget: 
-@selection: 
-@target: 
-@info: 
-
-
-<!-- ##### FUNCTION gtk_selection_add_targets ##### -->
-<para>
-</para>
-
-@widget: 
-@selection: 
-@targets: 
-@ntargets: 
-
-
-<!-- ##### FUNCTION gtk_selection_clear_targets ##### -->
-<para>
-
-</para>
-
-@widget: 
-@selection: 
-
-
-<!-- ##### FUNCTION gtk_selection_convert ##### -->
-<para>
-</para>
-
-@widget: 
-@selection: 
-@target: 
-@time_: 
-@Returns: x
-
-
-<!-- ##### FUNCTION gtk_selection_data_set ##### -->
-<para>
-</para>
-
-@selection_data: 
-@type: 
-@format: 
-@data: 
-@length: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_set_text ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@str: 
-@len: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_get_text ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_set_pixbuf ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@pixbuf: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_get_pixbuf ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_set_uris ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@uris: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_get_uris ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_get_targets ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@targets: 
-@n_atoms: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_targets_include_image ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@writable: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_targets_include_text ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_targets_include_uri ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_targets_include_rich_text ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@buffer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_get_selection ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_get_data ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_get_length ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_get_data_type ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_get_display ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_get_format ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_get_target ##### -->
-<para>
-
-</para>
-
-@selection_data: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_targets_include_image ##### -->
-<para>
-
-</para>
-
-@targets: 
-@n_targets: 
-@writable: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_targets_include_text ##### -->
-<para>
-
-</para>
-
-@targets: 
-@n_targets: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_targets_include_uri ##### -->
-<para>
-
-</para>
-
-@targets: 
-@n_targets: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_targets_include_rich_text ##### -->
-<para>
-
-</para>
-
-@targets: 
-@n_targets: 
-@buffer: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_remove_all ##### -->
-<para>
-</para>
-
-@widget: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_copy ##### -->
-<para>
-</para>
-
-@data: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_selection_data_free ##### -->
-<para>
-</para>
-
-@data: 
-
-