Add deprecation docs.

* gdk-pixbuf-animation.c:
	* gdk-pixbuf.c: Add deprecation docs.

gdk-pixbuf/ChangeLog

@@ -1,3 +1,8 @@
+2002-11-29  Matthias Clasen  <maclas@gmx.de>
+
+	* gdk-pixbuf-animation.c: 
+	* gdk-pixbuf.c: Add deprecation docs. 
+
 2002-11-28  Matthias Clasen  <maclas@gmx.de>
 
 	* gdk-pixbuf/gdk-pixbuf-io.c:

gdk-pixbuf/gdk-pixbuf-animation.c

@@ -236,11 +236,11 @@ gdk_pixbuf_animation_new_from_file (const char *filename,
  * gdk_pixbuf_animation_ref:
  * @animation: An animation.
  *
- * Adds a reference to an animation. Deprecated; use
+ * Adds a reference to an animation. 
- * g_object_ref(). The reference must be released afterwards using
- * g_object_unref().
  *
  * Return value: The same as the @animation argument.
+ *
+ * Deprecated: Use g_object_ref(). 
  **/
 GdkPixbufAnimation *
 gdk_pixbuf_animation_ref (GdkPixbufAnimation *animation)
@@ -252,7 +252,9 @@ gdk_pixbuf_animation_ref (GdkPixbufAnimation *animation)
  * gdk_pixbuf_animation_unref:
  * @animation: An animation.
  * 
- * Removes a reference from an animation. Deprecated; use g_object_unref().
+ * Removes a reference from an animation. 
+ *
+ * Deprecated: Use g_object_unref().
  **/
 void
 gdk_pixbuf_animation_unref (GdkPixbufAnimation *animation)

gdk-pixbuf/gdk-pixbuf.c

@@ -89,9 +89,11 @@ gdk_pixbuf_finalize (GObject *object)
  * gdk_pixbuf_ref:
  * @pixbuf: A pixbuf.
  *
- * Adds a reference to a pixbuf. Deprecated; use g_object_ref().
+ * Adds a reference to a pixbuf. 
  *
  * Return value: The same as the @pixbuf argument.
+ *
+ * Deprecated: Use g_object_ref().
  **/
 GdkPixbuf *
 gdk_pixbuf_ref (GdkPixbuf *pixbuf)
@@ -103,9 +105,9 @@ gdk_pixbuf_ref (GdkPixbuf *pixbuf)
  * gdk_pixbuf_unref:
  * @pixbuf: A pixbuf.
  *
- * Removes a reference from a pixbuf. Deprecated; use
+ * Removes a reference from a pixbuf. 
- * g_object_unref().
  *
+ * Deprecated: Use g_object_unref().
  **/
 void
 gdk_pixbuf_unref (GdkPixbuf *pixbuf)