]> Pileus Git - ~andy/gtk/commitdiff
bracket in #ifdef GTK_ENABLE_BROKEN.
authorHavoc Pennington <hp@pobox.com>
Wed, 31 Jan 2001 03:51:14 +0000 (03:51 +0000)
committerHavoc Pennington <hp@src.gnome.org>
Wed, 31 Jan 2001 03:51:14 +0000 (03:51 +0000)
2001-01-30  Havoc Pennington  <hp@pobox.com>

* gtk/gtktreeitem.h, gtk/gtktree.h, gtk/gtktext.h: bracket in
#ifdef GTK_ENABLE_BROKEN.

* gtk/gtktreeitem.c, gtk/gtktree.c, gtk/gtktext.c: #define
GTK_ENABLE_BROKEN just before including the broken headers.

* gtk/gtktypeutils.c: #define GTK_ENABLE_BROKEN, so we can get the
deprecated types registered.

* gtk/testgtk.c, gtk/testselection.c: #define GTK_ENABLE_BROKEN,
we have to test the broken stuff.

        * docs/Changes-2.0.txt: explain GTK_ENABLE_BROKEN

2001-01-30  Havoc Pennington  <hp@pobox.com>

        Also committed a bunch of automatic changes made by gtk-doc,
after reviewing for correctness.

* gtk/tmpl/gtktext.sgml: add warning about deprecation and note
about what to use instead

* gtk/tmpl/gtktree.sgml: ditto

* gtk/Makefile.am (scan): pass --deprecated-guards option to
gtk-doc; requires new version of gtk-doc from CVS

* gtk/gtk-docs.sgml: move GtkText to the deprecated section
instead of the GtkTextView section. Oops.

43 files changed:
ChangeLog
ChangeLog.pre-2-0
ChangeLog.pre-2-10
ChangeLog.pre-2-2
ChangeLog.pre-2-4
ChangeLog.pre-2-6
ChangeLog.pre-2-8
docs/Changes-2.0.txt
docs/reference/ChangeLog
docs/reference/gdk-pixbuf/tmpl/animation.sgml
docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-unused.sgml
docs/reference/gdk/tmpl/colors.sgml
docs/reference/gdk/tmpl/drawing.sgml
docs/reference/gdk/tmpl/event_structs.sgml
docs/reference/gdk/tmpl/events.sgml
docs/reference/gdk/tmpl/gdk-unused.sgml
docs/reference/gdk/tmpl/keys.sgml
docs/reference/gdk/tmpl/regions.sgml
docs/reference/gdk/tmpl/windows.sgml
docs/reference/gtk/Makefile.am
docs/reference/gtk/gtk-docs.sgml
docs/reference/gtk/tmpl/gtk-unused.sgml
docs/reference/gtk/tmpl/gtkprogressbar.sgml
docs/reference/gtk/tmpl/gtktext.sgml
docs/reference/gtk/tmpl/gtktexttag.sgml
docs/reference/gtk/tmpl/gtktextview.sgml
docs/reference/gtk/tmpl/gtktree.sgml
docs/reference/gtk/tmpl/gtktreestore.sgml
docs/reference/gtk/tmpl/gtktreeview.sgml
docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
docs/reference/gtk/tmpl/gtkwindow.sgml
gtk/gtktext.c
gtk/gtktext.h
gtk/gtktextview.c
gtk/gtktree.c
gtk/gtktree.h
gtk/gtktreeitem.c
gtk/gtktreeitem.h
gtk/gtktypeutils.c
gtk/testgtk.c
gtk/testselection.c
tests/testgtk.c
tests/testselection.c

index 6f1186075149d641d3195c3cc47d3983fc789c8d..65430b8783417a563b0fcc53dd40da2a1bf80687 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,19 @@
+2001-01-30  Havoc Pennington  <hp@pobox.com>
+
+       * gtk/gtktreeitem.h, gtk/gtktree.h, gtk/gtktext.h: bracket in 
+       #ifdef GTK_ENABLE_BROKEN.
+
+       * gtk/gtktreeitem.c, gtk/gtktree.c, gtk/gtktext.c: #define
+       GTK_ENABLE_BROKEN just before including the broken headers.
+       
+       * gtk/gtktypeutils.c: #define GTK_ENABLE_BROKEN, so we can get the
+       deprecated types registered.
+
+       * gtk/testgtk.c, gtk/testselection.c: #define GTK_ENABLE_BROKEN,
+       we have to test the broken stuff.
+
+        * docs/Changes-2.0.txt: explain GTK_ENABLE_BROKEN
+       
 2001-01-30  Havoc Pennington  <hp@redhat.com>
 
        * gtk/gtkliststore.c (gtk_list_store_insert_before): fix bug in
index 6f1186075149d641d3195c3cc47d3983fc789c8d..65430b8783417a563b0fcc53dd40da2a1bf80687 100644 (file)
@@ -1,3 +1,19 @@
+2001-01-30  Havoc Pennington  <hp@pobox.com>
+
+       * gtk/gtktreeitem.h, gtk/gtktree.h, gtk/gtktext.h: bracket in 
+       #ifdef GTK_ENABLE_BROKEN.
+
+       * gtk/gtktreeitem.c, gtk/gtktree.c, gtk/gtktext.c: #define
+       GTK_ENABLE_BROKEN just before including the broken headers.
+       
+       * gtk/gtktypeutils.c: #define GTK_ENABLE_BROKEN, so we can get the
+       deprecated types registered.
+
+       * gtk/testgtk.c, gtk/testselection.c: #define GTK_ENABLE_BROKEN,
+       we have to test the broken stuff.
+
+        * docs/Changes-2.0.txt: explain GTK_ENABLE_BROKEN
+       
 2001-01-30  Havoc Pennington  <hp@redhat.com>
 
        * gtk/gtkliststore.c (gtk_list_store_insert_before): fix bug in
index 6f1186075149d641d3195c3cc47d3983fc789c8d..65430b8783417a563b0fcc53dd40da2a1bf80687 100644 (file)
@@ -1,3 +1,19 @@
+2001-01-30  Havoc Pennington  <hp@pobox.com>
+
+       * gtk/gtktreeitem.h, gtk/gtktree.h, gtk/gtktext.h: bracket in 
+       #ifdef GTK_ENABLE_BROKEN.
+
+       * gtk/gtktreeitem.c, gtk/gtktree.c, gtk/gtktext.c: #define
+       GTK_ENABLE_BROKEN just before including the broken headers.
+       
+       * gtk/gtktypeutils.c: #define GTK_ENABLE_BROKEN, so we can get the
+       deprecated types registered.
+
+       * gtk/testgtk.c, gtk/testselection.c: #define GTK_ENABLE_BROKEN,
+       we have to test the broken stuff.
+
+        * docs/Changes-2.0.txt: explain GTK_ENABLE_BROKEN
+       
 2001-01-30  Havoc Pennington  <hp@redhat.com>
 
        * gtk/gtkliststore.c (gtk_list_store_insert_before): fix bug in
index 6f1186075149d641d3195c3cc47d3983fc789c8d..65430b8783417a563b0fcc53dd40da2a1bf80687 100644 (file)
@@ -1,3 +1,19 @@
+2001-01-30  Havoc Pennington  <hp@pobox.com>
+
+       * gtk/gtktreeitem.h, gtk/gtktree.h, gtk/gtktext.h: bracket in 
+       #ifdef GTK_ENABLE_BROKEN.
+
+       * gtk/gtktreeitem.c, gtk/gtktree.c, gtk/gtktext.c: #define
+       GTK_ENABLE_BROKEN just before including the broken headers.
+       
+       * gtk/gtktypeutils.c: #define GTK_ENABLE_BROKEN, so we can get the
+       deprecated types registered.
+
+       * gtk/testgtk.c, gtk/testselection.c: #define GTK_ENABLE_BROKEN,
+       we have to test the broken stuff.
+
+        * docs/Changes-2.0.txt: explain GTK_ENABLE_BROKEN
+       
 2001-01-30  Havoc Pennington  <hp@redhat.com>
 
        * gtk/gtkliststore.c (gtk_list_store_insert_before): fix bug in
index 6f1186075149d641d3195c3cc47d3983fc789c8d..65430b8783417a563b0fcc53dd40da2a1bf80687 100644 (file)
@@ -1,3 +1,19 @@
+2001-01-30  Havoc Pennington  <hp@pobox.com>
+
+       * gtk/gtktreeitem.h, gtk/gtktree.h, gtk/gtktext.h: bracket in 
+       #ifdef GTK_ENABLE_BROKEN.
+
+       * gtk/gtktreeitem.c, gtk/gtktree.c, gtk/gtktext.c: #define
+       GTK_ENABLE_BROKEN just before including the broken headers.
+       
+       * gtk/gtktypeutils.c: #define GTK_ENABLE_BROKEN, so we can get the
+       deprecated types registered.
+
+       * gtk/testgtk.c, gtk/testselection.c: #define GTK_ENABLE_BROKEN,
+       we have to test the broken stuff.
+
+        * docs/Changes-2.0.txt: explain GTK_ENABLE_BROKEN
+       
 2001-01-30  Havoc Pennington  <hp@redhat.com>
 
        * gtk/gtkliststore.c (gtk_list_store_insert_before): fix bug in
index 6f1186075149d641d3195c3cc47d3983fc789c8d..65430b8783417a563b0fcc53dd40da2a1bf80687 100644 (file)
@@ -1,3 +1,19 @@
+2001-01-30  Havoc Pennington  <hp@pobox.com>
+
+       * gtk/gtktreeitem.h, gtk/gtktree.h, gtk/gtktext.h: bracket in 
+       #ifdef GTK_ENABLE_BROKEN.
+
+       * gtk/gtktreeitem.c, gtk/gtktree.c, gtk/gtktext.c: #define
+       GTK_ENABLE_BROKEN just before including the broken headers.
+       
+       * gtk/gtktypeutils.c: #define GTK_ENABLE_BROKEN, so we can get the
+       deprecated types registered.
+
+       * gtk/testgtk.c, gtk/testselection.c: #define GTK_ENABLE_BROKEN,
+       we have to test the broken stuff.
+
+        * docs/Changes-2.0.txt: explain GTK_ENABLE_BROKEN
+       
 2001-01-30  Havoc Pennington  <hp@redhat.com>
 
        * gtk/gtkliststore.c (gtk_list_store_insert_before): fix bug in
index 6f1186075149d641d3195c3cc47d3983fc789c8d..65430b8783417a563b0fcc53dd40da2a1bf80687 100644 (file)
@@ -1,3 +1,19 @@
+2001-01-30  Havoc Pennington  <hp@pobox.com>
+
+       * gtk/gtktreeitem.h, gtk/gtktree.h, gtk/gtktext.h: bracket in 
+       #ifdef GTK_ENABLE_BROKEN.
+
+       * gtk/gtktreeitem.c, gtk/gtktree.c, gtk/gtktext.c: #define
+       GTK_ENABLE_BROKEN just before including the broken headers.
+       
+       * gtk/gtktypeutils.c: #define GTK_ENABLE_BROKEN, so we can get the
+       deprecated types registered.
+
+       * gtk/testgtk.c, gtk/testselection.c: #define GTK_ENABLE_BROKEN,
+       we have to test the broken stuff.
+
+        * docs/Changes-2.0.txt: explain GTK_ENABLE_BROKEN
+       
 2001-01-30  Havoc Pennington  <hp@redhat.com>
 
        * gtk/gtkliststore.c (gtk_list_store_insert_before): fix bug in
index fa10e234046af8bb42338a8a8b06dca2654fc292..fc0e8512d49946f7fa37f558571c38bb3d2f51a6 100644 (file)
@@ -287,3 +287,9 @@ Incompatible Changes from GTK+-1.2 to GTK+-2.0:
   implementations. The draw method was rarely called in practice
   anyway.
  
+- GtkText and GtkTree are buggy and broken. We don't recommend using
+  them, and changing old code to avoid them is a good idea. The
+  recommended alternatives are GtkTextView and GtkTreeView.  The
+  broken widgets are not declared in the headers by default; to use
+  them, define the symbol GTK_ENABLE_BROKEN during compilation.  In
+  some future release, these widgets will be removed from GTK+.
index e25de006cbaa82b002d874bd27f660e30f56f63d..89b57955c725c46591eead9c372c03148652fda5 100644 (file)
@@ -1,3 +1,19 @@
+2001-01-30  Havoc Pennington  <hp@pobox.com>
+
+        Also committed a bunch of automatic changes made by gtk-doc, 
+       after reviewing for correctness.
+       
+       * gtk/tmpl/gtktext.sgml: add warning about deprecation and note
+       about what to use instead
+
+       * gtk/tmpl/gtktree.sgml: ditto
+
+       * gtk/Makefile.am (scan): pass --deprecated-guards option to
+       gtk-doc
+
+       * gtk/gtk-docs.sgml: move GtkText to the deprecated section 
+       instead of the GtkTextView section. Oops.
+
 Tue Jan 30 16:01:54 2001  Owen Taylor  <otaylor@redhat.com>
 
        * gtk/tmpl/gtkclist.sgml: Added note explaining how
index 4df2090cb6ab5464da184fc346260db9e76e5ab1..8253cb491d72ae6bf7e3d3e01715f8b83f154f22 100644 (file)
@@ -98,27 +98,6 @@ animation
 @Returns: 
 
 
-<!-- ##### FUNCTION gdk_pixbuf_frame_copy ##### -->
-<para>
-
-</para>
-
-@src: 
-@Returns: 
-<!-- # Unused Parameters # -->
-@frame: 
-
-
-<!-- ##### FUNCTION gdk_pixbuf_frame_free ##### -->
-<para>
-
-</para>
-
-@frame: 
-<!-- # Unused Parameters # -->
-@src: 
-
-
 <!-- ##### FUNCTION gdk_pixbuf_frame_get_pixbuf ##### -->
 <para>
 
index 0d6a1219d5221b5f5bcb622e614c2576aff1b832..ff0572856966c21ac65cd4279511725cf02cd6fc 100644 (file)
@@ -19,6 +19,15 @@ Drawables to Pixbufs
 @pixbuf: The pixbuf that is losing its last reference.
 @data: User closure data.
 
+<!-- ##### FUNCTION gdk_pixbuf_frame_copy ##### -->
+<para>
+
+</para>
+
+@src: 
+@Returns: 
+@frame: 
+
 <!-- ##### SECTION ./tmpl/rendering.sgml:See_Also ##### -->
   <para>
     GdkRGB
@@ -705,6 +714,14 @@ Getting parts of a drawable's image data into a pixbuf.
 Xlib Rendering
 
 
+<!-- ##### FUNCTION gdk_pixbuf_frame_free ##### -->
+<para>
+
+</para>
+
+@frame: 
+@src: 
+
 <!-- ##### SECTION ./tmpl/gdk-pixbuf-io.sgml:Title ##### -->
 gdk-pixbuf-io
 
index 3f47ec8260965930a1c6518d9243ead4c18e2667..e307e1a4d20ed56b3cf773ddf46cfb67d64f4f48 100644 (file)
@@ -121,16 +121,6 @@ Colormaps and Colors
 @ncolors: 
 
 
-<!-- ##### FUNCTION gdk_colormap_query_color ##### -->
-<para>
-
-</para>
-
-@colormap: 
-@pixel: 
-@result: 
-
-
 <!-- ##### FUNCTION gdk_colormap_get_visual ##### -->
 <para>
 
index f0270aea20aa36c1df43dbec9c95cce5e6677bd1..55adf506c7be3d6a34911d68b79b5b268e131e8d 100644 (file)
@@ -111,24 +111,6 @@ Drawing Primitives
 @height: 
 
 
-<!-- ##### FUNCTION gdk_drawable_get_clip_region ##### -->
-<para>
-
-</para>
-
-@drawable: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_drawable_get_visible_region ##### -->
-<para>
-
-</para>
-
-@drawable: 
-@Returns: 
-
-
 <!-- ##### FUNCTION gdk_draw_point ##### -->
 <para>
 
index a6d41967cb9dbf6fa87704e982f051ea62ad8b6a..a5741da40a482856605c66176f2949db01d415b4 100644 (file)
@@ -95,8 +95,6 @@ example, it is these characters which should be added to the input buffer.
 When using <link linkend="gdk-Input-Methods"> Input Methods</link> to support
 internationalized text input, the composed characters appear here after the
 pre-editing has been completed.
-@hardware_keycode: 
-@group: 
 
 <!-- ##### STRUCT GdkEventButton ##### -->
 <para>
index 117f6f8ce43dc6e904db2d277099f20b437f8fd6..1b3ba85e6a99b98291f448ad23103fc2cf31c0fc 100644 (file)
@@ -226,16 +226,6 @@ Gets the timestamp from a #GdkEvent.
 no timestamp.
 
 
-<!-- ##### FUNCTION gdk_event_get_state ##### -->
-<para>
-
-</para>
-
-@event: 
-@state: 
-@Returns: 
-
-
 <!-- ##### FUNCTION gdk_event_get_axis ##### -->
 <para>
 
index 1a71c10b423770e99df39bea79989316014eefeb..fb52e4a9e9d2dac43c9a96df33c45446aef0c259 100644 (file)
@@ -36,6 +36,32 @@ Retrieves the motion history for a given device/window pair.
 </para>
 
 
+<!-- ##### FUNCTION gdk_keymap_translate_keyboard_state ##### -->
+<para>
+
+</para>
+
+@keymap: 
+@hardware_keycode: 
+@state: 
+@group: 
+@keyval: 
+@effective_group: 
+@level: 
+@unused_modifiers: 
+@Returns: 
+
+<!-- ##### FUNCTION gdk_keymap_get_entries_for_keyval ##### -->
+<para>
+
+</para>
+
+@keymap: 
+@keyval: 
+@keys: 
+@n_keys: 
+@Returns: 
+
 <!-- ##### SECTION ./tmpl/gdkregion.sgml:Long_Description ##### -->
 <para>
 
@@ -90,10 +116,65 @@ This is all pixels in either of @source1 or @source2.
 @source2: a #GdkRegion.
 @Returns: the union of @source1 and @source2.
 
+<!-- ##### FUNCTION gdk_drawable_get_visible_region ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@Returns: 
+
+<!-- ##### FUNCTION gdk_colormap_query_color ##### -->
+<para>
+
+</para>
+
+@colormap: 
+@pixel: 
+@result: 
+
+<!-- ##### FUNCTION gdk_event_get_state ##### -->
+<para>
+
+</para>
+
+@event: 
+@state: 
+@Returns: 
+
 <!-- ##### SECTION ./tmpl/gdkregion.sgml:Short_Description ##### -->
 
 
 
+<!-- ##### FUNCTION gdk_window_get_decorations ##### -->
+<para>
+
+</para>
+
+@window: 
+@decorations: 
+@Returns: 
+
+<!-- ##### FUNCTION gdk_keymap_get_entries_for_keycode ##### -->
+<para>
+
+</para>
+
+@keymap: 
+@hardware_keycode: 
+@keys: 
+@keyvals: 
+@n_entries: 
+@Returns: 
+
+<!-- ##### FUNCTION gdk_drawable_get_clip_region ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@Returns: 
+
 <!-- ##### FUNCTION gdk_input_set_key ##### -->
 <para>
 Sets the key event generated when a macro button is pressed.
@@ -116,6 +197,13 @@ configuration information.
           is internal data of GTK+ and should not be modified 
           or freed.
 
+<!-- ##### STRUCT GdkKeymap ##### -->
+<para>
+
+</para>
+
+@parent_instance: 
+
 <!-- ##### SECTION ./tmpl/input_methods.sgml.sgml:See_Also ##### -->
 <para>
 
@@ -179,6 +267,24 @@ onto the predefined valuator types that GTK+ understands.
 @axes: an array of GdkAxisUse. This length of this array
        must match the number of axes for the device.
 
+<!-- ##### STRUCT GdkSpan ##### -->
+<para>
+
+</para>
+
+@x: 
+@y: 
+@width: 
+
+<!-- ##### STRUCT GdkKeyInfo ##### -->
+<para>
+
+</para>
+
+@keycode: 
+@group: 
+@level: 
+
 <!-- ##### FUNCTION gdk_input_set_source ##### -->
 <para>
 Sets the source type for a device.
@@ -187,6 +293,27 @@ Sets the source type for a device.
 @deviceid: the device to configure
 @source: the new source type.
 
+<!-- ##### FUNCTION gdk_region_spans_intersect_foreach ##### -->
+<para>
+Intersects a set of spans with a region and call a user specified
+function for each resulting spanline. This function is a lot more effective
+if the spans are sorted.
+</para>
+
+@region: The region to intersect against.
+@spans: Array of spans to intersect.
+@n_spans: Number of spans.
+@sorted: True if the spans are sorted in increasing y order.
+@function: The function to call for each intersected spanline.
+@data: Opaque user data passed to function.
+
+<!-- ##### FUNCTION gdk_keymap_get_default ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
 <!-- ##### SECTION ./tmpl/gdkregion.sgml:Title ##### -->
 Points, Rectangles and Regions
 
@@ -200,10 +327,42 @@ Returns the intersection of two regions.
 @source2: a #GdkRegion.
 @Returns: the intersection of @source1 and @source2.
 
+<!-- ##### FUNCTION gdk_keymap_lookup_key ##### -->
+<para>
+
+</para>
+
+@keymap: 
+@key: 
+@Returns: 
+
+<!-- ##### USER_FUNCTION GdkSpanFunc ##### -->
+<para>
+
+</para>
+
+@span: The intersected part of the span.
+@data: Opaque data passed by user.
+
+<!-- ##### STRUCT GdkKeymapClass ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### SECTION ./tmpl/gdkkeys.sgml:Title ##### -->
 Keyboard Handling
 
 
+<!-- ##### STRUCT GdkKeymapKey ##### -->
+<para>
+
+</para>
+
+@keycode: 
+@group: 
+@level: 
+
 <!-- ##### FUNCTION gdk_input_set_mode ##### -->
 <para>
 Enables or disables a device, and determines how the
index 006d562a4838b208fb5f096c18f4e5f12ecb3436..7c4b568871eaef8e052c99360a872b10f7ed589f 100644 (file)
@@ -29,96 +29,6 @@ using gdk_keyval_to_upper() and gdk_keyval_to_lower().
 
 </para>
 
-<!-- ##### STRUCT GdkKeymap ##### -->
-<para>
-
-</para>
-
-@parent_instance: 
-
-<!-- ##### STRUCT GdkKeymapClass ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### STRUCT GdkKeymapKey ##### -->
-<para>
-
-</para>
-
-@keycode: 
-@group: 
-@level: 
-
-<!-- ##### STRUCT GdkKeyInfo ##### -->
-<para>
-
-</para>
-
-@keycode: 
-@group: 
-@level: 
-
-<!-- ##### FUNCTION gdk_keymap_get_default ##### -->
-<para>
-
-</para>
-
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_keymap_lookup_key ##### -->
-<para>
-
-</para>
-
-@keymap: 
-@key: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_keymap_translate_keyboard_state ##### -->
-<para>
-
-</para>
-
-@keymap: 
-@hardware_keycode: 
-@state: 
-@group: 
-@keyval: 
-@effective_group: 
-@level: 
-@unused_modifiers: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_keymap_get_entries_for_keyval ##### -->
-<para>
-
-</para>
-
-@keymap: 
-@keyval: 
-@keys: 
-@n_keys: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_keymap_get_entries_for_keycode ##### -->
-<para>
-
-</para>
-
-@keymap: 
-@hardware_keycode: 
-@keys: 
-@keyvals: 
-@n_entries: 
-@Returns: 
-
-
 <!-- ##### FUNCTION gdk_keyval_name ##### -->
 <para>
 Converts a key value into a symbolic name.
index 88e3e2d62ebaf0c94d4bfbfe85143ebe13b56b5b..387544c82b6881300a12a8e5412778e8614b7c9b 100644 (file)
@@ -266,36 +266,3 @@ Returns the union of a region and a rectangle.
 @source2: 
 
 
-<!-- ##### STRUCT GdkSpan ##### -->
-<para>
-
-</para>
-
-@x: 
-@y: 
-@width: 
-
-<!-- ##### USER_FUNCTION GdkSpanFunc ##### -->
-<para>
-
-</para>
-
-@span: The intersected part of the span.
-@data: Opaque data passed by user.
-
-
-<!-- ##### FUNCTION gdk_region_spans_intersect_foreach ##### -->
-<para>
-Intersects a set of spans with a region and call a user specified
-function for each resulting spanline. This function is a lot more effective
-if the spans are sorted.
-</para>
-
-@region: The region to intersect against.
-@spans: Array of spans to intersect.
-@n_spans: Number of spans.
-@sorted: True if the spans are sorted in increasing y order.
-@function: The function to call for each intersected spanline.
-@data: Opaque user data passed to function.
-
-
index b5569ac2579c2ca6ec671e06a7a56abf5b4bc643..cc811058b6dff7ccd8435d59115c98a3f8c11ba2 100644 (file)
@@ -871,16 +871,6 @@ Windows
 @decorations: 
 
 
-<!-- ##### FUNCTION gdk_window_get_decorations ##### -->
-<para>
-
-</para>
-
-@window: 
-@decorations: 
-@Returns: 
-
-
 <!-- ##### ENUM GdkWMDecoration ##### -->
 <para>
 
index f723d7f7385f60347029e405717eeb458e654519..d20fe80f243756e371eced0d2fb7721419653b27 100644 (file)
@@ -103,7 +103,7 @@ endif
 scan:
        (cd $(srcdir) \
        && CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" gtkdoc-scangobj --module=$(DOC_MODULE) \
-       && gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" $(EXTRA_HFILES))
+       && gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --deprecated-guards="GTK_ENABLE_BROKEN|GTK_DISABLE_DEPRECATED" --ignore-headers="$(IGNORE_HFILES)" $(EXTRA_HFILES))
 
 templates: 
        cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE)
index b39fa718d4400128460f5adf02ed2779c62724b6..4792e3d616ae6d3c74743ab95cdf8062dc7de3a5 100644 (file)
@@ -261,7 +261,6 @@ An advanced widget set.
         &gtk-TextWidget;
         &gtk-GtkTextIter;
         &gtk-GtkTextMark;
-        &GtkText;
         &GtkTextBuffer;
         &GtkTextTag;
         &GtkTextTagTable;
@@ -393,6 +392,7 @@ An advanced widget set.
         &GtkPreview;
         &GtkProgress;
         &GtkRuler;
+        &GtkText;
         &GtkTipsQuery;
         &GtkTree;
         &GtkTreeItem;
index 28e71fdecb0fa175da56c5592904d60969211e60..25cbfa812d4e4f79648a76667a8e3a6781f816e9 100644 (file)
@@ -327,6 +327,13 @@ A structure used to return values from @gtk_type_query.
 @func_data: 
 @args: 
 
+<!-- ##### ARG GtkTextTag:justify ##### -->
+<para>
+A #GtkJustification for the text. This is only used when the tag is
+applied to the first character in a paragraph.
+</para>
+
+
 <!-- ##### USER_FUNCTION GtkSignalMarshal ##### -->
 <para>
 This is currently a hack left in for a scheme wrapper library.
@@ -744,6 +751,15 @@ Deprecated.
 @func_data: 
 @args: 
 
+<!-- ##### FUNCTION gtk_tree_store_getv ##### -->
+<para>
+
+</para>
+
+@tree_store: 
+@iter: 
+@var_args: 
+
 <!-- ##### FUNCTION gtk_text_buffer_cut ##### -->
 <para>
 
@@ -854,6 +870,17 @@ the number of columns specified.
 @entries: 
 @nentries: 
 
+<!-- ##### FUNCTION gtk_tree_view_move_to ##### -->
+<para>
+
+</para>
+
+@tree_view: 
+@path: 
+@column: 
+@row_align: 
+@col_align: 
+
 <!-- ##### FUNCTION gtk_text_buffer_find_string ##### -->
 <para>
 
@@ -1326,6 +1353,14 @@ of the widget.
 
 @editable: the object which received the signal.
 
+<!-- ##### FUNCTION gtk_tree_view_column_get_size ##### -->
+<para>
+
+</para>
+
+@tree_column: 
+@Returns: 
+
 <!-- ##### STRUCT GtkMenuFactory ##### -->
 <para>
 
@@ -1689,6 +1724,14 @@ should have in their prototype (of length nparams).
 @func_data: 
 @args: 
 
+<!-- ##### FUNCTION gtk_tree_view_column_set_header_clickable ##### -->
+<para>
+
+</para>
+
+@tree_column: 
+@active: 
+
 <!-- ##### FUNCTION gtk_color_selection_set_opacity ##### -->
 <para>
 Controls whether opacity can be set with the #GtkColorSelection.
@@ -1839,6 +1882,14 @@ The first "flat" (no struct) enumerated type value.
 
 @tree_model_sort: 
 
+<!-- ##### FUNCTION gtk_tree_view_column_get_col_type ##### -->
+<para>
+
+</para>
+
+@tree_column: 
+@Returns: 
+
 <!-- ##### FUNCTION gtk_menu_factory_new ##### -->
 <para>
 
@@ -2234,6 +2285,12 @@ object.
 @pixmap: 
 @mask: 
 
+<!-- ##### ARG GtkTextTag:justify-set ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### FUNCTION gtk_marshal_NONE__C_CALLBACK_C_CALLBACK ##### -->
 <para>
 
@@ -2395,6 +2452,15 @@ destroyed.
 @window: 
 @defaultw: 
 
+<!-- ##### FUNCTION gtk_tree_store_setv ##### -->
+<para>
+
+</para>
+
+@tree_store: 
+@iter: 
+@var_args: 
+
 <!-- ##### SIGNAL GtkTextBuffer::delete-text ##### -->
 <para>
 
@@ -2703,6 +2769,14 @@ Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_CALLBACK
 @iter: 
 @Returns: 
 
+<!-- ##### FUNCTION gtk_tree_store_get_root_iter ##### -->
+<para>
+
+</para>
+
+@tree_store: 
+@iter: 
+
 <!-- ##### STRUCT GtkTextBTree ##### -->
 <para>
 
index 4492a98be23a28020074888fb02b6e681190a013..e7f6ada83de5f606a48aeab0f6db09b6d30b2d0e 100644 (file)
@@ -269,3 +269,8 @@ when it is shown in %GTK_PROGRESS_DISCRETE style.
 
 </para>
 
+<!-- ##### ARG GtkProgressBar:text ##### -->
+<para>
+
+</para>
+
index e71f07a83d4e6d7389b9237aa46d59b4fb4e6151..f7d4e3f18da13dd584f1249f826a58b0eaeee7e4 100644 (file)
@@ -2,10 +2,17 @@
 GtkText
 
 <!-- ##### SECTION Short_Description ##### -->
-text widget which allows display and manipulation of arbitrary text
+deprecated text widget, use #GtkTextView instead
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>\r
+<warning>
+<para>
+#GtkText is deprecated and unsupported. It is known to be
+buggy. To use it, you must define the symbol %GTK_ENABLE_BROKEN
+prior to including the GTK+ header files. Use #GtkTextView instead.
+</para>
+</warning>
 A #GtkText widget allows one to display any given text and manipulate it\r
 by deleting from one point to another, selecting a region, and various\r
 other functions as outlined below.  It is inherited from #GtkEditable.\r
index 8858fd780bd749ef1baf2f6f2bd66dc631981cd2..939af5d93bf98eaaa7b56830cb78e10681e67454 100644 (file)
@@ -41,7 +41,7 @@ types related to the text widget and how they work together.
 @stretch_set: 
 @size_set: 
 @fg_stipple_set: 
-@justify_set: 
+@justification_set: 
 @left_margin_set: 
 @indent_set: 
 @rise_set: 
@@ -82,9 +82,9 @@ types related to the text widget and how they work together.
 Describes a type of line wrapping.
 </para>
 
-@GTK_WRAPMODE_NONE: don't wrap lines; just use scrollbars
-@GTK_WRAPMODE_CHAR: allow line breaks between any two characters
-@GTK_WRAPMODE_WORD: allow line breaks only between words
+@GTK_WRAP_NONE: 
+@GTK_WRAP_CHAR: 
+@GTK_WRAP_WORD: 
 
 <!-- ##### STRUCT GtkTextAttributes ##### -->
 <para>
@@ -93,7 +93,7 @@ Describes a type of line wrapping.
 
 @refcount: 
 @appearance: 
-@justify
+@justification
 @direction: 
 @font: 
 @left_margin: 
@@ -322,10 +322,9 @@ Font as a #PangoFontDescription.
 
 </para>
 
-<!-- ##### ARG GtkTextTag:justify ##### -->
+<!-- ##### ARG GtkTextTag:justification ##### -->
 <para>
-A #GtkJustification for the text. This is only used when the tag is
-applied to the first character in a paragraph.
+
 </para>
 
 <!-- ##### ARG GtkTextTag:language ##### -->
@@ -468,7 +467,7 @@ applies to the first character in a paragraph.
 
 </para>
 
-<!-- ##### ARG GtkTextTag:justify-set ##### -->
+<!-- ##### ARG GtkTextTag:justification-set ##### -->
 <para>
 
 </para>
index d2621b8ed8f932770681ab4858a64287f085ef37..0f5962ed0ce885f6a230b818bfb60cad8303d74b 100644 (file)
@@ -85,8 +85,8 @@ types related to the text widget and how they work together.
 @use_align: 
 @xalign: 
 @yalign: 
-@Returns: 
 <!-- # Unused Parameters # -->
+@Returns: 
 @mark_within_margin: 
 
 
@@ -97,6 +97,7 @@ types related to the text widget and how they work together.
 
 @text_view: 
 @mark: 
+<!-- # Unused Parameters # -->
 @Returns: 
 
 
index 08cfbd3b5ea2879d38cddf09e64113304ba91e9c..c61ca2e29369f28ff43dbcff8d3eab85f1e8fa41 100644 (file)
@@ -2,10 +2,17 @@
 GtkTree
 
 <!-- ##### SECTION Short_Description ##### -->
-A treelist widget.
+Deprecated tree widget (use #GtkTreeView instead).
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
+<warning>
+<para>
+#GtkTree is deprecated and unsupported. It is known to be
+buggy. To use it, you must define the symbol %GTK_ENABLE_BROKEN
+prior to including the GTK+ header files. Use #GtkTreeView intead.
+</para>
+</warning>
 The #GtkTree widget is a container that shows users a list of items, in a tree format complete with branches and leafnodes. Branches can be expanded to show their child items, or collapsed to hide them.
 </para>
 
index 45ce767c77db6c1bfcbc059ac66a391a1330bcdc..03d90183accc615fe8c3bbcd5708260c9a154383 100644 (file)
@@ -84,16 +84,6 @@ GtkTreeStore
 @Varargs: 
 
 
-<!-- ##### FUNCTION gtk_tree_store_setv ##### -->
-<para>
-
-</para>
-
-@tree_store: 
-@iter: 
-@var_args: 
-
-
 <!-- ##### FUNCTION gtk_tree_store_get ##### -->
 <para>
 
@@ -104,16 +94,6 @@ GtkTreeStore
 @Varargs: 
 
 
-<!-- ##### FUNCTION gtk_tree_store_getv ##### -->
-<para>
-
-</para>
-
-@tree_store: 
-@iter: 
-@var_args: 
-
-
 <!-- ##### FUNCTION gtk_tree_store_remove ##### -->
 <para>
 
@@ -176,15 +156,6 @@ GtkTreeStore
 @parent: 
 
 
-<!-- ##### FUNCTION gtk_tree_store_get_root_iter ##### -->
-<para>
-
-</para>
-
-@tree_store: 
-@iter: 
-
-
 <!-- ##### FUNCTION gtk_tree_store_is_ancestor ##### -->
 <para>
 
index 92e290fc4c9cfa6e9e895d45e4c73d107886f405..aaf95374b1f61a8e4fd88a5e6ee75ef4da209ea1 100644 (file)
@@ -157,6 +157,8 @@ GtkTreeView
 </para>
 
 @tree_view: 
+@setting: 
+<!-- # Unused Parameters # -->
 @active: 
 
 
@@ -201,18 +203,6 @@ GtkTreeView
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_tree_view_move_to ##### -->
-<para>
-
-</para>
-
-@tree_view: 
-@path: 
-@column: 
-@row_align: 
-@col_align: 
-
-
 <!-- ##### FUNCTION gtk_tree_view_get_path_at_pos ##### -->
 <para>
 
@@ -224,6 +214,8 @@ GtkTreeView
 @y: 
 @path: 
 @column: 
+@cell_x: 
+@cell_y: 
 @Returns: 
 
 
index b266434db4b57a2d189445d9169385ec5a85b578..ff4911e87f150a0987777e6313eee6895da9730f 100644 (file)
@@ -29,6 +29,7 @@ GtkTreeViewColumn
 @parent: 
 @tree_view: 
 @button: 
+@child: 
 @window: 
 @justification: 
 @id: 
@@ -150,24 +151,6 @@ GtkTreeViewColumn
 @type: 
 
 
-<!-- ##### FUNCTION gtk_tree_view_column_get_col_type ##### -->
-<para>
-
-</para>
-
-@tree_column: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_tree_view_column_get_size ##### -->
-<para>
-
-</para>
-
-@tree_column: 
-@Returns: 
-
-
 <!-- ##### FUNCTION gtk_tree_view_column_set_width ##### -->
 <para>
 
@@ -231,15 +214,6 @@ GtkTreeViewColumn
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_tree_view_column_set_header_clickable ##### -->
-<para>
-
-</para>
-
-@tree_column: 
-@active: 
-
-
 <!-- ##### FUNCTION gtk_tree_view_column_set_widget ##### -->
 <para>
 
index 0793f19c8a1212e3c8798a4600cf5bb3fc8a716a..c3db63e8c295db6537efcb93302ff05a58268fba 100644 (file)
@@ -245,6 +245,15 @@ it's larger
 @Returns: 
 
 
+<!-- ##### SIGNAL GtkWindow::frame-event ##### -->
+<para>
+
+</para>
+
+@window: the object which received the signal.
+@event: 
+@Returns: 
+
 <!-- ##### SIGNAL GtkWindow::set-focus ##### -->
 <para>
 
index e2f9f49ae5cb1d5ad54392c31e03baefbc56d036..5933396703b4d92b19562178740750bdf474828f 100644 (file)
@@ -31,6 +31,7 @@
 #include "gtkmain.h"
 #include "gtkselection.h"
 #include "gtksignal.h"
+#define GTK_ENABLE_BROKEN
 #include "gtktext.h"
 #include "line-wrap.xbm"
 #include "line-arrow.xbm"
index b51f7b56e86c6658049916012dde7333012c969e..bd46976e52cd83c73d7a3257384ee3b30680c0d3 100644 (file)
@@ -24,6 +24,8 @@
  * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
  */
 
+#ifdef GTK_ENABLE_BROKEN
+
 #ifndef __GTK_TEXT_H__
 #define __GTK_TEXT_H__
 
@@ -218,3 +220,5 @@ gint       gtk_text_forward_delete  (GtkText       *text,
 
 
 #endif /* __GTK_TEXT_H__ */
+
+#endif /* GTK_ENABLE_BROKEN */
index cc20068967acd8420b5f040f8da3b0f0ae46dba1..76859fdd38772f87f8f605841ca897f6f23bdfdf 100644 (file)
@@ -33,7 +33,6 @@
 #include "gtkmenu.h"
 #include "gtkmenuitem.h"
 #include "gtksignal.h"
-#include "gtktext.h"
 #include "gtktextdisplay.h"
 #include "gtktextview.h"
 #include "gtkimmulticontext.h"
index 2c845874f9b7727757dbee725afb2b1590c09c48..1102a98eba681da69935476c15659b12d4dfc3aa 100644 (file)
  * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
  */
 
-#include "gtktree.h"
-#include "gtktreeitem.h"
 #include "gtkmain.h"
 #include "gtksignal.h"
 #include "gtklist.h"
 
+#define GTK_ENABLE_BROKEN
+#include "gtktree.h"
+#include "gtktreeitem.h"
+
 enum {
   SELECTION_CHANGED,
   SELECT_CHILD,
index 5eed018610aa8ca44a56d53235def7036d6bc406..d5f938e93a53cfeb3d118a88b54848a0d6c0a30c 100644 (file)
@@ -24,6 +24,8 @@
  * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
  */
 
+#ifdef GTK_ENABLE_BROKEN
+
 #ifndef __GTK_TREE_H__
 #define __GTK_TREE_H__
 
@@ -132,3 +134,5 @@ void       gtk_tree_remove_item        (GtkTree          *tree,
 
 
 #endif /* __GTK_TREE_H__ */
+
+#endif /* GTK_ENABLE_BROKEN */
index dc4cb886e04275711ae3f7f902c4bd2acef74ed7..35484b69822c36e67a1c13060495ed3783d32635 100644 (file)
  */
 
 #include "gtklabel.h"
-#include "gtktree.h"
-#include "gtktreeitem.h"
 #include "gtkeventbox.h"
 #include "gtkpixmap.h"
 #include "gtkmain.h"
 #include "gtksignal.h"
+#define GTK_ENABLE_BROKEN
+#include "gtktree.h"
+#include "gtktreeitem.h"
 
 #include "tree_plus.xpm"
 #include "tree_minus.xpm"
index 036aa7465f434c0fe346cfa3fc57803627ea5780..beca5321e5303ff2d3e0753082877c6e69456324 100644 (file)
@@ -24,6 +24,8 @@
  * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
  */
 
+#ifdef GTK_ENABLE_BROKEN
+
 #ifndef __GTK_TREE_ITEM_H__
 #define __GTK_TREE_ITEM_H__
 
@@ -91,3 +93,5 @@ void       gtk_tree_item_collapse       (GtkTreeItem *tree_item);
 
 
 #endif /* __GTK_TREE_ITEM_H__ */
+
+#endif /* GTK_ENABLE_BROKEN */
index eae0e3f1850461b6cae69c13dc88417de3816a76..d92b0a4d90ecebf179b38c950444babd2be594bb 100644 (file)
@@ -102,6 +102,7 @@ gtk_type_new (GtkType type)
 /* includes for various places
  * with enum definitions
  */
+#define GTK_ENABLE_BROKEN
 #include "makeenums.h"
 /* type variable declarations
  */
index acdaa65ed977ebbc1b9cab24eb223cf37563eb85..73a151ec5f516c6b5e5b1283071f7c76dccda0a1 100644 (file)
@@ -38,6 +38,7 @@
 #include <unistd.h>
 #endif
 
+#define GTK_ENABLE_BROKEN
 #include "gtk.h"
 #include "gdk/gdk.h"
 #include "gdk/gdkkeysyms.h"
index 4843ac6c41b8e1978342ee91e3246ac929a57113..4f7f6b7e0b7cc28952893da8bbd05c13ce5a3ef5 100644 (file)
@@ -26,6 +26,7 @@
 
 #include <stdio.h>
 #include <string.h>
+#define GTK_ENABLE_BROKEN
 #include "gtk.h"
 
 typedef enum {
index acdaa65ed977ebbc1b9cab24eb223cf37563eb85..73a151ec5f516c6b5e5b1283071f7c76dccda0a1 100644 (file)
@@ -38,6 +38,7 @@
 #include <unistd.h>
 #endif
 
+#define GTK_ENABLE_BROKEN
 #include "gtk.h"
 #include "gdk/gdk.h"
 #include "gdk/gdkkeysyms.h"
index 4843ac6c41b8e1978342ee91e3246ac929a57113..4f7f6b7e0b7cc28952893da8bbd05c13ce5a3ef5 100644 (file)
@@ -26,6 +26,7 @@
 
 #include <stdio.h>
 #include <string.h>
+#define GTK_ENABLE_BROKEN
 #include "gtk.h"
 
 typedef enum {