From: Jim Evins Date: Sat, 8 Dec 2007 23:46:30 +0000 (+0000) Subject: 2007-12-08 Jim Evins X-Git-Tag: glabels-2_3_0~299 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=61ce763cb6817e0d22b262d9933a3d5d32cd945f;p=glabels 2007-12-08 Jim Evins * docs/libglabels/libglabels-decl-list.txt: * docs/libglabels/libglabels-docs.sgml: * docs/libglabels/libglabels-sections.txt: * docs/libglabels/libglabels-undocumented.txt: * docs/libglabels/tmpl/db.sgml: * docs/libglabels/tmpl/str.sgml: * libglabels/str.c: Documentation cleanup for libglabels. git-svn-id: https://glabels.svn.sourceforge.net/svnroot/glabels/trunk@699 f5e0f49d-192f-0410-a22d-a8d8700d0965 --- diff --git a/glabels2/ChangeLog b/glabels2/ChangeLog index cc133c0c..546aed21 100644 --- a/glabels2/ChangeLog +++ b/glabels2/ChangeLog @@ -1,3 +1,14 @@ +2007-12-08 Jim Evins + + * docs/libglabels/libglabels-decl-list.txt: + * docs/libglabels/libglabels-docs.sgml: + * docs/libglabels/libglabels-sections.txt: + * docs/libglabels/libglabels-undocumented.txt: + * docs/libglabels/tmpl/db.sgml: + * docs/libglabels/tmpl/str.sgml: + * libglabels/str.c: + Documentation cleanup for libglabels. + 2007-11-29 Jim Evins * libglabels/db.h: diff --git a/glabels2/docs/libglabels/libglabels-decl-list.txt b/glabels2/docs/libglabels/libglabels-decl-list.txt index 6e99ec0e..d1dcf984 100644 --- a/glabels2/docs/libglabels/libglabels-decl-list.txt +++ b/glabels2/docs/libglabels/libglabels-decl-list.txt @@ -25,6 +25,7 @@ lgl_db_get_brand_list lgl_db_free_brand_list lgl_db_register_template lgl_db_does_template_exist +lgl_db_does_template_name_exist lgl_db_get_template_name_list_unique lgl_db_get_template_name_list_all lgl_db_free_template_name_list @@ -75,6 +76,11 @@ lgl_xml_template_create_template_node lglUnitsType +
+str +lgl_str_utf8_casecmp +
+
template lglTemplate diff --git a/glabels2/docs/libglabels/libglabels-docs.sgml b/glabels2/docs/libglabels/libglabels-docs.sgml index 993afd01..a4b5b381 100644 --- a/glabels2/docs/libglabels/libglabels-docs.sgml +++ b/glabels2/docs/libglabels/libglabels-docs.sgml @@ -14,7 +14,6 @@ - @@ -25,4 +24,10 @@ + + Miscellaneous + + + + diff --git a/glabels2/docs/libglabels/libglabels-sections.txt b/glabels2/docs/libglabels/libglabels-sections.txt index ac954e4d..658d109c 100644 --- a/glabels2/docs/libglabels/libglabels-sections.txt +++ b/glabels2/docs/libglabels/libglabels-sections.txt @@ -31,6 +31,7 @@ lgl_db_free_brand_list lgl_db_register_template lgl_db_does_template_exist +lgl_db_does_template_name_exist lgl_db_get_template_name_list_unique lgl_db_get_template_name_list_all lgl_db_free_template_name_list @@ -126,12 +127,6 @@ lgl_category_dup lgl_category_free
-
-enums -libglabels/enums.h -lglUnitsType -
-
xml-paper libglabels/xml-paper.h @@ -156,7 +151,6 @@ lgl_xml_template_parse_templates_doc lgl_xml_template_parse_template_node lgl_xml_template_write_templates_to_file lgl_xml_template_write_template_to_file -lgl_xml_template_create_templates_doc lgl_xml_template_create_template_node
@@ -186,3 +180,15 @@ lgl_xml_get_node_content lgl_xml_set_default_units +
+enums +libglabels/enums.h +lglUnitsType +
+ +
+str +libglabels/str.h +lgl_str_utf8_casecmp +
+ diff --git a/glabels2/docs/libglabels/libglabels-undocumented.txt b/glabels2/docs/libglabels/libglabels-undocumented.txt index a1352226..d4b8b2f7 100644 --- a/glabels2/docs/libglabels/libglabels-undocumented.txt +++ b/glabels2/docs/libglabels/libglabels-undocumented.txt @@ -1,5 +1,5 @@ 99% symbol docs coverage. -137 symbols documented. +141 symbols documented. 0 symbols incomplete. 1 not documented. diff --git a/glabels2/docs/libglabels/tmpl/db.sgml b/glabels2/docs/libglabels/tmpl/db.sgml index eaacab3f..3d5d2de3 100644 --- a/glabels2/docs/libglabels/tmpl/db.sgml +++ b/glabels2/docs/libglabels/tmpl/db.sgml @@ -235,6 +235,15 @@ This enumeration defines a set of possible return values for lgl_db_register_tem @Returns: + + + + + +@name: +@Returns: + + diff --git a/glabels2/docs/libglabels/tmpl/str.sgml b/glabels2/docs/libglabels/tmpl/str.sgml new file mode 100644 index 00000000..53cbd3b9 --- /dev/null +++ b/glabels2/docs/libglabels/tmpl/str.sgml @@ -0,0 +1,30 @@ + +String Utility Functions + + +String utility functions provided by libglabels + + + +This section defines string utility functions used by libglabels and of +possible use to a user of libglabels. + + + + + + + + + + + + + + + +@s1: +@s2: +@Returns: + + diff --git a/glabels2/libglabels/str.c b/glabels2/libglabels/str.c index adf52f2b..7c1f59a6 100644 --- a/glabels2/libglabels/str.c +++ b/glabels2/libglabels/str.c @@ -48,6 +48,20 @@ /* Functions. */ /*===========================================*/ +/** + * lgl_str_utf8_casecmp: + * @s1: string to compare with s2. + * @s2: string to compare with s1. + * + * Compare two UTF-8 strings, ignoring the case of characters. + * + * This function should be used only on strings that are known to be encoded + * in UTF-8 or a compatible UTF-8 subset. + * + * Returns: 0 if the strings match, a negative value if s1 < s2, + * or a positive value if s1 > s2. + * + */ gint lgl_str_utf8_casecmp (const gchar *s1, const gchar *s2)