Updated the version to 0.7.0GMIME_0_7_0

2001-10-26  Jeffrey Stedfast  <fejj@ximian.com>

	* configure.in: Updated the version to 0.7.0

	* doc/*: Updated.

31 files changed, 278 insertions, 222 deletions

diff --git a/ChangeLog b/ChangeLog
index 929b1170..ba60ec44 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2001-10-26  Jeffrey Stedfast  <fejj@ximian.com>
+
+	* configure.in: Updated the version to 0.7.0
+
+	* doc/*: Updated.
+
 2001-10-25  Jeffrey Stedfast  <fejj@ximian.com>
 
 	* gmime-message.c (g_mime_message_new): Now takes an
diff --git a/config.h.in b/config.h.in
index a29fcfa0..4a32c189 100644
--- a/config.h.in
+++ b/config.h.in
@@ -1,37 +1,22 @@
 /* config.h.in.  Generated automatically from configure.in by autoheader.  */
 
-/* Name of package */
-#undef PACKAGE
-
-/* Version number of package */
-#undef VERSION
-
-/* Define if you need to in order for stat and other things to work.  */
-#undef _POSIX_SOURCE
+/* Define if you have the strftime function.  */
+#undef HAVE_STRFTIME
 
 /* Define if you have the ANSI C header files.  */
 #undef STDC_HEADERS
 
-/* Define if you have the <string.h> header file.  */
-#undef HAVE_STRING_H
-
-/* Define if you have the <stdlib.h> header file.  */
-#undef HAVE_STDLIB_H
-
-/* Define if you have the <ctype.h> header file.  */
-#undef HAVE_CTYPE_H
-
-/* Define if you have the <time.h> header file.  */
-#undef HAVE_TIME_H
-
-/* Define if you have the <alloca.h> header file.  */
-#undef HAVE_ALLOCA_H
-#ifdef HAVE_ALLOCA_H
-#include <alloca.h>
-#endif
+#undef STDC_HEADERS
 
 #undef HAVE_TIMEZONE
 #undef HAVE_TM_GMTOFF
+#undef HAVE_ISBLANK
+#undef HAVE_STRFTIME
+#undef HAVE_LOCALTIME
+#undef HAVE_ALLOCA
+
+/* Define if you have the alloca function.  */
+#undef HAVE_ALLOCA
 
 /* Define if you have the isblank function.  */
 #undef HAVE_ISBLANK
@@ -39,8 +24,27 @@
 /* Define if you have the localtime function.  */
 #undef HAVE_LOCALTIME
 
-/* Define if you have the strftime function.  */
-#undef HAVE_STRFTIME
+/* Define if you have the <alloca.h> header file.  */
+#undef HAVE_ALLOCA_H
+
+/* Define if you have the <ctype.h> header file.  */
+#undef HAVE_CTYPE_H
+
+/* Define if you have the <dlfcn.h> header file.  */
+#undef HAVE_DLFCN_H
+
+/* Define if you have the <stdlib.h> header file.  */
+#undef HAVE_STDLIB_H
+
+/* Define if you have the <string.h> header file.  */
+#undef HAVE_STRING_H
+
+/* Define if you have the <time.h> header file.  */
+#undef HAVE_TIME_H
+
+/* Name of package */
+#undef PACKAGE
+
+/* Version number of package */
+#undef VERSION
 
-/* Define if you have the alloca function.  */
-#undef HAVE_ALLOCA
diff --git a/configure.in b/configure.in
index f2178321..6350ad4d 100644
--- a/configure.in
+++ b/configure.in
@@ -11,7 +11,7 @@ AM_CONFIG_HEADER(config.h)
 # glib_libs:    libs to store in gmime-config
 
 GMIME_MAJOR_VERSION=0
-GMIME_MINOR_VERSION=6
+GMIME_MINOR_VERSION=7
 GMIME_MICRO_VERSION=0
 GMIME_VERSION=$GMIME_MAJOR_VERSION.$GMIME_MINOR_VERSION.$GMIME_MICRO_VERSION
 GMIME_VERSION_INFO=`expr $GMIME_MAJOR_VERSION + $GMIME_MINOR_VERSION`:$GMIME_MICRO_VERSION:$GMIME_MINOR_VERSION
diff --git a/doc/html/gmime-gmime-charset.html b/doc/html/gmime-gmime-charset.html
index cdd118aa..f79da6ff 100644
--- a/doc/html/gmime-gmime-charset.html
+++ b/doc/html/gmime-gmime-charset.html
@@ -111,7 +111,7 @@ NAME="GMIME-GMIME-CHARSET"
 ><DIV
 CLASS="REFNAMEDIV"
 ><A
-NAME="AEN5330"
+NAME="AEN5340"
 ></A
 ><H2
 >Name</H2
@@ -119,7 +119,7 @@ NAME="AEN5330"
 ><DIV
 CLASS="REFSYNOPSISDIV"
 ><A
-NAME="AEN5333"
+NAME="AEN5343"
 ></A
 ><H2
 >Synopsis</H2
@@ -149,7 +149,7 @@ HREF="gmime-gmime-charset.html#G-MIME-CHARSET-LOCALE-NAME"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN5338"
+NAME="AEN5348"
 ></A
 ><H2
 >Description</H2
@@ -159,14 +159,14 @@ NAME="AEN5338"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN5341"
+NAME="AEN5351"
 ></A
 ><H2
 >Details</H2
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5343"
+NAME="AEN5353"
 ></A
 ><H3
 ><A
@@ -196,7 +196,7 @@ iso-8859-1 locales.</P
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5349"
+NAME="AEN5359"
 ></A
 ><H3
 ><A
@@ -223,7 +223,7 @@ CLASS="PROGRAMLISTING"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN5355"
+NAME="AEN5365"
 ></A
 ><P
 ></P
diff --git a/doc/html/gmime-gmime-message.html b/doc/html/gmime-gmime-message.html
index d5e7e740..0d441447 100644
--- a/doc/html/gmime-gmime-message.html
+++ b/doc/html/gmime-gmime-message.html
@@ -176,7 +176,10 @@ HREF="gmime-gmime-message.html#GMIMEMESSAGE"
 >* <A
 HREF="gmime-gmime-message.html#G-MIME-MESSAGE-NEW"
 >g_mime_message_new</A
->            (void);
+>            (<GTKDOCLINK
+HREF="GBOOLEAN"
+>gboolean</GTKDOCLINK
+> pretty_headers);
 void        <A
 HREF="gmime-gmime-message.html#G-MIME-MESSAGE-DESTROY"
 >g_mime_message_destroy</A
@@ -477,7 +480,7 @@ HREF="GPOINTER"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN3564"
+NAME="AEN3565"
 ></A
 ><H2
 >Description</H2
@@ -487,14 +490,14 @@ NAME="AEN3564"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN3567"
+NAME="AEN3568"
 ></A
 ><H2
 >Details</H2
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3569"
+NAME="AEN3570"
 ></A
 ><H3
 ><A
@@ -520,7 +523,7 @@ CLASS="PROGRAMLISTING"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3574"
+NAME="AEN3575"
 ></A
 ><H3
 ><A
@@ -546,7 +549,7 @@ CLASS="PROGRAMLISTING"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3579"
+NAME="AEN3580"
 ></A
 ><H3
 ><A
@@ -572,7 +575,7 @@ CLASS="PROGRAMLISTING"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3584"
+NAME="AEN3585"
 ></A
 ><H3
 ><A
@@ -598,7 +601,7 @@ CLASS="PROGRAMLISTING"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3589"
+NAME="AEN3590"
 ></A
 ><H3
 ><A
@@ -638,7 +641,7 @@ CLASS="PROGRAMLISTING"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3594"
+NAME="AEN3595"
 ></A
 ><H3
 ><A
@@ -668,7 +671,7 @@ CLASS="PROGRAMLISTING"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3599"
+NAME="AEN3600"
 ></A
 ><H3
 ><A
@@ -687,18 +690,38 @@ CLASS="PROGRAMLISTING"
 ><A
 HREF="gmime-gmime-message.html#GMIMEMESSAGE"
 >GMimeMessage</A
->* g_mime_message_new            (void);</PRE
+>* g_mime_message_new            (<GTKDOCLINK
+HREF="GBOOLEAN"
+>gboolean</GTKDOCLINK
+> pretty_headers);</PRE
 ></TD
 ></TR
 ></TABLE
 ><P
-></P
+>If <TT
+CLASS="PARAMETER"
+><I
+>pretty_headers</I
+></TT
+> is <TT
+CLASS="LITERAL"
+>TRUE</TT
+>, then the standard rfc822 headers are
+initialized so as to put headers in a nice friendly order. This is
+strictly a cosmetic thing, so if you are unsure, it is safe to say
+<TT
+CLASS="LITERAL"
+>no</TT
+> (<TT
+CLASS="LITERAL"
+>FALSE</TT
+>).</P
 ><P
 ></P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3606"
+NAME="AEN3612"
 ></A
 ><P
 ></P
@@ -715,6 +738,23 @@ CLASS="CALSTABLE"
 WIDTH="20%"
 ALIGN="RIGHT"
 VALIGN="TOP"
+><TT
+CLASS="PARAMETER"
+><I
+>pretty_headers</I
+></TT
+>&nbsp;:</TD
+><TD
+WIDTH="80%"
+ALIGN="LEFT"
+VALIGN="TOP"
+> make pretty headers </TD
+></TR
+><TR
+><TD
+WIDTH="20%"
+ALIGN="RIGHT"
+VALIGN="TOP"
 ><I
 CLASS="EMPHASIS"
 >Returns</I
@@ -723,8 +763,7 @@ CLASS="EMPHASIS"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->an empty MIME Message object with no headers nor content
-set by default.</TD
+>an empty MIME Message object.</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -735,7 +774,7 @@ set by default.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3615"
+NAME="AEN3625"
 ></A
 ><H3
 ><A
@@ -766,7 +805,7 @@ Parts back to the Operating System for reuse.</P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3622"
+NAME="AEN3632"
 ></A
 ><P
 ></P
@@ -804,7 +843,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3631"
+NAME="AEN3641"
 ></A
 ><H3
 ><A
@@ -844,7 +883,7 @@ CLASS="PARAMETER"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3640"
+NAME="AEN3650"
 ></A
 ><P
 ></P
@@ -899,7 +938,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3653"
+NAME="AEN3663"
 ></A
 ><H3
 ><A
@@ -932,7 +971,7 @@ HREF="gmime-gmime-message.html#GMIMEMESSAGE"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3661"
+NAME="AEN3671"
 ></A
 ><P
 ></P
@@ -985,7 +1024,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3674"
+NAME="AEN3684"
 ></A
 ><H3
 ><A
@@ -1019,7 +1058,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3682"
+NAME="AEN3692"
 ></A
 ><P
 ></P
@@ -1074,7 +1113,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3695"
+NAME="AEN3705"
 ></A
 ><H3
 ><A
@@ -1107,7 +1146,7 @@ HREF="gmime-gmime-message.html#GMIMEMESSAGE"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3703"
+NAME="AEN3713"
 ></A
 ><P
 ></P
@@ -1160,7 +1199,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3716"
+NAME="AEN3726"
 ></A
 ><H3
 ><A
@@ -1204,7 +1243,7 @@ GMIME_RECIPIENT_TYPE_CC and GMIME_RECIPIENT_TYPE_BCC.</P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3726"
+NAME="AEN3736"
 ></A
 ><P
 ></P
@@ -1293,7 +1332,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3747"
+NAME="AEN3757"
 ></A
 ><H3
 ><A
@@ -1336,7 +1375,7 @@ specified in rfc822.</P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3756"
+NAME="AEN3766"
 ></A
 ><P
 ></P
@@ -1408,7 +1447,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3773"
+NAME="AEN3783"
 ></A
 ><H3
 ><A
@@ -1445,7 +1484,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3782"
+NAME="AEN3792"
 ></A
 ><P
 ></P
@@ -1518,7 +1557,7 @@ GMIME_RECIPIENT_TYPE_BCC.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3799"
+NAME="AEN3809"
 ></A
 ><H3
 ><A
@@ -1552,7 +1591,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3807"
+NAME="AEN3817"
 ></A
 ><P
 ></P
@@ -1607,7 +1646,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3820"
+NAME="AEN3830"
 ></A
 ><H3
 ><A
@@ -1640,7 +1679,7 @@ HREF="gmime-gmime-message.html#GMIMEMESSAGE"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3828"
+NAME="AEN3838"
 ></A
 ><P
 ></P
@@ -1693,7 +1732,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3841"
+NAME="AEN3851"
 ></A
 ><H3
 ><A
@@ -1728,7 +1767,7 @@ HREF="TIME-T"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3849"
+NAME="AEN3859"
 ></A
 ><P
 ></P
@@ -1800,7 +1839,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3866"
+NAME="AEN3876"
 ></A
 ><H3
 ><A
@@ -1842,7 +1881,7 @@ HREF="GMT-OFFSET"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3876"
+NAME="AEN3886"
 ></A
 ><P
 ></P
@@ -1914,7 +1953,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3893"
+NAME="AEN3903"
 ></A
 ><H3
 ><A
@@ -1947,7 +1986,7 @@ HREF="gmime-gmime-message.html#GMIMEMESSAGE"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3901"
+NAME="AEN3911"
 ></A
 ><P
 ></P
@@ -2000,7 +2039,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3914"
+NAME="AEN3924"
 ></A
 ><H3
 ><A
@@ -2034,7 +2073,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3922"
+NAME="AEN3932"
 ></A
 ><P
 ></P
@@ -2089,7 +2128,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3935"
+NAME="AEN3945"
 ></A
 ><H3
 ><A
@@ -2122,7 +2161,7 @@ HREF="gmime-gmime-message.html#GMIMEMESSAGE"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3943"
+NAME="AEN3953"
 ></A
 ><P
 ></P
@@ -2175,7 +2214,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3956"
+NAME="AEN3966"
 ></A
 ><H3
 ><A
@@ -2214,7 +2253,7 @@ X-Priority, or In-Reply-To.</P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3965"
+NAME="AEN3975"
 ></A
 ><P
 ></P
@@ -2286,7 +2325,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN3982"
+NAME="AEN3992"
 ></A
 ><H3
 ><A
@@ -2325,7 +2364,7 @@ X-Priority, or In-Reply-To.</P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN3991"
+NAME="AEN4001"
 ></A
 ><P
 ></P
@@ -2397,7 +2436,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4008"
+NAME="AEN4018"
 ></A
 ><H3
 ><A
@@ -2434,7 +2473,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4017"
+NAME="AEN4027"
 ></A
 ><P
 ></P
@@ -2504,7 +2543,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4034"
+NAME="AEN4044"
 ></A
 ><H3
 ><A
@@ -2538,7 +2577,7 @@ HREF="gmime-gmime-part.html#GMIMEPART"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4042"
+NAME="AEN4052"
 ></A
 ><P
 ></P
@@ -2593,7 +2632,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4055"
+NAME="AEN4065"
 ></A
 ><H3
 ><A
@@ -2632,7 +2671,7 @@ CLASS="PARAMETER"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4064"
+NAME="AEN4074"
 ></A
 ><P
 ></P
@@ -2687,7 +2726,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4077"
+NAME="AEN4087"
 ></A
 ><H3
 ><A
@@ -2720,7 +2759,7 @@ HREF="gmime-gmime-message.html#GMIMEMESSAGE"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4085"
+NAME="AEN4095"
 ></A
 ><P
 ></P
@@ -2773,7 +2812,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4098"
+NAME="AEN4108"
 ></A
 ><H3
 ><A
@@ -2814,7 +2853,7 @@ HREF="GBOOLEAN"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4108"
+NAME="AEN4118"
 ></A
 ><P
 ></P
@@ -2909,7 +2948,7 @@ recommended that you traverse the MIME structure yourself.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4130"
+NAME="AEN4140"
 ></A
 ><H3
 ><A
@@ -2942,7 +2981,7 @@ HREF="gmime-gmime-message.html#GMIMEMESSAGE"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4138"
+NAME="AEN4148"
 ></A
 ><P
 ></P
@@ -2995,7 +3034,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4151"
+NAME="AEN4161"
 ></A
 ><H3
 ><A
@@ -3036,7 +3075,7 @@ HREF="CALLBACK"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4161"
+NAME="AEN4171"
 ></A
 ><P
 ></P
diff --git a/doc/html/gmime-gmime-parser.html b/doc/html/gmime-gmime-parser.html
index 1a70e0cb..8afb1bb0 100644
--- a/doc/html/gmime-gmime-parser.html
+++ b/doc/html/gmime-gmime-parser.html
@@ -123,7 +123,7 @@ NAME="GMIME-GMIME-PARSER"
 ><DIV
 CLASS="REFNAMEDIV"
 ><A
-NAME="AEN5260"
+NAME="AEN5270"
 ></A
 ><H2
 >Name</H2
@@ -131,7 +131,7 @@ NAME="AEN5260"
 ><DIV
 CLASS="REFSYNOPSISDIV"
 ><A
-NAME="AEN5263"
+NAME="AEN5273"
 ></A
 ><H2
 >Synopsis</H2
@@ -178,7 +178,7 @@ HREF="GBOOLEAN"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN5273"
+NAME="AEN5283"
 ></A
 ><H2
 >Description</H2
@@ -188,14 +188,14 @@ NAME="AEN5273"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN5276"
+NAME="AEN5286"
 ></A
 ><H2
 >Details</H2
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5278"
+NAME="AEN5288"
 ></A
 ><H3
 ><A
@@ -228,7 +228,7 @@ HREF="gmime-gmime-stream.html#GMIMESTREAM"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN5286"
+NAME="AEN5296"
 ></A
 ><P
 ></P
@@ -281,7 +281,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5299"
+NAME="AEN5309"
 ></A
 ><H3
 ><A
@@ -319,7 +319,7 @@ HREF="GBOOLEAN"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN5308"
+NAME="AEN5318"
 ></A
 ><P
 ></P
diff --git a/doc/html/gmime-gmime-utils.html b/doc/html/gmime-gmime-utils.html
index 09d8afa7..037360f1 100644
--- a/doc/html/gmime-gmime-utils.html
+++ b/doc/html/gmime-gmime-utils.html
@@ -123,7 +123,7 @@ NAME="GMIME-GMIME-UTILS"
 ><DIV
 CLASS="REFNAMEDIV"
 ><A
-NAME="AEN4183"
+NAME="AEN4193"
 ></A
 ><H2
 >Name</H2
@@ -131,7 +131,7 @@ NAME="AEN4183"
 ><DIV
 CLASS="REFSYNOPSISDIV"
 ><A
-NAME="AEN4186"
+NAME="AEN4196"
 ></A
 ><H2
 >Synopsis</H2
@@ -543,7 +543,7 @@ HREF="GINT"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN4295"
+NAME="AEN4305"
 ></A
 ><H2
 >Description</H2
@@ -553,14 +553,14 @@ NAME="AEN4295"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN4298"
+NAME="AEN4308"
 ></A
 ><H2
 >Details</H2
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4300"
+NAME="AEN4310"
 ></A
 ><H3
 ><A
@@ -585,7 +585,7 @@ CLASS="PROGRAMLISTING"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4305"
+NAME="AEN4315"
 ></A
 ><P
 ></P
@@ -623,7 +623,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4314"
+NAME="AEN4324"
 ></A
 ><H3
 ><A
@@ -648,7 +648,7 @@ CLASS="PROGRAMLISTING"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4319"
+NAME="AEN4329"
 ></A
 ><P
 ></P
@@ -686,7 +686,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4328"
+NAME="AEN4338"
 ></A
 ><H3
 ><A
@@ -723,7 +723,7 @@ HREF="GINT"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4337"
+NAME="AEN4347"
 ></A
 ><P
 ></P
@@ -798,7 +798,7 @@ will be stored.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4355"
+NAME="AEN4365"
 ></A
 ><H3
 ><A
@@ -835,7 +835,7 @@ HREF="GINT"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4364"
+NAME="AEN4374"
 ></A
 ><P
 ></P
@@ -905,7 +905,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4381"
+NAME="AEN4391"
 ></A
 ><H3
 ><A
@@ -938,7 +938,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4389"
+NAME="AEN4399"
 ></A
 ><P
 ></P
@@ -991,7 +991,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4402"
+NAME="AEN4412"
 ></A
 ><H3
 ><A
@@ -1025,7 +1025,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4410"
+NAME="AEN4420"
 ></A
 ><P
 ></P
@@ -1099,7 +1099,7 @@ HREF="FORMAT"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4428"
+NAME="AEN4438"
 ></A
 ><H3
 ><A
@@ -1132,7 +1132,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4436"
+NAME="AEN4446"
 ></A
 ><P
 ></P
@@ -1188,7 +1188,7 @@ as defined by rfc2045.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4449"
+NAME="AEN4459"
 ></A
 ><H3
 ><A
@@ -1218,7 +1218,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4456"
+NAME="AEN4466"
 ></A
 ><P
 ></P
@@ -1256,7 +1256,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4465"
+NAME="AEN4475"
 ></A
 ><H3
 ><A
@@ -1293,7 +1293,7 @@ HREF="GUINT"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4474"
+NAME="AEN4484"
 ></A
 ><P
 ></P
@@ -1364,7 +1364,7 @@ otherwise.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4491"
+NAME="AEN4501"
 ></A
 ><H3
 ><A
@@ -1402,7 +1402,7 @@ HREF="GUINT"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4500"
+NAME="AEN4510"
 ></A
 ><P
 ></P
@@ -1474,7 +1474,7 @@ particular case means best compression)</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4517"
+NAME="AEN4527"
 ></A
 ><H3
 ><A
@@ -1507,7 +1507,7 @@ HREF="GUCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4525"
+NAME="AEN4535"
 ></A
 ><P
 ></P
@@ -1560,7 +1560,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4538"
+NAME="AEN4548"
 ></A
 ><H3
 ><A
@@ -1593,7 +1593,7 @@ HREF="GUCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4546"
+NAME="AEN4556"
 ></A
 ><P
 ></P
@@ -1647,7 +1647,7 @@ headers like "Subject".</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4559"
+NAME="AEN4569"
 ></A
 ><H3
 ><A
@@ -1681,7 +1681,7 @@ HREF="GUCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4567"
+NAME="AEN4577"
 ></A
 ><P
 ></P
@@ -1735,7 +1735,7 @@ internet addresses.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4580"
+NAME="AEN4590"
 ></A
 ><H3
 ><A
@@ -1784,7 +1784,7 @@ HREF="GUINT32"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4592"
+NAME="AEN4602"
 ></A
 ><P
 ></P
@@ -1913,7 +1913,7 @@ HREF="OUT"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4623"
+NAME="AEN4633"
 ></A
 ><H3
 ><A
@@ -1962,7 +1962,7 @@ HREF="GUINT32"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4635"
+NAME="AEN4645"
 ></A
 ><P
 ></P
@@ -2091,7 +2091,7 @@ invocation).</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4665"
+NAME="AEN4675"
 ></A
 ><H3
 ><A
@@ -2141,7 +2141,7 @@ HREF="GUINT32"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4677"
+NAME="AEN4687"
 ></A
 ><P
 ></P
@@ -2269,7 +2269,7 @@ bit.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4707"
+NAME="AEN4717"
 ></A
 ><H3
 ><A
@@ -2322,7 +2322,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4720"
+NAME="AEN4730"
 ></A
 ><P
 ></P
@@ -2468,7 +2468,7 @@ line has been stripped off.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4754"
+NAME="AEN4764"
 ></A
 ><H3
 ><A
@@ -2525,7 +2525,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4768"
+NAME="AEN4778"
 ></A
 ><P
 ></P
@@ -2704,7 +2704,7 @@ invocation).</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4809"
+NAME="AEN4819"
 ></A
 ><H3
 ><A
@@ -2761,7 +2761,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4823"
+NAME="AEN4833"
 ></A
 ><P
 ></P
@@ -2924,7 +2924,7 @@ bit.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4861"
+NAME="AEN4871"
 ></A
 ><H3
 ><A
@@ -2973,7 +2973,7 @@ HREF="GINT"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4873"
+NAME="AEN4883"
 ></A
 ><P
 ></P
@@ -3100,7 +3100,7 @@ chunk of QP encoded data.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4903"
+NAME="AEN4913"
 ></A
 ><H3
 ><A
@@ -3149,7 +3149,7 @@ HREF="GINT"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4915"
+NAME="AEN4925"
 ></A
 ><P
 ></P
@@ -3277,7 +3277,7 @@ invocation).</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN4945"
+NAME="AEN4955"
 ></A
 ><H3
 ><A
@@ -3327,7 +3327,7 @@ HREF="GINT"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN4957"
+NAME="AEN4967"
 ></A
 ><P
 ></P
diff --git a/doc/html/gmime-internet-address.html b/doc/html/gmime-internet-address.html
index be6be2b2..bb7943c7 100644
--- a/doc/html/gmime-internet-address.html
+++ b/doc/html/gmime-internet-address.html
@@ -123,7 +123,7 @@ NAME="GMIME-INTERNET-ADDRESS"
 ><DIV
 CLASS="REFNAMEDIV"
 ><A
-NAME="AEN4992"
+NAME="AEN5002"
 ></A
 ><H2
 >Name</H2
@@ -131,7 +131,7 @@ NAME="AEN4992"
 ><DIV
 CLASS="REFSYNOPSISDIV"
 ><A
-NAME="AEN4995"
+NAME="AEN5005"
 ></A
 ><H2
 >Synopsis</H2
@@ -267,7 +267,7 @@ HREF="GBOOLEAN"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN5030"
+NAME="AEN5040"
 ></A
 ><H2
 >Description</H2
@@ -277,14 +277,14 @@ NAME="AEN5030"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN5033"
+NAME="AEN5043"
 ></A
 ><H2
 >Details</H2
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5035"
+NAME="AEN5045"
 ></A
 ><H3
 ><A
@@ -314,7 +314,7 @@ CLASS="PROGRAMLISTING"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5040"
+NAME="AEN5050"
 ></A
 ><H3
 ><A
@@ -347,7 +347,7 @@ CLASS="PROGRAMLISTING"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5045"
+NAME="AEN5055"
 ></A
 ><H3
 ><A
@@ -377,7 +377,7 @@ HREF="gmime-internet-address.html#INTERNETADDRESS"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN5052"
+NAME="AEN5062"
 ></A
 ><P
 ></P
@@ -413,7 +413,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5061"
+NAME="AEN5071"
 ></A
 ><H3
 ><A
@@ -450,7 +450,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN5070"
+NAME="AEN5080"
 ></A
 ><P
 ></P
@@ -520,7 +520,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5087"
+NAME="AEN5097"
 ></A
 ><H3
 ><A
@@ -553,7 +553,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN5095"
+NAME="AEN5105"
 ></A
 ><P
 ></P
@@ -606,7 +606,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5108"
+NAME="AEN5118"
 ></A
 ><H3
 ><A
@@ -641,7 +641,7 @@ CLASS="PARAMETER"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN5116"
+NAME="AEN5126"
 ></A
 ><P
 ></P
@@ -679,7 +679,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5125"
+NAME="AEN5135"
 ></A
 ><H3
 ><A
@@ -713,7 +713,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN5133"
+NAME="AEN5143"
 ></A
 ><P
 ></P
@@ -768,7 +768,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5146"
+NAME="AEN5156"
 ></A
 ><H3
 ><A
@@ -802,7 +802,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN5154"
+NAME="AEN5164"
 ></A
 ><P
 ></P
@@ -857,7 +857,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5167"
+NAME="AEN5177"
 ></A
 ><H3
 ><A
@@ -891,7 +891,7 @@ HREF="GLIST"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN5175"
+NAME="AEN5185"
 ></A
 ><P
 ></P
@@ -946,7 +946,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5188"
+NAME="AEN5198"
 ></A
 ><H3
 ><A
@@ -980,7 +980,7 @@ HREF="gmime-internet-address.html#INTERNETADDRESS"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN5196"
+NAME="AEN5206"
 ></A
 ><P
 ></P
@@ -1035,7 +1035,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5209"
+NAME="AEN5219"
 ></A
 ><H3
 ><A
@@ -1066,7 +1066,7 @@ HREF="GCHAR"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN5216"
+NAME="AEN5226"
 ></A
 ><P
 ></P
@@ -1119,7 +1119,7 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN5229"
+NAME="AEN5239"
 ></A
 ><H3
 ><A
@@ -1156,7 +1156,7 @@ HREF="GBOOLEAN"
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN5238"
+NAME="AEN5248"
 ></A
 ><P
 ></P
diff --git a/doc/sgml/gmime-charset.sgml b/doc/sgml/gmime-charset.sgml
index 1f2371bb..8bdf2df0 100644
--- a/doc/sgml/gmime-charset.sgml
+++ b/doc/sgml/gmime-charset.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-charset" revision="24 Oct 2001">
+<refentry id="gmime-gmime-charset" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-charset</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-content-type.sgml b/doc/sgml/gmime-content-type.sgml
index bd785ccf..2d99cb13 100644
--- a/doc/sgml/gmime-content-type.sgml
+++ b/doc/sgml/gmime-content-type.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-content-type" revision="24 Oct 2001">
+<refentry id="gmime-gmime-content-type" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-content-type</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-data-wrapper.sgml b/doc/sgml/gmime-data-wrapper.sgml
index c46ee880..860c698b 100644
--- a/doc/sgml/gmime-data-wrapper.sgml
+++ b/doc/sgml/gmime-data-wrapper.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-data-wrapper" revision="24 Oct 2001">
+<refentry id="gmime-gmime-data-wrapper" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-data-wrapper</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-filter-basic.sgml b/doc/sgml/gmime-filter-basic.sgml
index 3cd219a6..fdadc855 100644
--- a/doc/sgml/gmime-filter-basic.sgml
+++ b/doc/sgml/gmime-filter-basic.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-filter-basic" revision="24 Oct 2001">
+<refentry id="gmime-gmime-filter-basic" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-filter-basic</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-filter-crlf.sgml b/doc/sgml/gmime-filter-crlf.sgml
index 65f2d5c6..39dfa7ee 100644
--- a/doc/sgml/gmime-filter-crlf.sgml
+++ b/doc/sgml/gmime-filter-crlf.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-filter-crlf" revision="24 Oct 2001">
+<refentry id="gmime-gmime-filter-crlf" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-filter-crlf</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-filter.sgml b/doc/sgml/gmime-filter.sgml
index 1e334a25..29fe9739 100644
--- a/doc/sgml/gmime-filter.sgml
+++ b/doc/sgml/gmime-filter.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-filter" revision="24 Oct 2001">
+<refentry id="gmime-gmime-filter" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-filter</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-header.sgml b/doc/sgml/gmime-header.sgml
index ce25113f..4d5fe58c 100644
--- a/doc/sgml/gmime-header.sgml
+++ b/doc/sgml/gmime-header.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-header" revision="24 Oct 2001">
+<refentry id="gmime-gmime-header" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-header</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-message.sgml b/doc/sgml/gmime-message.sgml
index 69f1cc0f..8436b30b 100644
--- a/doc/sgml/gmime-message.sgml
+++ b/doc/sgml/gmime-message.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-message" revision="24 Oct 2001">
+<refentry id="gmime-gmime-message" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-message</refentrytitle>
 <manvolnum>3</manvolnum>
@@ -20,7 +20,7 @@
 struct      <link linkend="GMimeHeader">GMimeHeader</link>;
 struct      <link linkend="GMimeMessageHeader">GMimeMessageHeader</link>;
 struct      <link linkend="GMimeMessage">GMimeMessage</link>;
-<link linkend="GMimeMessage">GMimeMessage</link>* <link linkend="g-mime-message-new">g_mime_message_new</link>            (void);
+<link linkend="GMimeMessage">GMimeMessage</link>* <link linkend="g-mime-message-new">g_mime_message_new</link>            (<link linkend="gboolean">gboolean</link> pretty_headers);
 void        <link linkend="g-mime-message-destroy">g_mime_message_destroy</link>          (<link linkend="GMimeMessage">GMimeMessage</link> *message);
 void        <link linkend="g-mime-message-set-sender">g_mime_message_set_sender</link>       (<link linkend="GMimeMessage">GMimeMessage</link> *message,
                                              const <link linkend="gchar">gchar</link> *sender);
@@ -148,9 +148,12 @@ void        <link linkend="g-mime-message-foreach-part">g_mime_message_foreach_p
 </para></refsect2>
 <refsect2>
 <title><anchor id="g-mime-message-new">g_mime_message_new ()</title>
-<programlisting><link linkend="GMimeMessage">GMimeMessage</link>* g_mime_message_new            (void);</programlisting>
+<programlisting><link linkend="GMimeMessage">GMimeMessage</link>* g_mime_message_new            (<link linkend="gboolean">gboolean</link> pretty_headers);</programlisting>
 <para>
-</para>
+If <parameter>pretty_headers</parameter> is <literal>TRUE</literal>, then the standard rfc822 headers are
+initialized so as to put headers in a nice friendly order. This is
+strictly a cosmetic thing, so if you are unsure, it is safe to say
+<literal>no</literal> (<literal>FALSE</literal>).</para>
 <para>
 
 </para><informaltable pgwide=1 frame="none" role="params">
@@ -158,8 +161,10 @@ void        <link linkend="g-mime-message-foreach-part">g_mime_message_foreach_p
 <colspec colwidth="2*">
 <colspec colwidth="8*">
 <tbody>
-<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>an empty MIME Message object with no headers nor content
-set by default.
+<row><entry align="right"><parameter>pretty_headers</parameter>&nbsp;:</entry>
+<entry> make pretty headers 
+</entry></row>
+<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>an empty MIME Message object.
 </entry></row>
 </tbody></tgroup></informaltable></refsect2>
 <refsect2>
diff --git a/doc/sgml/gmime-param.sgml b/doc/sgml/gmime-param.sgml
index e285c9a5..0f7a65b7 100644
--- a/doc/sgml/gmime-param.sgml
+++ b/doc/sgml/gmime-param.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-param" revision="24 Oct 2001">
+<refentry id="gmime-gmime-param" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-param</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-parser.sgml b/doc/sgml/gmime-parser.sgml
index 04f84472..99b68805 100644
--- a/doc/sgml/gmime-parser.sgml
+++ b/doc/sgml/gmime-parser.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-parser" revision="24 Oct 2001">
+<refentry id="gmime-gmime-parser" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-parser</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-part.sgml b/doc/sgml/gmime-part.sgml
index 995c097b..5eeaaf9e 100644
--- a/doc/sgml/gmime-part.sgml
+++ b/doc/sgml/gmime-part.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-part" revision="24 Oct 2001">
+<refentry id="gmime-gmime-part" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-part</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-stream-buffer.sgml b/doc/sgml/gmime-stream-buffer.sgml
index 34fdc66a..fbea847b 100644
--- a/doc/sgml/gmime-stream-buffer.sgml
+++ b/doc/sgml/gmime-stream-buffer.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-stream-buffer" revision="24 Oct 2001">
+<refentry id="gmime-gmime-stream-buffer" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-stream-buffer</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-stream-file.sgml b/doc/sgml/gmime-stream-file.sgml
index ffcf720f..003c2bc8 100644
--- a/doc/sgml/gmime-stream-file.sgml
+++ b/doc/sgml/gmime-stream-file.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-stream-file" revision="24 Oct 2001">
+<refentry id="gmime-gmime-stream-file" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-stream-file</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-stream-filter.sgml b/doc/sgml/gmime-stream-filter.sgml
index 1ca71294..9be16cfc 100644
--- a/doc/sgml/gmime-stream-filter.sgml
+++ b/doc/sgml/gmime-stream-filter.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-stream-filter" revision="24 Oct 2001">
+<refentry id="gmime-gmime-stream-filter" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-stream-filter</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-stream-fs.sgml b/doc/sgml/gmime-stream-fs.sgml
index 229f899b..252c7e94 100644
--- a/doc/sgml/gmime-stream-fs.sgml
+++ b/doc/sgml/gmime-stream-fs.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-stream-fs" revision="24 Oct 2001">
+<refentry id="gmime-gmime-stream-fs" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-stream-fs</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-stream-mem.sgml b/doc/sgml/gmime-stream-mem.sgml
index dfb5403f..d2f2a43c 100644
--- a/doc/sgml/gmime-stream-mem.sgml
+++ b/doc/sgml/gmime-stream-mem.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-stream-mem" revision="24 Oct 2001">
+<refentry id="gmime-gmime-stream-mem" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-stream-mem</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-stream.sgml b/doc/sgml/gmime-stream.sgml
index c701a30b..86dc4ae4 100644
--- a/doc/sgml/gmime-stream.sgml
+++ b/doc/sgml/gmime-stream.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-stream" revision="24 Oct 2001">
+<refentry id="gmime-gmime-stream" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-stream</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/gmime-utils.sgml b/doc/sgml/gmime-utils.sgml
index 76a73073..b8c7b0d0 100644
--- a/doc/sgml/gmime-utils.sgml
+++ b/doc/sgml/gmime-utils.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-gmime-utils" revision="24 Oct 2001">
+<refentry id="gmime-gmime-utils" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>gmime-utils</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/doc/sgml/internet-address.sgml b/doc/sgml/internet-address.sgml
index 5ee1bff7..3dab1000 100644
--- a/doc/sgml/internet-address.sgml
+++ b/doc/sgml/internet-address.sgml
@@ -1,4 +1,4 @@
-<refentry id="gmime-internet-address" revision="24 Oct 2001">
+<refentry id="gmime-internet-address" revision="25 Oct 2001">
 <refmeta>
 <refentrytitle>internet-address</refentrytitle>
 <manvolnum>3</manvolnum>
diff --git a/gmime-message.c b/gmime-message.c
index f3bef64a..3c12d4a3 100644
--- a/gmime-message.c
+++ b/gmime-message.c
@@ -50,16 +50,17 @@ static char *rfc822_headers[] = {
 
 /**
  * g_mime_message_new: Create a new MIME Message object
- * @init_headers: initialize the headers 
+ * @pretty_headers: make pretty headers 
  *
- * If @init_headers is %TRUE, then the standard rfc822 headers are
- * initialized so as to put headers in a nice friendly order.
+ * If @pretty_headers is %TRUE, then the standard rfc822 headers are
+ * initialized so as to put headers in a nice friendly order. This is
+ * strictly a cosmetic thing, so if you are unsure, it is safe to say
+ * %no (%FALSE).
  *
- * Returns an empty MIME Message object with no headers nor content
- * set by default.
+ * Returns an empty MIME Message object.
  **/
 GMimeMessage *
-g_mime_message_new (gboolean init_headers)
+g_mime_message_new (gboolean pretty_headers)
 {
 	GMimeMessage *message;
 	GMimeHeader *headers;
@@ -73,7 +74,7 @@ g_mime_message_new (gboolean init_headers)
 	
 	message->header->headers = headers = g_mime_header_new ();
 	
-	if (init_headers) {
+	if (pretty_headers) {
 		/* Populate with the "standard" rfc822 headers so we can have a standard order */
 		for (i = 0; rfc822_headers[i]; i++) 
 			g_mime_header_set (headers, rfc822_headers[i], NULL);
diff --git a/gmime-message.h b/gmime-message.h
index df1b9073..9110b013 100644
--- a/gmime-message.h
+++ b/gmime-message.h
@@ -66,7 +66,7 @@ struct _GMimeMessage {
 
 typedef struct _GMimeMessage GMimeMessage;
 
-GMimeMessage *g_mime_message_new (gboolean init_headers);
+GMimeMessage *g_mime_message_new (gboolean pretty_headers);
 void g_mime_message_destroy (GMimeMessage *message);
 
 void g_mime_message_set_sender (GMimeMessage *message, const gchar *sender);
diff --git a/gmime/gmime-message.c b/gmime/gmime-message.c
index f3bef64a..3c12d4a3 100644
--- a/gmime/gmime-message.c
+++ b/gmime/gmime-message.c
@@ -50,16 +50,17 @@ static char *rfc822_headers[] = {
 
 /**
  * g_mime_message_new: Create a new MIME Message object
- * @init_headers: initialize the headers 
+ * @pretty_headers: make pretty headers 
  *
- * If @init_headers is %TRUE, then the standard rfc822 headers are
- * initialized so as to put headers in a nice friendly order.
+ * If @pretty_headers is %TRUE, then the standard rfc822 headers are
+ * initialized so as to put headers in a nice friendly order. This is
+ * strictly a cosmetic thing, so if you are unsure, it is safe to say
+ * %no (%FALSE).
  *
- * Returns an empty MIME Message object with no headers nor content
- * set by default.
+ * Returns an empty MIME Message object.
  **/
 GMimeMessage *
-g_mime_message_new (gboolean init_headers)
+g_mime_message_new (gboolean pretty_headers)
 {
 	GMimeMessage *message;
 	GMimeHeader *headers;
@@ -73,7 +74,7 @@ g_mime_message_new (gboolean init_headers)
 	
 	message->header->headers = headers = g_mime_header_new ();
 	
-	if (init_headers) {
+	if (pretty_headers) {
 		/* Populate with the "standard" rfc822 headers so we can have a standard order */
 		for (i = 0; rfc822_headers[i]; i++) 
 			g_mime_header_set (headers, rfc822_headers[i], NULL);
diff --git a/gmime/gmime-message.h b/gmime/gmime-message.h
index df1b9073..9110b013 100644
--- a/gmime/gmime-message.h
+++ b/gmime/gmime-message.h
@@ -66,7 +66,7 @@ struct _GMimeMessage {
 
 typedef struct _GMimeMessage GMimeMessage;
 
-GMimeMessage *g_mime_message_new (gboolean init_headers);
+GMimeMessage *g_mime_message_new (gboolean pretty_headers);
 void g_mime_message_destroy (GMimeMessage *message);
 
 void g_mime_message_set_sender (GMimeMessage *message, const gchar *sender);