[vte/vte-0-34] widget: Deprecate some unused functions

[Christian Persch <chpe src gnome org>]

commit 2da7058c57fd27bb8a8955b50a7a5b2ae8e6d50f
Author: Christian Persch <chpe gnome org>
Date:   Tue Jul 30 15:29:48 2013 +0200

    widget: Deprecate some unused functions
    
    We don't use these in g-t anymore, and they're already gone from -next, so
    deprecate them here too.

 doc/reference/vte-sections.txt |   18 ++++++++++--------
 src/vte.c                      |   28 ++++++++++++++++++++++++++++
 src/vtedeprecated.h            |   13 +++++++++++++
 3 files changed, 51 insertions(+), 8 deletions(-)
---
diff --git a/doc/reference/vte-sections.txt b/doc/reference/vte-sections.txt
index 8a473b0..1bf7407 100644
--- a/doc/reference/vte-sections.txt
+++ b/doc/reference/vte-sections.txt
@@ -9,7 +9,6 @@ VteTerminalEraseBinding
 VteTerminalWriteFlags
 VteSelectionFunc
 vte_terminal_new
-vte_terminal_im_append_menuitems
 vte_terminal_feed
 vte_terminal_feed_child
 vte_terminal_feed_child_binary
@@ -44,13 +43,6 @@ vte_terminal_set_color_highlight_rgba
 vte_terminal_set_colors
 vte_terminal_set_colors_rgba
 vte_terminal_set_default_colors
-vte_terminal_set_opacity
-vte_terminal_set_background_image
-vte_terminal_set_background_image_file
-vte_terminal_set_background_saturation
-vte_terminal_set_background_transparent
-vte_terminal_set_background_tint_color
-vte_terminal_set_scroll_background
 vte_terminal_set_cursor_shape
 vte_terminal_get_cursor_shape
 vte_terminal_set_cursor_blinks
@@ -144,6 +136,16 @@ vte_terminal_get_window_title
 vte_terminal_get_current_directory_uri
 vte_terminal_get_current_file_uri
 
+<SUBSECTION Deprecated>
+vte_terminal_im_append_menuitems
+vte_terminal_set_opacity
+vte_terminal_set_background_image
+vte_terminal_set_background_image_file
+vte_terminal_set_background_saturation
+vte_terminal_set_background_transparent
+vte_terminal_set_background_tint_color
+vte_terminal_set_scroll_background
+
 <SUBSECTION Private>
 VTE_IS_TERMINAL_ANTI_ALIAS
 VTE_IS_TERMINAL_ERASE_BINDING
diff --git a/src/vte.c b/src/vte.c
index 0e504f4..fdae4bd 100644
--- a/src/vte.c
+++ b/src/vte.c
@@ -3087,6 +3087,8 @@ vte_terminal_set_colors_rgba(VteTerminal *terminal,
  *
  * Sets the opacity of the terminal background, were 0 means completely
  * transparent and 65535 means completely opaque.
+ *
+ * Deprecated: 0.34.8
  */
 void
 vte_terminal_set_opacity(VteTerminal *terminal, guint16 opacity)
@@ -12422,6 +12424,8 @@ vte_terminal_class_init(VteTerminalClass *klass)
          * in-memory copy of the image before applying it to the terminal.
          * 
          * Since: 0.20
+         *
+         * Deprecated: 0.34.8
          */
         g_object_class_install_property
                 (gobject_class,
@@ -12441,6 +12445,8 @@ vte_terminal_class_init(VteTerminalClass *klass)
          * in-memory copy of the image before applying it to the terminal.
          * 
          * Since: 0.20
+         *
+         * Deprecated: 0.34.8
          */
         g_object_class_install_property
                 (gobject_class,
@@ -12456,6 +12462,8 @@ vte_terminal_class_init(VteTerminalClass *klass)
          * transparent and 1.0 means completely opaque.
          *
          * Since: 0.20
+         *
+         * Deprecated: 0.34.8
          */
         g_object_class_install_property
                 (gobject_class,
@@ -12476,6 +12484,8 @@ vte_terminal_class_init(VteTerminalClass *klass)
          * image (or snapshot of the root window) and modify its pixel values.
          *
          * Since: 0.20
+         *
+         * Deprecated: 0.34.8
          */
         g_object_class_install_property
                 (gobject_class,
@@ -12498,6 +12508,8 @@ vte_terminal_class_init(VteTerminalClass *klass)
          * is black.
          * 
          * Since: 0.20
+         *
+         * Deprecated: 0.34.8
          */
         g_object_class_install_property
                 (gobject_class,
@@ -12517,6 +12529,8 @@ vte_terminal_class_init(VteTerminalClass *klass)
          * set a RGBA colourmap on the toplevel window, so you get real transparency.
          *
          * Since: 0.20
+         *
+         * Deprecated: 0.34.8
          */
         g_object_class_install_property
                 (gobject_class,
@@ -13033,6 +13047,8 @@ vte_terminal_get_allow_bold(VteTerminal *terminal)
  * one is set) when the text in the window must be scrolled.
  *
  * Since: 0.11
+ *
+ * Deprecated: 0.34.8
  */
 void
 vte_terminal_set_scroll_background(VteTerminal *terminal, gboolean scroll)
@@ -13186,6 +13202,8 @@ vte_terminal_paste_primary(VteTerminal *terminal)
  * Appends menu items for various input methods to the given menu.  The
  * user can select one of these items to modify the input method used by
  * the terminal.
+ *
+ * Deprecated: 0.34.6
  */
 void
 vte_terminal_im_append_menuitems(VteTerminal *terminal, GtkMenuShell *menushell)
@@ -13314,6 +13332,8 @@ vte_terminal_queue_background_update(VteTerminal *terminal)
  * than 1.0, the terminal will adjust the colors of the image before drawing
  * the image.  To do so, the terminal will create a copy of the background
  * image (or snapshot of the root window) and modify its pixel values.
+ *
+ * Deprecated: 0.34.8
  */
 void
 vte_terminal_set_background_saturation(VteTerminal *terminal, double saturation)
@@ -13356,6 +13376,8 @@ vte_terminal_set_background_saturation(VteTerminal *terminal, double saturation)
  * is black.
  *
  * Since: 0.11
+ *
+ * Deprecated: 0.34.8
  */
 void
 vte_terminal_set_background_tint_color(VteTerminal *terminal,
@@ -13397,6 +13419,8 @@ vte_terminal_set_background_tint_color(VteTerminal *terminal,
  * Sets the terminal's background image to the pixmap stored in the root
  * window, adjusted so that if there are no windows below your application,
  * the widget will appear to be transparent.
+ *
+ * Deprecated: 0.34.8
  */
 void
 vte_terminal_set_background_transparent(VteTerminal *terminal,
@@ -13434,6 +13458,8 @@ vte_terminal_set_background_transparent(VteTerminal *terminal,
  * widget's entire visible area. If specified by
  * vte_terminal_set_background_saturation(), the terminal will tint its
  * in-memory copy of the image before applying it to the terminal.
+ *
+ * Deprecated: 0.34.8
  */
 void
 vte_terminal_set_background_image(VteTerminal *terminal, GdkPixbuf *image)
@@ -13493,6 +13519,8 @@ vte_terminal_set_background_image(VteTerminal *terminal, GdkPixbuf *image)
  * Sets a background image for the widget.  If specified by
  * vte_terminal_set_background_saturation(), the terminal will tint its
  * in-memory copy of the image before applying it to the terminal.
+ *
+ * Deprecated: 0.34.8
  */
 void
 vte_terminal_set_background_image_file(VteTerminal *terminal, const char *path)
diff --git a/src/vtedeprecated.h b/src/vtedeprecated.h
index da7d44b..2308c00 100644
--- a/src/vtedeprecated.h
+++ b/src/vtedeprecated.h
@@ -101,6 +101,19 @@ void vte_terminal_im_append_menuitems(VteTerminal *terminal,
 GtkAdjustment *vte_terminal_get_adjustment(VteTerminal *terminal);
 #endif
 
+/* Background effects. */
+void vte_terminal_set_scroll_background(VteTerminal *terminal, gboolean scroll);
+void vte_terminal_set_background_image(VteTerminal *terminal, GdkPixbuf *image);
+void vte_terminal_set_background_image_file(VteTerminal *terminal,
+                                           const char *path);
+void vte_terminal_set_background_tint_color(VteTerminal *terminal,
+                                           const GdkColor *color);
+void vte_terminal_set_background_saturation(VteTerminal *terminal,
+                                           double saturation);
+void vte_terminal_set_background_transparent(VteTerminal *terminal,
+                                            gboolean transparent);
+void vte_terminal_set_opacity(VteTerminal *terminal, guint16 opacity);
+
 G_END_DECLS
 
 #endif /* !vte_deprecated_h_included */