gmime r1274 - in trunk: . docs/reference gmime

[fejj svn gnome org]

Author: fejj
Date: Sun May 25 13:59:33 2008
New Revision: 1274
URL: http://svn.gnome.org/viewvc/gmime?rev=1274&view=rev

Log:
2008-05-25  Jeffrey Stedfast  <fejj novell com>

	* gmime/gmime-part.c (g_mime_part_get_content_disposition_object):
	Added an accessor to make bindings easier.



Modified:
   trunk/ChangeLog
   trunk/TODO
   trunk/docs/reference/gmime-sections.txt
   trunk/gmime/gmime-message.c
   trunk/gmime/gmime-part.c
   trunk/gmime/gmime-part.h

Modified: trunk/TODO
==============================================================================
--- trunk/TODO	(original)
+++ trunk/TODO	Sun May 25 13:59:33 2008
@@ -54,6 +54,19 @@
 - GMimeMultipartEncrypted::decrypt() needs to return a
   GMimeSignatureStatus for signed/encrypted parts.
 
+- Rename GMimeDisposition to GMimeContentDisposition.
+
+- Move GMimePart's disposition APIs to GMimeObject since technically,
+  Multiparts can also have a disposition.
+
+- Rename g_mime_part_[g,s]et_content_disposition_object() to
+  g_mime_part_[g,s]et_content_disposition() and rename
+  g_mime_part_[g,s]et_content_disposition() to simply
+  g_mime_part_[g,s]et_disposition()
+
+- Make GMimeMultipart and InternetAddressList use arrays instead of
+  linked lists?
+
 - Get rid of deprecated functions.
 
 

Modified: trunk/docs/reference/gmime-sections.txt
==============================================================================
--- trunk/docs/reference/gmime-sections.txt	(original)
+++ trunk/docs/reference/gmime-sections.txt	Sun May 25 13:59:33 2008
@@ -669,6 +669,7 @@
 g_mime_part_get_encoding
 g_mime_part_encoding_to_string
 g_mime_part_encoding_from_string
+g_mime_part_get_content_disposition_object
 g_mime_part_set_content_disposition_object
 g_mime_part_set_content_disposition
 g_mime_part_get_content_disposition

Modified: trunk/gmime/gmime-message.c
==============================================================================
--- trunk/gmime/gmime-message.c	(original)
+++ trunk/gmime/gmime-message.c	Sun May 25 13:59:33 2008
@@ -1301,8 +1301,11 @@
  * @header: rfc822 header field
  * @value: the contents of the header field
  *
- * Add an arbitrary message header to the MIME Message such as X-Mailer,
- * X-Priority, or In-Reply-To.
+ * Add an arbitrary message header to the MIME Message such as
+ * X-Mailer, X-Priority, or In-Reply-To.
+ *
+ * WARNING: This interface is deprecated. Use
+ * g_mime_object_add_header() instead.
  **/
 void
 g_mime_message_add_header (GMimeMessage *message, const char *header, const char *value)
@@ -1321,8 +1324,11 @@
  * @header: rfc822 header field
  * @value: the contents of the header field
  *
- * Set an arbitrary message header to the MIME Message such as X-Mailer,
- * X-Priority, or In-Reply-To.
+ * Set an arbitrary message header to the MIME Message such as
+ * X-Mailer, X-Priority, or In-Reply-To.
+ *
+ * WARNING: This interface is deprecated. Use
+ * g_mime_object_set_header().
  **/
 void
 g_mime_message_set_header (GMimeMessage *message, const char *header, const char *value)
@@ -1343,7 +1349,11 @@
  * Gets the value of the requested header @header if it exists, or
  * %NULL otherwise.
  *
- * Returns the value of the requested header (or %NULL if it isn't set)
+ * WARNING: This interface is deprecated. Use
+ * g_mime_message_get_header().
+ *
+ * Returns the value of the requested header (or %NULL if it isn't
+ * set)
  **/
 const char *
 g_mime_message_get_header (GMimeMessage *message, const char *header)
@@ -1550,6 +1560,9 @@
  *
  * Allocates a string buffer containing the raw message headers.
  *
+ * WARNING: This interface is deprecated. Use
+ * g_mime_object_get_headers() instead.
+ *
  * Returns an allocated string containing the raw message headers.
  **/
 char *

Modified: trunk/gmime/gmime-part.c
==============================================================================
--- trunk/gmime/gmime-part.c	(original)
+++ trunk/gmime/gmime-part.c	Sun May 25 13:59:33 2008
@@ -922,11 +922,28 @@
 
 
 /**
+ * g_mime_part_get_content_disposition_object:
+ * @mime_part: Mime part
+ *
+ * Get the content disposition for the specified mime part.
+ *
+ * Returns the #GMimeDisposition set on the mime part.
+ **/
+const GMimeDisposition *
+g_mime_part_get_content_disposition_object (GMimePart *mime_part)
+{
+	g_return_val_if_fail (GMIME_IS_PART (mime_part), NULL);
+	
+	return mime_part->disposition;
+}
+
+
+/**
  * g_mime_part_set_content_disposition_object:
  * @mime_part: Mime part
  * @disposition: disposition object
  *
- * Set the content disposition for the specified mime part
+ * Set the content disposition for the specified mime part.
  **/
 void
 g_mime_part_set_content_disposition_object (GMimePart *mime_part, GMimeDisposition *disposition)

Modified: trunk/gmime/gmime-part.h
==============================================================================
--- trunk/gmime/gmime-part.h	(original)
+++ trunk/gmime/gmime-part.h	Sun May 25 13:59:33 2008
@@ -91,6 +91,7 @@
 const char *g_mime_part_encoding_to_string (GMimePartEncodingType encoding);
 GMimePartEncodingType g_mime_part_encoding_from_string (const char *encoding);
 
+const GMimeDisposition *g_mime_part_get_content_disposition_object (GMimePart *mime_part);
 void g_mime_part_set_content_disposition_object (GMimePart *mime_part, GMimeDisposition *disposition);
 void g_mime_part_set_content_disposition (GMimePart *mime_part, const char *disposition);
 const char *g_mime_part_get_content_disposition (GMimePart *mime_part);