From b29a050c13747a27591d0aacdfb464ca798c823c Mon Sep 17 00:00:00 2001
From: Sven Neumann <sven@gimp.org>
Date: Fri, 28 Mar 2008 16:56:43 +0000
Subject: [PATCH] deprecate gimp_md5_get_digest() in favor of GCheckSum.

2008-03-28  Sven Neumann  <sven@gimp.org>

	* libgimpmath/gimpmd5.[ch]: deprecate gimp_md5_get_digest() in
	favor of GCheckSum.

	* libgimpmath/test-md5.c: undef GIMP_DISABLE_DEPRECATED.

svn path=/trunk/; revision=25288
---
 ChangeLog              |  7 +++++++
 libgimpmath/gimpmd5.c  | 15 +++++----------
 libgimpmath/gimpmd5.h  |  3 +++
 libgimpmath/test-md5.c |  1 +
 4 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 77c01bcd72..f4d8f02c73 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2008-03-28  Sven Neumann  <sven@gimp.org>
+
+	* libgimpmath/gimpmd5.[ch]: deprecate gimp_md5_get_digest() in
+	favor of GCheckSum.
+
+	* libgimpmath/test-md5.c: undef GIMP_DISABLE_DEPRECATED.
+
 2008-03-28  Sven Neumann  <sven@gimp.org>
 
 	* libgimpthumb/gimpthumb-utils.c (gimp_thumb_png_name): use
diff --git a/libgimpmath/gimpmd5.c b/libgimpmath/gimpmd5.c
index 7a16020115..a63bdcf2d8 100644
--- a/libgimpmath/gimpmd5.c
+++ b/libgimpmath/gimpmd5.c
@@ -51,19 +51,14 @@ static void  gimp_md5_final     (GimpMD5Context *ctx,
 
 /**
  * gimp_md5_get_digest:
- * @buffer: byte buffer
+ * @buffer:      byte buffer
  * @buffer_size: buffer size (in bytes) or -1 if @buffer is nul-terminated.
- * @digest: 16 bytes buffer receiving the hash code.
+ * @digest:      16 bytes buffer receiving the hash code.
+ *
+ * This function is deprecated! Use %GChecksum from GLib instead.
  *
  * Get the md5 hash of a buffer. The result is put in the 16 bytes
- * buffer @digest.
- *
- * The MD5 algorithm takes as input a message of arbitrary length and
- * produces as output a 128-bit "fingerprint" or "message digest" of
- * the input.  It is conjectured that it is computationally infeasible
- * to produce two messages having the same message digest, or to
- * produce any message having a given prespecified target message
- * digest. For more information see RFC 1321.
+ * buffer @digest. For more information see RFC 1321.
  **/
 void
 gimp_md5_get_digest (const gchar *buffer,
diff --git a/libgimpmath/gimpmd5.h b/libgimpmath/gimpmd5.h
index 43ef781b60..cd4f7a91ad 100644
--- a/libgimpmath/gimpmd5.h
+++ b/libgimpmath/gimpmd5.h
@@ -28,10 +28,13 @@ G_BEGIN_DECLS
 
 /* For information look into the C source or the html documentation */
 
+#ifndef GIMP_DISABLE_DEPRECATED
+
 void gimp_md5_get_digest (const gchar *buffer,
                           gint         buffer_size,
                           guchar       digest[16]);
 
+#endif /* GIMP_DISABLE_DEPRECATED */
 
 G_END_DECLS
 
diff --git a/libgimpmath/test-md5.c b/libgimpmath/test-md5.c
index 72446db473..23530eb3db 100644
--- a/libgimpmath/test-md5.c
+++ b/libgimpmath/test-md5.c
@@ -10,6 +10,7 @@
 
 #include <glib.h>
 
+#undef GIMP_DISABLE_DEPRECATED
 #include "gimpmd5.h"