[balsa] Document the previous commit

[Peter Bloomfield <peterb src gnome org>]

commit 3ee5eb6ae773c0f3b847ed7355061919ba2d1421
Author: Peter Bloomfield <PeterBloomfield bellsouth net>
Date:   Sat Nov 19 18:34:42 2016 -0500

    Document the previous commit
    
        * libbalsa/misc.c: document libbalsa_font_string_to_css.

 ChangeLog       |    4 ++++
 libbalsa/misc.c |   11 +++++++++++
 2 files changed, 15 insertions(+), 0 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index d738134..87ba207 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2016-11-19  Peter Bloomfield  <pbloomfield bellsouth net>
 
+       * libbalsa/misc.c: document libbalsa_font_string_to_css.
+
+2016-11-19  Peter Bloomfield  <pbloomfield bellsouth net>
+
        Silence some whining about "Using Pango syntax for the font:
        style property is deprecated; please use CSS syntax".
 
diff --git a/libbalsa/misc.c b/libbalsa/misc.c
index b29ddf3..d892a28 100644
--- a/libbalsa/misc.c
+++ b/libbalsa/misc.c
@@ -1356,6 +1356,17 @@ libbalsa_size_to_gchar(guint64 size)
     return g_strdup_printf("%" G_GUINT64_FORMAT, size);
 }
 
+/*
+ * libbalsa_font_string_to_css: construct CSS text corresponding to a
+ * PangoFontDescription string.
+ *
+ * font_string: the PangoFontDescription string;
+ * name:        the name of the widget to which the font is to be applied.
+ *
+ * Returns:     a newly allocated string with the CSS text;
+ *              g_free() when no longer needed.
+ */
+
 gchar *
 libbalsa_font_string_to_css(const gchar * font_string,
                             const gchar * name)