aboutsummaryrefslogtreecommitdiffhomepage
path: root/lib
diff options
context:
space:
mode:
authorGravatar Austin Clements <amdragon@MIT.EDU>2013-08-12 14:40:35 -0400
committerGravatar David Bremner <bremner@debian.org>2013-08-13 17:43:34 +0200
commit3fbb518335fe2271a31a6c4779affa4df42cf203 (patch)
tree55808170911626ec8d86fbc49ce0179ad286a7aa /lib
parenta7bf045fb178b5ed48e71269427cec42c21f8cd6 (diff)
lib: Document which strings are returned in UTF-8
Any string that ultimately comes from notmuch_message_file_get_header is in UTF-8.
Diffstat (limited to 'lib')
-rw-r--r--lib/notmuch-private.h2
-rw-r--r--lib/notmuch.h6
2 files changed, 4 insertions, 4 deletions
diff --git a/lib/notmuch-private.h b/lib/notmuch-private.h
index cc55bb9d..eced03e8 100644
--- a/lib/notmuch-private.h
+++ b/lib/notmuch-private.h
@@ -386,7 +386,7 @@ void
notmuch_message_file_restrict_headersv (notmuch_message_file_t *message,
va_list va_headers);
-/* Get the value of the specified header from the message.
+/* Get the value of the specified header from the message as a UTF-8 string.
*
* The header name is case insensitive.
*
diff --git a/lib/notmuch.h b/lib/notmuch.h
index 9fc34ef1..998a4ae6 100644
--- a/lib/notmuch.h
+++ b/lib/notmuch.h
@@ -767,7 +767,7 @@ notmuch_thread_get_messages (notmuch_thread_t *thread);
int
notmuch_thread_get_matched_messages (notmuch_thread_t *thread);
-/* Get the authors of 'thread'
+/* Get the authors of 'thread' as a UTF-8 string.
*
* The returned string is a comma-separated list of the names of the
* authors of mail messages in the query results that belong to this
@@ -781,7 +781,7 @@ notmuch_thread_get_matched_messages (notmuch_thread_t *thread);
const char *
notmuch_thread_get_authors (notmuch_thread_t *thread);
-/* Get the subject of 'thread'
+/* Get the subject of 'thread' as a UTF-8 string.
*
* The subject is taken from the first message (according to the query
* order---see notmuch_query_set_sort) in the query results that
@@ -1013,7 +1013,7 @@ notmuch_message_set_flag (notmuch_message_t *message,
time_t
notmuch_message_get_date (notmuch_message_t *message);
-/* Get the value of the specified header from 'message'.
+/* Get the value of the specified header from 'message' as a UTF-8 string.
*
* Common headers are stored in the database when the message is
* indexed and will be returned from the database. Other headers will