[gtk+/gtk-2-22] docs: Add note to gdk_pixmap_new() about create_similar() function

[Benjamin Otte <otte src gnome org>]

commit 3df3ff9a3ae6aebcfc91b14e06663e912a0d4356
Author: Benjamin Otte <otte redhat com>
Date:   Thu Aug 12 23:33:05 2010 +0200

    docs: Add note to gdk_pixmap_new() about create_similar() function
    
    gdk_window_create_similar_surface() is basically the replacement for
    this function.

 docs/reference/gdk/tmpl/pixmaps.sgml |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/gdk/tmpl/pixmaps.sgml b/docs/reference/gdk/tmpl/pixmaps.sgml
index d80490d..89bd38d 100644
--- a/docs/reference/gdk/tmpl/pixmaps.sgml
+++ b/docs/reference/gdk/tmpl/pixmaps.sgml
@@ -43,6 +43,11 @@ these types.
 <para>
 Create a new pixmap with a given size and depth.
 </para>
+<para>
+Please use gdk_window_create_similar_surface() instead of this
+function if you're not forced to use a #GdkPixmap. It is intended
+as the replacement function for this function in GTK 3.
+</para>
 
 @drawable: A #GdkDrawable, used to determine default values
 for the new pixmap. Can be %NULL if @depth is specified,