From: Christian Persch <chpe@src.gnome.org>
Date: Sun, 15 Feb 2009 13:51:19 +0000 (+0000)
Subject: More docs.
X-Git-Tag: EVINCE_2_25_91~44
X-Git-Url: https://www.fi.muni.cz/~kas/git//home/kas/public_html/git/?a=commitdiff_plain;h=3997b15fc906d9ce0d7920f9f8e4af3b9404c4f0;p=evince.git

More docs.

svn path=/trunk/; revision=3436
---

diff --git a/libdocument/ev-file-helpers.c b/libdocument/ev-file-helpers.c
index af961884..28f01b10 100644
--- a/libdocument/ev-file-helpers.c
+++ b/libdocument/ev-file-helpers.c
@@ -262,6 +262,18 @@ get_mime_type_from_data (const gchar *uri, GError **error)
 				     NULL);
 }
 
+/**
+ * ev_file_get_mime_type:
+ * @uri: the URI
+ * @fast: whether to use fast MIME type detection
+ * @error: a #GError location to store an error, or %NULL
+ *
+ * Note: on unknown MIME types, this may return NULL without @error
+ * being filled in.
+ * 
+ * Returns: a newly allocated string with the MIME type of the file at
+ *   @uri, or %NULL on error or if the MIME type could not be determined
+ */
 gchar *
 ev_file_get_mime_type (const gchar *uri,
 		       gboolean     fast,