[evolution-data-server/gnome-2-30] Clarify documentation for e_destination_get_address().

[Matthew Barnes <mbarnes src gnome org>]

commit 401acdc820a1d808b83aaccc1d2db7ed76ad8c23
Author: Matthew Barnes <mbarnes redhat com>
Date:   Mon Jun 21 11:21:41 2010 -0400

    Clarify documentation for e_destination_get_address().

 addressbook/libebook/e-destination.c |    8 +++++---
 1 files changed, 5 insertions(+), 3 deletions(-)
---
diff --git a/addressbook/libebook/e-destination.c b/addressbook/libebook/e-destination.c
index 6ed9870..2b070c9 100644
--- a/addressbook/libebook/e-destination.c
+++ b/addressbook/libebook/e-destination.c
@@ -842,10 +842,12 @@ e_destination_get_email (const EDestination *dest)
  * e_destination_get_address:
  * @dest: an #EDestination
  *
- * Gets the formatted name and e-mail address, or in the case of
- * lists, the formatted list of e-mail addresses, from @dest.
+ * Gets the encoded name and email address, or in the case of lists, the
+ * encoded list of email addresses, from @dest.  The returned string is
+ * suitable for use in an email header, but not for displaying to users.
  *
- * Returns: A formatted destination string, or %NULL if the destination was empty.
+ * Returns: an encoded destination string suitable for use in an
+ *          email header, or %NULL if the destination was empty
  **/
 const gchar *
 e_destination_get_address (const EDestination *dest)