/docs/libglabels/*.stamp
/docs/libglabels/xml/
/docs/libglabels/html/
-/docs/libglabels/libglabels-decl.txt
-/docs/libglabels/libglabels-decl-list.txt
-/docs/libglabels/libglabels-undeclared.txt
-/docs/libglabels/libglabels-unused.txt
-/docs/libglabels/libglabels-undocumented.txt
-/docs/libglabels/libglabels.args
-/docs/libglabels/libglabels.hierarchy
-/docs/libglabels/libglabels.interfaces
-/docs/libglabels/libglabels.prerequisites
-/docs/libglabels/libglabels.signals
+/docs/libglabels/libglabels*-decl.txt
+/docs/libglabels/libglabels*-decl-list.txt
+/docs/libglabels/libglabels*-undeclared.txt
+/docs/libglabels/libglabels*-unused.txt
+/docs/libglabels/libglabels*-undocumented.txt
+/docs/libglabels/libglabels*.args
+/docs/libglabels/libglabels*.hierarchy
+/docs/libglabels/libglabels*.interfaces
+/docs/libglabels/libglabels*.prerequisites
+/docs/libglabels/libglabels*.signals
#
# Ignore artifacts from editors, patching, etc.
# of using the various options.
# The name of the module, e.g. 'glib'.
-DOC_MODULE=libglabels
+DOC_MODULE=libglabels-3.0
# The top-level SGML file. You can change this if you want to.
DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
# Header files to ignore when scanning.
# e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h
-IGNORE_HFILES=libglabels-private.h
+IGNORE_HFILES=libglabels-3.0-private.h
# Images to copy into HTML directory.
# e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
--- /dev/null
+<?xml version="1.0"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+ "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
+
+<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
+
+ <bookinfo>
+ <title>LibGlabels 3.0 Reference Manual</title>
+ </bookinfo>
+
+ <chapter>
+ <title>Basic LibGlabels Usage</title>
+ <xi:include href="xml/db.xml"/>
+ <xi:include href="xml/template.xml"/>
+ <xi:include href="xml/paper.xml"/>
+ <xi:include href="xml/category.xml"/>
+ </chapter>
+
+ <chapter>
+ <title>Working Directly With LibGlabels XML</title>
+ <xi:include href="xml/xml-paper.xml"/>
+ <xi:include href="xml/xml-category.xml"/>
+ <xi:include href="xml/xml-template.xml"/>
+ <xi:include href="xml/xml.xml"/>
+ </chapter>
+
+ <chapter>
+ <title>Miscellaneous</title>
+ <xi:include href="xml/units.xml"/>
+ <xi:include href="xml/str.xml"/>
+ </chapter>
+
+</book>
--- /dev/null
+<SECTION>
+<FILE>db</FILE>
+<INCLUDE>libglabels/db.h</INCLUDE>
+lglDbRegStatus
+<SUBSECTION Init Functions>
+lgl_db_init
+<SUBSECTION Paper Functions>
+lgl_db_get_paper_id_list
+lgl_db_free_paper_id_list
+lgl_db_get_paper_name_list
+lgl_db_free_paper_name_list
+lgl_db_lookup_paper_from_id
+lgl_db_lookup_paper_from_name
+lgl_db_lookup_paper_id_from_name
+lgl_db_lookup_paper_name_from_id
+lgl_db_is_paper_id_known
+lgl_db_is_paper_id_other
+<SUBSECTION Category Functions>
+lgl_db_get_category_id_list
+lgl_db_free_category_id_list
+lgl_db_get_category_name_list
+lgl_db_free_category_name_list
+lgl_db_lookup_category_from_id
+lgl_db_lookup_category_from_name
+lgl_db_lookup_category_id_from_name
+lgl_db_lookup_category_name_from_id
+lgl_db_is_category_id_known
+<SUBSECTION Brand Functions>
+lgl_db_get_brand_list
+lgl_db_free_brand_list
+<SUBSECTION Template Functions>
+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
+lgl_db_lookup_template_from_name
+<SUBSECTION Debugging Functions>
+lgl_db_print_known_papers
+lgl_db_print_known_categories
+lgl_db_print_known_templates
+lgl_db_print_aliases
+</SECTION>
+
+<SECTION>
+<FILE>template</FILE>
+<INCLUDE>libglabels/template.h</INCLUDE>
+lglTemplate
+<SUBSECTION Alias Structure>
+lglTemplateAlias
+<SUBSECTION Frame Structure>
+lglTemplateFrameShape
+lglTemplateFrame
+lglTemplateFrameAll
+lglTemplateFrameRect
+lglTemplateFrameEllipse
+lglTemplateFrameRound
+lglTemplateFrameCD
+<SUBSECTION Layout Structure>
+lglTemplateLayout
+<SUBSECTION Markup Structure>
+lglTemplateMarkupType
+lglTemplateMarkup
+lglTemplateMarkupMargin
+lglTemplateMarkupLine
+lglTemplateMarkupCircle
+lglTemplateMarkupRect
+<SUBSECTION Origin Structure>
+lglTemplateOrigin
+<SUBSECTION Template Functions>
+lgl_template_new
+lgl_template_dup
+lgl_template_free
+lgl_template_add_category
+lgl_template_add_frame
+lgl_template_add_alias
+<SUBSECTION Template Query Functions>
+lgl_template_get_name
+lgl_template_do_templates_match
+lgl_template_does_brand_match
+lgl_template_does_page_size_match
+lgl_template_does_category_match
+<SUBSECTION Alias Functions>
+lgl_template_alias_new
+lgl_template_alias_dup
+lgl_template_alias_free
+<SUBSECTION Frame Functions>
+lgl_template_frame_rect_new
+lgl_template_frame_round_new
+lgl_template_frame_cd_new
+lgl_template_frame_dup
+lgl_template_frame_free
+lgl_template_frame_add_layout
+lgl_template_frame_add_markup
+<SUBSECTION Frame Frame Query Functions>
+lgl_template_frame_get_size
+lgl_template_frame_get_n_labels
+lgl_template_frame_get_origins
+<SUBSECTION Layout Functions>
+lgl_template_layout_new
+lgl_template_layout_dup
+lgl_template_layout_free
+<SUBSECTION Markup Functions>
+lgl_template_markup_margin_new
+lgl_template_markup_line_new
+lgl_template_markup_circle_new
+lgl_template_markup_rect_new
+lgl_template_markup_dup
+lgl_template_markup_free
+</SECTION>
+
+<SECTION>
+<FILE>paper</FILE>
+<INCLUDE>libglabels/paper.h</INCLUDE>
+lglPaper
+lgl_paper_new
+lgl_paper_dup
+lgl_paper_free
+</SECTION>
+
+<SECTION>
+<FILE>category</FILE>
+<INCLUDE>libglabels/category.h</INCLUDE>
+lglCategory
+lgl_category_new
+lgl_category_dup
+lgl_category_free
+</SECTION>
+
+<SECTION>
+<FILE>xml-paper</FILE>
+<INCLUDE>libglabels/xml-paper.h</INCLUDE>
+lgl_xml_paper_read_papers_from_file
+lgl_xml_paper_parse_papers_doc
+lgl_xml_paper_parse_paper_node
+</SECTION>
+
+<SECTION>
+<FILE>xml-category</FILE>
+<INCLUDE>libglabels/xml-category.h</INCLUDE>
+lgl_xml_category_read_categories_from_file
+lgl_xml_category_parse_categories_doc
+lgl_xml_category_parse_category_node
+</SECTION>
+
+<SECTION>
+<FILE>xml-template</FILE>
+<INCLUDE>libglabels/xml-templates.h</INCLUDE>
+lgl_xml_template_read_templates_from_file
+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_template_node
+</SECTION>
+
+<SECTION>
+<FILE>xml</FILE>
+<INCLUDE>libglabels/xml.h</INCLUDE>
+LGL_XML_NAME_SPACE
+<SUBSECTION Get Property Functions>
+lgl_xml_get_prop_string
+lgl_xml_get_prop_i18n_string
+lgl_xml_get_prop_double
+lgl_xml_get_prop_boolean
+lgl_xml_get_prop_int
+lgl_xml_get_prop_uint
+lgl_xml_get_prop_length
+<SUBSECTION Set Property Functions>
+lgl_xml_set_prop_string
+lgl_xml_set_prop_double
+lgl_xml_set_prop_boolean
+lgl_xml_set_prop_int
+lgl_xml_set_prop_uint_hex
+lgl_xml_set_prop_length
+<SUBSECTION Misc Functions>
+lgl_xml_is_node
+lgl_xml_get_node_content
+<SUBSECTION Configuration Functions>
+lgl_xml_set_default_units
+</SECTION>
+
+<SECTION>
+<FILE>units</FILE>
+<INCLUDE>libglabels/units.h</INCLUDE>
+lglUnits
+lgl_units_get_id
+lgl_units_from_id
+lgl_units_get_name
+lgl_units_from_name
+lgl_units_get_points_per_unit
+lgl_units_get_units_per_point
+</SECTION>
+
+<SECTION>
+<FILE>str</FILE>
+<INCLUDE>libglabels/str.h</INCLUDE>
+lgl_str_utf8_casecmp
+</SECTION>
+
+++ /dev/null
-<?xml version="1.0"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
-
-<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
-
- <bookinfo>
- <title>LibGlabels Reference Manual</title>
- </bookinfo>
-
- <chapter>
- <title>Basic LibGlabels Usage</title>
- <xi:include href="xml/db.xml"/>
- <xi:include href="xml/template.xml"/>
- <xi:include href="xml/paper.xml"/>
- <xi:include href="xml/category.xml"/>
- </chapter>
-
- <chapter>
- <title>Working Directly With LibGlabels XML</title>
- <xi:include href="xml/xml-paper.xml"/>
- <xi:include href="xml/xml-category.xml"/>
- <xi:include href="xml/xml-template.xml"/>
- <xi:include href="xml/xml.xml"/>
- </chapter>
-
- <chapter>
- <title>Miscellaneous</title>
- <xi:include href="xml/units.xml"/>
- <xi:include href="xml/str.xml"/>
- </chapter>
-
-</book>
+++ /dev/null
-<SECTION>
-<FILE>db</FILE>
-<INCLUDE>libglabels/db.h</INCLUDE>
-lglDbRegStatus
-<SUBSECTION Init Functions>
-lgl_db_init
-<SUBSECTION Paper Functions>
-lgl_db_get_paper_id_list
-lgl_db_free_paper_id_list
-lgl_db_get_paper_name_list
-lgl_db_free_paper_name_list
-lgl_db_lookup_paper_from_id
-lgl_db_lookup_paper_from_name
-lgl_db_lookup_paper_id_from_name
-lgl_db_lookup_paper_name_from_id
-lgl_db_is_paper_id_known
-lgl_db_is_paper_id_other
-<SUBSECTION Category Functions>
-lgl_db_get_category_id_list
-lgl_db_free_category_id_list
-lgl_db_get_category_name_list
-lgl_db_free_category_name_list
-lgl_db_lookup_category_from_id
-lgl_db_lookup_category_from_name
-lgl_db_lookup_category_id_from_name
-lgl_db_lookup_category_name_from_id
-lgl_db_is_category_id_known
-<SUBSECTION Brand Functions>
-lgl_db_get_brand_list
-lgl_db_free_brand_list
-<SUBSECTION Template Functions>
-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
-lgl_db_lookup_template_from_name
-<SUBSECTION Debugging Functions>
-lgl_db_print_known_papers
-lgl_db_print_known_categories
-lgl_db_print_known_templates
-lgl_db_print_aliases
-</SECTION>
-
-<SECTION>
-<FILE>template</FILE>
-<INCLUDE>libglabels/template.h</INCLUDE>
-lglTemplate
-<SUBSECTION Alias Structure>
-lglTemplateAlias
-<SUBSECTION Frame Structure>
-lglTemplateFrameShape
-lglTemplateFrame
-lglTemplateFrameAll
-lglTemplateFrameRect
-lglTemplateFrameRound
-lglTemplateFrameCD
-<SUBSECTION Layout Structure>
-lglTemplateLayout
-<SUBSECTION Markup Structure>
-lglTemplateMarkupType
-lglTemplateMarkup
-lglTemplateMarkupMargin
-lglTemplateMarkupLine
-lglTemplateMarkupCircle
-lglTemplateMarkupRect
-<SUBSECTION Origin Structure>
-lglTemplateOrigin
-<SUBSECTION Template Functions>
-lgl_template_new
-lgl_template_dup
-lgl_template_free
-lgl_template_add_category
-lgl_template_add_frame
-lgl_template_add_alias
-<SUBSECTION Template Query Functions>
-lgl_template_get_name
-lgl_template_do_templates_match
-lgl_template_does_brand_match
-lgl_template_does_page_size_match
-lgl_template_does_category_match
-<SUBSECTION Alias Functions>
-lgl_template_alias_new
-lgl_template_alias_dup
-lgl_template_alias_free
-<SUBSECTION Frame Functions>
-lgl_template_frame_rect_new
-lgl_template_frame_round_new
-lgl_template_frame_cd_new
-lgl_template_frame_dup
-lgl_template_frame_free
-lgl_template_frame_add_layout
-lgl_template_frame_add_markup
-<SUBSECTION Frame Frame Query Functions>
-lgl_template_frame_get_size
-lgl_template_frame_get_n_labels
-lgl_template_frame_get_origins
-<SUBSECTION Layout Functions>
-lgl_template_layout_new
-lgl_template_layout_dup
-lgl_template_layout_free
-<SUBSECTION Markup Functions>
-lgl_template_markup_margin_new
-lgl_template_markup_line_new
-lgl_template_markup_circle_new
-lgl_template_markup_rect_new
-lgl_template_markup_dup
-lgl_template_markup_free
-</SECTION>
-
-<SECTION>
-<FILE>paper</FILE>
-<INCLUDE>libglabels/paper.h</INCLUDE>
-lglPaper
-lgl_paper_new
-lgl_paper_dup
-lgl_paper_free
-</SECTION>
-
-<SECTION>
-<FILE>category</FILE>
-<INCLUDE>libglabels/category.h</INCLUDE>
-lglCategory
-lgl_category_new
-lgl_category_dup
-lgl_category_free
-</SECTION>
-
-<SECTION>
-<FILE>xml-paper</FILE>
-<INCLUDE>libglabels/xml-paper.h</INCLUDE>
-lgl_xml_paper_read_papers_from_file
-lgl_xml_paper_parse_papers_doc
-lgl_xml_paper_parse_paper_node
-</SECTION>
-
-<SECTION>
-<FILE>xml-category</FILE>
-<INCLUDE>libglabels/xml-category.h</INCLUDE>
-lgl_xml_category_read_categories_from_file
-lgl_xml_category_parse_categories_doc
-lgl_xml_category_parse_category_node
-</SECTION>
-
-<SECTION>
-<FILE>xml-template</FILE>
-<INCLUDE>libglabels/xml-templates.h</INCLUDE>
-lgl_xml_template_read_templates_from_file
-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_template_node
-</SECTION>
-
-<SECTION>
-<FILE>xml</FILE>
-<INCLUDE>libglabels/xml.h</INCLUDE>
-LGL_XML_NAME_SPACE
-<SUBSECTION Get Property Functions>
-lgl_xml_get_prop_string
-lgl_xml_get_prop_i18n_string
-lgl_xml_get_prop_double
-lgl_xml_get_prop_boolean
-lgl_xml_get_prop_int
-lgl_xml_get_prop_uint
-lgl_xml_get_prop_length
-<SUBSECTION Set Property Functions>
-lgl_xml_set_prop_string
-lgl_xml_set_prop_double
-lgl_xml_set_prop_boolean
-lgl_xml_set_prop_int
-lgl_xml_set_prop_uint_hex
-lgl_xml_set_prop_length
-<SUBSECTION Misc Functions>
-lgl_xml_is_node
-lgl_xml_get_node_content
-<SUBSECTION Configuration Functions>
-lgl_xml_set_default_units
-</SECTION>
-
-<SECTION>
-<FILE>units</FILE>
-<INCLUDE>libglabels/units.h</INCLUDE>
-lglUnits
-lgl_units_get_id
-lgl_units_from_id
-lgl_units_get_name
-lgl_units_from_name
-lgl_units_get_points_per_unit
-lgl_units_get_units_per_point
-</SECTION>
-
-<SECTION>
-<FILE>str</FILE>
-<INCLUDE>libglabels/str.h</INCLUDE>
-lgl_str_utf8_casecmp
-</SECTION>
-
--- /dev/null
+<!-- ##### SECTION ./tmpl/enums.sgml:Long_Description ##### -->
+<para>
+This section defines enumerations used to interact with libglabels.
+</para>
+
+
+<!-- ##### SECTION ./tmpl/enums.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/enums.sgml:Short_Description ##### -->
+Common enumerations used by libglabels
+
+
+<!-- ##### SECTION ./tmpl/enums.sgml:Stability_Level ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/enums.sgml:Title ##### -->
+Enumerations
+
+
+<!-- ##### SECTION ./tmpl/init.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/init.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/init.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/init.sgml:Stability_Level ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/init.sgml:Title ##### -->
+init
+
+
+<!-- ##### SECTION ./tmpl/libglabels.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/libglabels.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/libglabels.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/libglabels.sgml:Stability_Level ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/libglabels.sgml:Title ##### -->
+libglabels
+
+
+<!-- ##### SECTION ./tmpl/template-construction.sgml:Long_Description ##### -->
+<para>
+This section describes a set of functions for constructing new template structures.
+</para>
+
+
+<!-- ##### SECTION ./tmpl/template-construction.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/template-construction.sgml:Short_Description ##### -->
+Functions to help create new templates
+
+
+<!-- ##### SECTION ./tmpl/template-construction.sgml:Stability_Level ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/template-construction.sgml:Title ##### -->
+Construction Functions
+
+
+<!-- ##### SECTION ./tmpl/template-db.sgml:Long_Description ##### -->
+<para>
+This section describes a set of functions to locate pre-defined templates and add templates
+to the LibGlabels template database.
+</para>
+
+
+<!-- ##### SECTION ./tmpl/template-db.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/template-db.sgml:Short_Description ##### -->
+Database of pre-defined templates
+
+
+<!-- ##### SECTION ./tmpl/template-db.sgml:Stability_Level ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/template-db.sgml:Title ##### -->
+Database
+
+
+<!-- ##### SECTION ./tmpl/template-misc.sgml:Long_Description ##### -->
+<para>
+This section describes miscellaneous template functions.
+</para>
+
+
+<!-- ##### SECTION ./tmpl/template-misc.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/template-misc.sgml:Short_Description ##### -->
+Miscellaneous template functions
+
+
+<!-- ##### SECTION ./tmpl/template-misc.sgml:Stability_Level ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/template-misc.sgml:Title ##### -->
+Miscellaneous Functions
+
+
+<!-- ##### SECTION ./tmpl/template2.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/template2.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/template2.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/template2.sgml:Stability_Level ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/template2.sgml:Title ##### -->
+template2
+
+
+<!-- ##### SECTION ./tmpl/template3.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/template3.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/template3.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/template3.sgml:Stability_Level ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/template3.sgml:Title ##### -->
+template3
+
+
+<!-- ##### MACRO GL_XML_NAME_SPACE ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### STRUCT glCategory ##### -->
+<para>
+
+</para>
+
+@id:
+@name:
+
+<!-- ##### STRUCT glPaper ##### -->
+<para>
+
+</para>
+
+@id:
+@name:
+@width:
+@height:
+
+<!-- ##### STRUCT glTemplate ##### -->
+<para>
+
+</para>
+
+@name:
+@description:
+@page_size:
+@page_width:
+@page_height:
+@categories:
+@frames:
+@aliases:
+
+<!-- ##### UNION glTemplateFrame ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### STRUCT glTemplateFrameAll ##### -->
+<para>
+
+</para>
+
+@shape:
+@id:
+@layouts:
+@markups:
+
+<!-- ##### STRUCT glTemplateFrameCD ##### -->
+<para>
+
+</para>
+
+@shape:
+@id:
+@layouts:
+@markups:
+@r1:
+@r2:
+@w:
+@h:
+@waste:
+
+<!-- ##### STRUCT glTemplateFrameRect ##### -->
+<para>
+
+</para>
+
+@shape:
+@id:
+@layouts:
+@markups:
+@w:
+@h:
+@r:
+@x_waste:
+@y_waste:
+
+<!-- ##### STRUCT glTemplateFrameRound ##### -->
+<para>
+
+</para>
+
+@shape:
+@id:
+@layouts:
+@markups:
+@r:
+@waste:
+
+<!-- ##### ENUM glTemplateFrameShape ##### -->
+<para>
+
+</para>
+
+@GL_TEMPLATE_FRAME_SHAPE_RECT:
+@GL_TEMPLATE_FRAME_SHAPE_ROUND:
+@GL_TEMPLATE_FRAME_SHAPE_CD:
+
+<!-- ##### ENUM glTemplateLabelShape ##### -->
+<para>
+
+</para>
+
+@GL_TEMPLATE_SHAPE_RECT:
+@GL_TEMPLATE_SHAPE_ROUND:
+@GL_TEMPLATE_SHAPE_CD:
+
+<!-- ##### STRUCT glTemplateLabelType ##### -->
+<para>
+
+</para>
+
+@id:
+@layouts:
+@markups:
+@shape:
+
+<!-- ##### STRUCT glTemplateLayout ##### -->
+<para>
+
+</para>
+
+@nx:
+@ny:
+@x0:
+@y0:
+@dx:
+@dy:
+
+<!-- ##### UNION glTemplateMarkup ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### STRUCT glTemplateMarkupCircle ##### -->
+<para>
+
+</para>
+
+@type:
+@x0:
+@y0:
+@r:
+
+<!-- ##### STRUCT glTemplateMarkupLine ##### -->
+<para>
+
+</para>
+
+@type:
+@x1:
+@y1:
+@x2:
+@y2:
+
+<!-- ##### STRUCT glTemplateMarkupMargin ##### -->
+<para>
+
+</para>
+
+@type:
+@size:
+
+<!-- ##### STRUCT glTemplateMarkupRect ##### -->
+<para>
+
+</para>
+
+@type:
+@x1:
+@y1:
+@w:
+@h:
+@r:
+
+<!-- ##### ENUM glTemplateMarkupType ##### -->
+<para>
+
+</para>
+
+@GL_TEMPLATE_MARKUP_MARGIN:
+@GL_TEMPLATE_MARKUP_LINE:
+@GL_TEMPLATE_MARKUP_CIRCLE:
+@GL_TEMPLATE_MARKUP_RECT:
+
+<!-- ##### STRUCT glTemplateOrigin ##### -->
+<para>
+
+</para>
+
+@x:
+@y:
+
+<!-- ##### ENUM glUnitsType ##### -->
+<para>
+Enumerations for the units of length supported by libglabels. Internally
+all lengths are in points. Externally libglabels supports points ("pt"),
+inches ("in"), millimeters ("mm"), centimeters ("cm"), and picas ("pc").
+These units are identical to the absolute length units supported in
+the CSS2 Specification (Section 4.3.2).
+</para>
+
+@GL_UNITS_POINT:
+@GL_UNITS_INCH:
+@GL_UNITS_MM:
+@GL_UNITS_CM:
+@GL_UNITS_PICA:
+@GL_UNITS_FIRST:
+@GL_UNITS_LAST:
+
+<!-- ##### FUNCTION gl_category_dup ##### -->
+<para>
+
+</para>
+
+@orig:
+@Returns:
+
+<!-- ##### FUNCTION gl_category_free ##### -->
+<para>
+
+</para>
+
+@category:
+
+<!-- ##### FUNCTION gl_category_free_name_list ##### -->
+<para>
+
+</para>
+
+@names:
+
+<!-- ##### FUNCTION gl_category_from_id ##### -->
+<para>
+
+</para>
+
+@id:
+@Returns:
+
+<!-- ##### FUNCTION gl_category_from_name ##### -->
+<para>
+
+</para>
+
+@name:
+@Returns:
+
+<!-- ##### FUNCTION gl_category_get_name_list ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION gl_category_init ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gl_category_lookup_id_from_name ##### -->
+<para>
+
+</para>
+
+@name:
+@Returns:
+
+<!-- ##### FUNCTION gl_category_lookup_name_from_id ##### -->
+<para>
+
+</para>
+
+@id:
+@Returns:
+
+<!-- ##### FUNCTION gl_category_new ##### -->
+<para>
+
+</para>
+
+@id:
+@name:
+@Returns:
+
+<!-- ##### FUNCTION gl_paper_dup ##### -->
+<para>
+
+</para>
+
+@orig:
+@Returns:
+
+<!-- ##### FUNCTION gl_paper_free ##### -->
+<para>
+
+</para>
+
+@paper:
+
+<!-- ##### FUNCTION gl_paper_free_id_list ##### -->
+<para>
+
+</para>
+
+@ids:
+
+<!-- ##### FUNCTION gl_paper_free_name_list ##### -->
+<para>
+
+</para>
+
+@names:
+
+<!-- ##### FUNCTION gl_paper_from_id ##### -->
+<para>
+
+</para>
+
+@id:
+@Returns:
+
+<!-- ##### FUNCTION gl_paper_from_name ##### -->
+<para>
+
+</para>
+
+@name:
+@Returns:
+
+<!-- ##### FUNCTION gl_paper_get_id_list ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION gl_paper_get_name_list ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION gl_paper_init ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gl_paper_is_id_known ##### -->
+<para>
+
+</para>
+
+@id:
+@Returns:
+
+<!-- ##### FUNCTION gl_paper_is_id_other ##### -->
+<para>
+
+</para>
+
+@id:
+@Returns:
+
+<!-- ##### FUNCTION gl_paper_lookup_id_from_name ##### -->
+<para>
+
+</para>
+
+@name:
+@Returns:
+
+<!-- ##### FUNCTION gl_paper_lookup_name_from_id ##### -->
+<para>
+
+</para>
+
+@id:
+@Returns:
+
+<!-- ##### FUNCTION gl_paper_new ##### -->
+<para>
+
+</para>
+
+@id:
+@name:
+@width:
+@height:
+@Returns:
+
+<!-- ##### FUNCTION gl_paper_print_known_papers ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gl_template_add_alias ##### -->
+<para>
+
+</para>
+
+@template:
+@alias:
+
+<!-- ##### FUNCTION gl_template_add_category ##### -->
+<para>
+
+</para>
+
+@template:
+@category:
+
+<!-- ##### FUNCTION gl_template_add_frame ##### -->
+<para>
+
+</para>
+
+@template:
+@frame:
+
+<!-- ##### FUNCTION gl_template_add_label_type ##### -->
+<para>
+
+</para>
+
+@template:
+@label_type:
+
+<!-- ##### FUNCTION gl_template_add_layout ##### -->
+<para>
+
+</para>
+
+@frame:
+@layout:
+
+<!-- ##### FUNCTION gl_template_add_markup ##### -->
+<para>
+
+</para>
+
+@frame:
+@markup:
+
+<!-- ##### FUNCTION gl_template_cd_label_type_new ##### -->
+<para>
+
+</para>
+
+@id:
+@r1:
+@r2:
+@w:
+@h:
+@waste:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_does_category_match ##### -->
+<para>
+
+</para>
+
+@template:
+@category:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_does_page_size_match ##### -->
+<para>
+
+</para>
+
+@template:
+@page_size:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_dup ##### -->
+<para>
+
+</para>
+
+@orig:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_frame_cd_new ##### -->
+<para>
+
+</para>
+
+@id:
+@r1:
+@r2:
+@w:
+@h:
+@waste:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_frame_dup ##### -->
+<para>
+
+</para>
+
+@orig_frame:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_frame_free ##### -->
+<para>
+
+</para>
+
+@frame:
+
+<!-- ##### FUNCTION gl_template_frame_get_n_labels ##### -->
+<para>
+
+</para>
+
+@frame:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_frame_get_origins ##### -->
+<para>
+
+</para>
+
+@frame:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_frame_get_size ##### -->
+<para>
+
+</para>
+
+@frame:
+@w:
+@h:
+
+<!-- ##### FUNCTION gl_template_frame_rect_new ##### -->
+<para>
+
+</para>
+
+@id:
+@w:
+@h:
+@r:
+@x_waste:
+@y_waste:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_frame_round_new ##### -->
+<para>
+
+</para>
+
+@id:
+@r:
+@waste:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_free ##### -->
+<para>
+
+</para>
+
+@template:
+
+<!-- ##### FUNCTION gl_template_free_name_list ##### -->
+<para>
+
+</para>
+
+@names:
+
+<!-- ##### FUNCTION gl_template_from_name ##### -->
+<para>
+
+</para>
+
+@name:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_get_first_frame ##### -->
+<para>
+
+</para>
+
+@template:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_get_first_label_type ##### -->
+<para>
+
+</para>
+
+@template:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_get_label_size ##### -->
+<para>
+
+</para>
+
+@label_type:
+@w:
+@h:
+
+<!-- ##### FUNCTION gl_template_get_n_labels ##### -->
+<para>
+
+</para>
+
+@label_type:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_get_name_list ##### -->
+<para>
+
+</para>
+
+@page_size:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_get_name_list_all ##### -->
+<para>
+
+</para>
+
+@page_size:
+@category:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_get_name_list_unique ##### -->
+<para>
+
+</para>
+
+@page_size:
+@category:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_get_name_with_desc ##### -->
+<para>
+
+</para>
+
+@template:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_get_origins ##### -->
+<para>
+
+</para>
+
+@label_type:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_init ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gl_template_label_type_dup ##### -->
+<para>
+
+</para>
+
+@orig_ltype:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_label_type_free ##### -->
+<para>
+
+</para>
+
+@ltype:
+
+<!-- ##### FUNCTION gl_template_layout_dup ##### -->
+<para>
+
+</para>
+
+@orig_layout:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_layout_free ##### -->
+<para>
+
+</para>
+
+@layout:
+
+<!-- ##### FUNCTION gl_template_layout_new ##### -->
+<para>
+
+</para>
+
+@nx:
+@ny:
+@x0:
+@y0:
+@dx:
+@dy:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_markup_circle_new ##### -->
+<para>
+
+</para>
+
+@x0:
+@y0:
+@r:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_markup_dup ##### -->
+<para>
+
+</para>
+
+@orig_markup:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_markup_free ##### -->
+<para>
+
+</para>
+
+@markup:
+
+<!-- ##### FUNCTION gl_template_markup_line_new ##### -->
+<para>
+
+</para>
+
+@x1:
+@y1:
+@x2:
+@y2:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_markup_margin_new ##### -->
+<para>
+
+</para>
+
+@size:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_markup_rect_new ##### -->
+<para>
+
+</para>
+
+@x1:
+@y1:
+@w:
+@h:
+@r:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_new ##### -->
+<para>
+
+</para>
+
+@name:
+@description:
+@page_size:
+@page_width:
+@page_height:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_print_aliases ##### -->
+<para>
+
+</para>
+
+@template:
+
+<!-- ##### FUNCTION gl_template_print_known_templates ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gl_template_rect_label_type_new ##### -->
+<para>
+
+</para>
+
+@id:
+@w:
+@h:
+@r:
+@x_waste:
+@y_waste:
+@Returns:
+
+<!-- ##### FUNCTION gl_template_register ##### -->
+<para>
+
+</para>
+
+@template:
+
+<!-- ##### FUNCTION gl_template_round_label_type_new ##### -->
+<para>
+
+</para>
+
+@id:
+@r:
+@waste:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_category_parse_categories_doc ##### -->
+<para>
+
+</para>
+
+@categories_doc:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_category_parse_category_node ##### -->
+<para>
+
+</para>
+
+@category_node:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_category_read_categories_from_file ##### -->
+<para>
+
+</para>
+
+@utf8_filename:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_get_node_content ##### -->
+<para>
+
+</para>
+
+@node:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_get_prop_boolean ##### -->
+<para>
+
+</para>
+
+@node:
+@property:
+@default_val:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_get_prop_double ##### -->
+<para>
+
+</para>
+
+@node:
+@property:
+@default_val:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_get_prop_i18n_string ##### -->
+<para>
+
+</para>
+
+@node:
+@property:
+@default_val:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_get_prop_int ##### -->
+<para>
+
+</para>
+
+@node:
+@property:
+@default_val:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_get_prop_length ##### -->
+<para>
+
+</para>
+
+@node:
+@property:
+@default_val:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_get_prop_string ##### -->
+<para>
+
+</para>
+
+@node:
+@property:
+@default_val:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_get_prop_uint ##### -->
+<para>
+
+</para>
+
+@node:
+@property:
+@default_val:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_is_node ##### -->
+<para>
+
+</para>
+
+@node:
+@name:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_paper_parse_paper_node ##### -->
+<para>
+
+</para>
+
+@paper_node:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_paper_parse_papers_doc ##### -->
+<para>
+
+</para>
+
+@papers_doc:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_paper_read_papers_from_file ##### -->
+<para>
+
+</para>
+
+@utf8_filename:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_set_default_units ##### -->
+<para>
+
+</para>
+
+@units:
+
+<!-- ##### FUNCTION gl_xml_set_prop_boolean ##### -->
+<para>
+
+</para>
+
+@node:
+@property:
+@val:
+
+<!-- ##### FUNCTION gl_xml_set_prop_double ##### -->
+<para>
+
+</para>
+
+@node:
+@property:
+@val:
+
+<!-- ##### FUNCTION gl_xml_set_prop_int ##### -->
+<para>
+
+</para>
+
+@node:
+@property:
+@val:
+
+<!-- ##### FUNCTION gl_xml_set_prop_length ##### -->
+<para>
+
+</para>
+
+@node:
+@property:
+@val:
+
+<!-- ##### FUNCTION gl_xml_set_prop_string ##### -->
+<para>
+
+</para>
+
+@node:
+@property:
+@val:
+
+<!-- ##### FUNCTION gl_xml_set_prop_uint_hex ##### -->
+<para>
+
+</para>
+
+@node:
+@property:
+@val:
+
+<!-- ##### FUNCTION gl_xml_template_create_template_node ##### -->
+<para>
+
+</para>
+
+@template:
+@root:
+@ns:
+
+<!-- ##### FUNCTION gl_xml_template_create_templates_doc ##### -->
+<para>
+
+</para>
+
+@templates:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_template_parse_template_node ##### -->
+<para>
+
+</para>
+
+@template_node:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_template_parse_templates_doc ##### -->
+<para>
+
+</para>
+
+@templates_doc:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_template_read_templates_from_file ##### -->
+<para>
+
+</para>
+
+@utf8_filename:
+@Returns:
+
+<!-- ##### FUNCTION gl_xml_template_write_template_to_file ##### -->
+<para>
+
+</para>
+
+@template:
+@utf8_filename:
+
+<!-- ##### FUNCTION gl_xml_template_write_templates_to_file ##### -->
+<para>
+
+</para>
+
+@templates:
+@utf8_filename:
+
+<!-- ##### ENUM lglUnitsType ##### -->
+<para>
+This enumeration defines a set of units of distance supported by the libglabels XML distance
+attributes.
+</para>
+
+@LGL_UNITS_POINT: Points. Encoded as "pt" in XML distance attributes.
+@LGL_UNITS_INCH: Inches. Encoded as "in" in XML distance attributes.
+@LGL_UNITS_MM: Millmeters. Encoded as "mm" in XML distance attributes.
+@LGL_UNITS_CM: Centimeters. Encoded as "cm" in XML distance attributes.
+@LGL_UNITS_PICA: Picas. Encoded as "pc" in XML distance attributes.
+@LGL_UNITS_FIRST: First enumeration. Used for generic iteration through supported units..
+@LGL_UNITS_LAST: Last enumeration. Used for generic iteration through supported units.
+
+<!-- ##### FUNCTION lgl_category_free_id_list ##### -->
+<para>
+
+</para>
+
+@ids:
+
+<!-- ##### FUNCTION lgl_category_free_name_list ##### -->
+<para>
+
+</para>
+
+@names:
+
+<!-- ##### FUNCTION lgl_category_from_id ##### -->
+<para>
+
+</para>
+
+@id:
+@Returns:
+
+<!-- ##### FUNCTION lgl_category_from_name ##### -->
+<para>
+
+</para>
+
+@name:
+@Returns:
+
+<!-- ##### FUNCTION lgl_category_get_id_list ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION lgl_category_get_name_list ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION lgl_category_init ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION lgl_category_lookup_id_from_name ##### -->
+<para>
+
+</para>
+
+@name:
+@Returns:
+
+<!-- ##### FUNCTION lgl_category_lookup_name_from_id ##### -->
+<para>
+
+</para>
+
+@id:
+@Returns:
+
+<!-- ##### FUNCTION lgl_init ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION lgl_paper_free_id_list ##### -->
+<para>
+
+</para>
+
+@ids:
+
+<!-- ##### FUNCTION lgl_paper_free_name_list ##### -->
+<para>
+
+</para>
+
+@names:
+
+<!-- ##### FUNCTION lgl_paper_from_id ##### -->
+<para>
+
+</para>
+
+@id:
+@Returns:
+
+<!-- ##### FUNCTION lgl_paper_from_name ##### -->
+<para>
+
+</para>
+
+@name:
+@Returns:
+
+<!-- ##### FUNCTION lgl_paper_get_id_list ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION lgl_paper_get_name_list ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION lgl_paper_init ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION lgl_paper_is_id_known ##### -->
+<para>
+
+</para>
+
+@id:
+@Returns:
+
+<!-- ##### FUNCTION lgl_paper_is_id_other ##### -->
+<para>
+
+</para>
+
+@id:
+@Returns:
+
+<!-- ##### FUNCTION lgl_paper_lookup_id_from_name ##### -->
+<para>
+
+</para>
+
+@name:
+@Returns:
+
+<!-- ##### FUNCTION lgl_paper_lookup_name_from_id ##### -->
+<para>
+
+</para>
+
+@id:
+@Returns:
+
+<!-- ##### FUNCTION lgl_paper_print_known_papers ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION lgl_template_add_layout ##### -->
+<para>
+
+</para>
+
+@frame:
+@layout:
+
+<!-- ##### FUNCTION lgl_template_add_markup ##### -->
+<para>
+
+</para>
+
+@frame:
+@markup:
+
+<!-- ##### FUNCTION lgl_template_free_brand_list ##### -->
+<para>
+
+</para>
+
+@brands:
+
+<!-- ##### FUNCTION lgl_template_free_name_list ##### -->
+<para>
+
+</para>
+
+@names:
+
+<!-- ##### FUNCTION lgl_template_from_name ##### -->
+<para>
+
+</para>
+
+@name:
+@Returns:
+
+<!-- ##### FUNCTION lgl_template_get_brand_list ##### -->
+<para>
+
+</para>
+
+@page_size:
+@category:
+@Returns:
+
+<!-- ##### FUNCTION lgl_template_get_first_frame ##### -->
+<para>
+
+</para>
+
+@template:
+@Returns:
+
+<!-- ##### FUNCTION lgl_template_get_name_list_all ##### -->
+<para>
+
+</para>
+
+@brand:
+@page_size:
+@category:
+@Returns:
+
+<!-- ##### FUNCTION lgl_template_get_name_list_unique ##### -->
+<para>
+
+</para>
+
+@brand:
+@page_size:
+@category:
+@Returns:
+
+<!-- ##### FUNCTION lgl_template_init ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION lgl_template_print_aliases ##### -->
+<para>
+
+</para>
+
+@template:
+
+<!-- ##### FUNCTION lgl_template_print_known_templates ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION lgl_template_register ##### -->
+<para>
+
+</para>
+
+@template:
+
+<!-- ##### FUNCTION lgl_xml_template_create_templates_doc ##### -->
+<para>
+
+</para>
+
+@templates:
+@Returns:
+
+++ /dev/null
-<!-- ##### SECTION ./tmpl/enums.sgml:Long_Description ##### -->
-<para>
-This section defines enumerations used to interact with libglabels.
-</para>
-
-
-<!-- ##### SECTION ./tmpl/enums.sgml:See_Also ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SECTION ./tmpl/enums.sgml:Short_Description ##### -->
-Common enumerations used by libglabels
-
-
-<!-- ##### SECTION ./tmpl/enums.sgml:Stability_Level ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/enums.sgml:Title ##### -->
-Enumerations
-
-
-<!-- ##### SECTION ./tmpl/init.sgml:Long_Description ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SECTION ./tmpl/init.sgml:See_Also ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SECTION ./tmpl/init.sgml:Short_Description ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/init.sgml:Stability_Level ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/init.sgml:Title ##### -->
-init
-
-
-<!-- ##### SECTION ./tmpl/libglabels.sgml:Long_Description ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SECTION ./tmpl/libglabels.sgml:See_Also ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SECTION ./tmpl/libglabels.sgml:Short_Description ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/libglabels.sgml:Stability_Level ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/libglabels.sgml:Title ##### -->
-libglabels
-
-
-<!-- ##### SECTION ./tmpl/template-construction.sgml:Long_Description ##### -->
-<para>
-This section describes a set of functions for constructing new template structures.
-</para>
-
-
-<!-- ##### SECTION ./tmpl/template-construction.sgml:See_Also ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SECTION ./tmpl/template-construction.sgml:Short_Description ##### -->
-Functions to help create new templates
-
-
-<!-- ##### SECTION ./tmpl/template-construction.sgml:Stability_Level ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/template-construction.sgml:Title ##### -->
-Construction Functions
-
-
-<!-- ##### SECTION ./tmpl/template-db.sgml:Long_Description ##### -->
-<para>
-This section describes a set of functions to locate pre-defined templates and add templates
-to the LibGlabels template database.
-</para>
-
-
-<!-- ##### SECTION ./tmpl/template-db.sgml:See_Also ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SECTION ./tmpl/template-db.sgml:Short_Description ##### -->
-Database of pre-defined templates
-
-
-<!-- ##### SECTION ./tmpl/template-db.sgml:Stability_Level ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/template-db.sgml:Title ##### -->
-Database
-
-
-<!-- ##### SECTION ./tmpl/template-misc.sgml:Long_Description ##### -->
-<para>
-This section describes miscellaneous template functions.
-</para>
-
-
-<!-- ##### SECTION ./tmpl/template-misc.sgml:See_Also ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SECTION ./tmpl/template-misc.sgml:Short_Description ##### -->
-Miscellaneous template functions
-
-
-<!-- ##### SECTION ./tmpl/template-misc.sgml:Stability_Level ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/template-misc.sgml:Title ##### -->
-Miscellaneous Functions
-
-
-<!-- ##### SECTION ./tmpl/template2.sgml:Long_Description ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SECTION ./tmpl/template2.sgml:See_Also ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SECTION ./tmpl/template2.sgml:Short_Description ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/template2.sgml:Stability_Level ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/template2.sgml:Title ##### -->
-template2
-
-
-<!-- ##### SECTION ./tmpl/template3.sgml:Long_Description ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SECTION ./tmpl/template3.sgml:See_Also ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SECTION ./tmpl/template3.sgml:Short_Description ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/template3.sgml:Stability_Level ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/template3.sgml:Title ##### -->
-template3
-
-
-<!-- ##### MACRO GL_XML_NAME_SPACE ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### STRUCT glCategory ##### -->
-<para>
-
-</para>
-
-@id:
-@name:
-
-<!-- ##### STRUCT glPaper ##### -->
-<para>
-
-</para>
-
-@id:
-@name:
-@width:
-@height:
-
-<!-- ##### STRUCT glTemplate ##### -->
-<para>
-
-</para>
-
-@name:
-@description:
-@page_size:
-@page_width:
-@page_height:
-@categories:
-@frames:
-@aliases:
-
-<!-- ##### UNION glTemplateFrame ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### STRUCT glTemplateFrameAll ##### -->
-<para>
-
-</para>
-
-@shape:
-@id:
-@layouts:
-@markups:
-
-<!-- ##### STRUCT glTemplateFrameCD ##### -->
-<para>
-
-</para>
-
-@shape:
-@id:
-@layouts:
-@markups:
-@r1:
-@r2:
-@w:
-@h:
-@waste:
-
-<!-- ##### STRUCT glTemplateFrameRect ##### -->
-<para>
-
-</para>
-
-@shape:
-@id:
-@layouts:
-@markups:
-@w:
-@h:
-@r:
-@x_waste:
-@y_waste:
-
-<!-- ##### STRUCT glTemplateFrameRound ##### -->
-<para>
-
-</para>
-
-@shape:
-@id:
-@layouts:
-@markups:
-@r:
-@waste:
-
-<!-- ##### ENUM glTemplateFrameShape ##### -->
-<para>
-
-</para>
-
-@GL_TEMPLATE_FRAME_SHAPE_RECT:
-@GL_TEMPLATE_FRAME_SHAPE_ROUND:
-@GL_TEMPLATE_FRAME_SHAPE_CD:
-
-<!-- ##### ENUM glTemplateLabelShape ##### -->
-<para>
-
-</para>
-
-@GL_TEMPLATE_SHAPE_RECT:
-@GL_TEMPLATE_SHAPE_ROUND:
-@GL_TEMPLATE_SHAPE_CD:
-
-<!-- ##### STRUCT glTemplateLabelType ##### -->
-<para>
-
-</para>
-
-@id:
-@layouts:
-@markups:
-@shape:
-
-<!-- ##### STRUCT glTemplateLayout ##### -->
-<para>
-
-</para>
-
-@nx:
-@ny:
-@x0:
-@y0:
-@dx:
-@dy:
-
-<!-- ##### UNION glTemplateMarkup ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### STRUCT glTemplateMarkupCircle ##### -->
-<para>
-
-</para>
-
-@type:
-@x0:
-@y0:
-@r:
-
-<!-- ##### STRUCT glTemplateMarkupLine ##### -->
-<para>
-
-</para>
-
-@type:
-@x1:
-@y1:
-@x2:
-@y2:
-
-<!-- ##### STRUCT glTemplateMarkupMargin ##### -->
-<para>
-
-</para>
-
-@type:
-@size:
-
-<!-- ##### STRUCT glTemplateMarkupRect ##### -->
-<para>
-
-</para>
-
-@type:
-@x1:
-@y1:
-@w:
-@h:
-@r:
-
-<!-- ##### ENUM glTemplateMarkupType ##### -->
-<para>
-
-</para>
-
-@GL_TEMPLATE_MARKUP_MARGIN:
-@GL_TEMPLATE_MARKUP_LINE:
-@GL_TEMPLATE_MARKUP_CIRCLE:
-@GL_TEMPLATE_MARKUP_RECT:
-
-<!-- ##### STRUCT glTemplateOrigin ##### -->
-<para>
-
-</para>
-
-@x:
-@y:
-
-<!-- ##### ENUM glUnitsType ##### -->
-<para>
-Enumerations for the units of length supported by libglabels. Internally
-all lengths are in points. Externally libglabels supports points ("pt"),
-inches ("in"), millimeters ("mm"), centimeters ("cm"), and picas ("pc").
-These units are identical to the absolute length units supported in
-the CSS2 Specification (Section 4.3.2).
-</para>
-
-@GL_UNITS_POINT:
-@GL_UNITS_INCH:
-@GL_UNITS_MM:
-@GL_UNITS_CM:
-@GL_UNITS_PICA:
-@GL_UNITS_FIRST:
-@GL_UNITS_LAST:
-
-<!-- ##### FUNCTION gl_category_dup ##### -->
-<para>
-
-</para>
-
-@orig:
-@Returns:
-
-<!-- ##### FUNCTION gl_category_free ##### -->
-<para>
-
-</para>
-
-@category:
-
-<!-- ##### FUNCTION gl_category_free_name_list ##### -->
-<para>
-
-</para>
-
-@names:
-
-<!-- ##### FUNCTION gl_category_from_id ##### -->
-<para>
-
-</para>
-
-@id:
-@Returns:
-
-<!-- ##### FUNCTION gl_category_from_name ##### -->
-<para>
-
-</para>
-
-@name:
-@Returns:
-
-<!-- ##### FUNCTION gl_category_get_name_list ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-<!-- ##### FUNCTION gl_category_init ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION gl_category_lookup_id_from_name ##### -->
-<para>
-
-</para>
-
-@name:
-@Returns:
-
-<!-- ##### FUNCTION gl_category_lookup_name_from_id ##### -->
-<para>
-
-</para>
-
-@id:
-@Returns:
-
-<!-- ##### FUNCTION gl_category_new ##### -->
-<para>
-
-</para>
-
-@id:
-@name:
-@Returns:
-
-<!-- ##### FUNCTION gl_paper_dup ##### -->
-<para>
-
-</para>
-
-@orig:
-@Returns:
-
-<!-- ##### FUNCTION gl_paper_free ##### -->
-<para>
-
-</para>
-
-@paper:
-
-<!-- ##### FUNCTION gl_paper_free_id_list ##### -->
-<para>
-
-</para>
-
-@ids:
-
-<!-- ##### FUNCTION gl_paper_free_name_list ##### -->
-<para>
-
-</para>
-
-@names:
-
-<!-- ##### FUNCTION gl_paper_from_id ##### -->
-<para>
-
-</para>
-
-@id:
-@Returns:
-
-<!-- ##### FUNCTION gl_paper_from_name ##### -->
-<para>
-
-</para>
-
-@name:
-@Returns:
-
-<!-- ##### FUNCTION gl_paper_get_id_list ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-<!-- ##### FUNCTION gl_paper_get_name_list ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-<!-- ##### FUNCTION gl_paper_init ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION gl_paper_is_id_known ##### -->
-<para>
-
-</para>
-
-@id:
-@Returns:
-
-<!-- ##### FUNCTION gl_paper_is_id_other ##### -->
-<para>
-
-</para>
-
-@id:
-@Returns:
-
-<!-- ##### FUNCTION gl_paper_lookup_id_from_name ##### -->
-<para>
-
-</para>
-
-@name:
-@Returns:
-
-<!-- ##### FUNCTION gl_paper_lookup_name_from_id ##### -->
-<para>
-
-</para>
-
-@id:
-@Returns:
-
-<!-- ##### FUNCTION gl_paper_new ##### -->
-<para>
-
-</para>
-
-@id:
-@name:
-@width:
-@height:
-@Returns:
-
-<!-- ##### FUNCTION gl_paper_print_known_papers ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION gl_template_add_alias ##### -->
-<para>
-
-</para>
-
-@template:
-@alias:
-
-<!-- ##### FUNCTION gl_template_add_category ##### -->
-<para>
-
-</para>
-
-@template:
-@category:
-
-<!-- ##### FUNCTION gl_template_add_frame ##### -->
-<para>
-
-</para>
-
-@template:
-@frame:
-
-<!-- ##### FUNCTION gl_template_add_label_type ##### -->
-<para>
-
-</para>
-
-@template:
-@label_type:
-
-<!-- ##### FUNCTION gl_template_add_layout ##### -->
-<para>
-
-</para>
-
-@frame:
-@layout:
-
-<!-- ##### FUNCTION gl_template_add_markup ##### -->
-<para>
-
-</para>
-
-@frame:
-@markup:
-
-<!-- ##### FUNCTION gl_template_cd_label_type_new ##### -->
-<para>
-
-</para>
-
-@id:
-@r1:
-@r2:
-@w:
-@h:
-@waste:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_does_category_match ##### -->
-<para>
-
-</para>
-
-@template:
-@category:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_does_page_size_match ##### -->
-<para>
-
-</para>
-
-@template:
-@page_size:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_dup ##### -->
-<para>
-
-</para>
-
-@orig:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_frame_cd_new ##### -->
-<para>
-
-</para>
-
-@id:
-@r1:
-@r2:
-@w:
-@h:
-@waste:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_frame_dup ##### -->
-<para>
-
-</para>
-
-@orig_frame:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_frame_free ##### -->
-<para>
-
-</para>
-
-@frame:
-
-<!-- ##### FUNCTION gl_template_frame_get_n_labels ##### -->
-<para>
-
-</para>
-
-@frame:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_frame_get_origins ##### -->
-<para>
-
-</para>
-
-@frame:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_frame_get_size ##### -->
-<para>
-
-</para>
-
-@frame:
-@w:
-@h:
-
-<!-- ##### FUNCTION gl_template_frame_rect_new ##### -->
-<para>
-
-</para>
-
-@id:
-@w:
-@h:
-@r:
-@x_waste:
-@y_waste:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_frame_round_new ##### -->
-<para>
-
-</para>
-
-@id:
-@r:
-@waste:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_free ##### -->
-<para>
-
-</para>
-
-@template:
-
-<!-- ##### FUNCTION gl_template_free_name_list ##### -->
-<para>
-
-</para>
-
-@names:
-
-<!-- ##### FUNCTION gl_template_from_name ##### -->
-<para>
-
-</para>
-
-@name:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_get_first_frame ##### -->
-<para>
-
-</para>
-
-@template:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_get_first_label_type ##### -->
-<para>
-
-</para>
-
-@template:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_get_label_size ##### -->
-<para>
-
-</para>
-
-@label_type:
-@w:
-@h:
-
-<!-- ##### FUNCTION gl_template_get_n_labels ##### -->
-<para>
-
-</para>
-
-@label_type:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_get_name_list ##### -->
-<para>
-
-</para>
-
-@page_size:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_get_name_list_all ##### -->
-<para>
-
-</para>
-
-@page_size:
-@category:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_get_name_list_unique ##### -->
-<para>
-
-</para>
-
-@page_size:
-@category:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_get_name_with_desc ##### -->
-<para>
-
-</para>
-
-@template:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_get_origins ##### -->
-<para>
-
-</para>
-
-@label_type:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_init ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION gl_template_label_type_dup ##### -->
-<para>
-
-</para>
-
-@orig_ltype:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_label_type_free ##### -->
-<para>
-
-</para>
-
-@ltype:
-
-<!-- ##### FUNCTION gl_template_layout_dup ##### -->
-<para>
-
-</para>
-
-@orig_layout:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_layout_free ##### -->
-<para>
-
-</para>
-
-@layout:
-
-<!-- ##### FUNCTION gl_template_layout_new ##### -->
-<para>
-
-</para>
-
-@nx:
-@ny:
-@x0:
-@y0:
-@dx:
-@dy:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_markup_circle_new ##### -->
-<para>
-
-</para>
-
-@x0:
-@y0:
-@r:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_markup_dup ##### -->
-<para>
-
-</para>
-
-@orig_markup:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_markup_free ##### -->
-<para>
-
-</para>
-
-@markup:
-
-<!-- ##### FUNCTION gl_template_markup_line_new ##### -->
-<para>
-
-</para>
-
-@x1:
-@y1:
-@x2:
-@y2:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_markup_margin_new ##### -->
-<para>
-
-</para>
-
-@size:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_markup_rect_new ##### -->
-<para>
-
-</para>
-
-@x1:
-@y1:
-@w:
-@h:
-@r:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_new ##### -->
-<para>
-
-</para>
-
-@name:
-@description:
-@page_size:
-@page_width:
-@page_height:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_print_aliases ##### -->
-<para>
-
-</para>
-
-@template:
-
-<!-- ##### FUNCTION gl_template_print_known_templates ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION gl_template_rect_label_type_new ##### -->
-<para>
-
-</para>
-
-@id:
-@w:
-@h:
-@r:
-@x_waste:
-@y_waste:
-@Returns:
-
-<!-- ##### FUNCTION gl_template_register ##### -->
-<para>
-
-</para>
-
-@template:
-
-<!-- ##### FUNCTION gl_template_round_label_type_new ##### -->
-<para>
-
-</para>
-
-@id:
-@r:
-@waste:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_category_parse_categories_doc ##### -->
-<para>
-
-</para>
-
-@categories_doc:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_category_parse_category_node ##### -->
-<para>
-
-</para>
-
-@category_node:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_category_read_categories_from_file ##### -->
-<para>
-
-</para>
-
-@utf8_filename:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_get_node_content ##### -->
-<para>
-
-</para>
-
-@node:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_get_prop_boolean ##### -->
-<para>
-
-</para>
-
-@node:
-@property:
-@default_val:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_get_prop_double ##### -->
-<para>
-
-</para>
-
-@node:
-@property:
-@default_val:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_get_prop_i18n_string ##### -->
-<para>
-
-</para>
-
-@node:
-@property:
-@default_val:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_get_prop_int ##### -->
-<para>
-
-</para>
-
-@node:
-@property:
-@default_val:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_get_prop_length ##### -->
-<para>
-
-</para>
-
-@node:
-@property:
-@default_val:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_get_prop_string ##### -->
-<para>
-
-</para>
-
-@node:
-@property:
-@default_val:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_get_prop_uint ##### -->
-<para>
-
-</para>
-
-@node:
-@property:
-@default_val:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_is_node ##### -->
-<para>
-
-</para>
-
-@node:
-@name:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_paper_parse_paper_node ##### -->
-<para>
-
-</para>
-
-@paper_node:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_paper_parse_papers_doc ##### -->
-<para>
-
-</para>
-
-@papers_doc:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_paper_read_papers_from_file ##### -->
-<para>
-
-</para>
-
-@utf8_filename:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_set_default_units ##### -->
-<para>
-
-</para>
-
-@units:
-
-<!-- ##### FUNCTION gl_xml_set_prop_boolean ##### -->
-<para>
-
-</para>
-
-@node:
-@property:
-@val:
-
-<!-- ##### FUNCTION gl_xml_set_prop_double ##### -->
-<para>
-
-</para>
-
-@node:
-@property:
-@val:
-
-<!-- ##### FUNCTION gl_xml_set_prop_int ##### -->
-<para>
-
-</para>
-
-@node:
-@property:
-@val:
-
-<!-- ##### FUNCTION gl_xml_set_prop_length ##### -->
-<para>
-
-</para>
-
-@node:
-@property:
-@val:
-
-<!-- ##### FUNCTION gl_xml_set_prop_string ##### -->
-<para>
-
-</para>
-
-@node:
-@property:
-@val:
-
-<!-- ##### FUNCTION gl_xml_set_prop_uint_hex ##### -->
-<para>
-
-</para>
-
-@node:
-@property:
-@val:
-
-<!-- ##### FUNCTION gl_xml_template_create_template_node ##### -->
-<para>
-
-</para>
-
-@template:
-@root:
-@ns:
-
-<!-- ##### FUNCTION gl_xml_template_create_templates_doc ##### -->
-<para>
-
-</para>
-
-@templates:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_template_parse_template_node ##### -->
-<para>
-
-</para>
-
-@template_node:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_template_parse_templates_doc ##### -->
-<para>
-
-</para>
-
-@templates_doc:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_template_read_templates_from_file ##### -->
-<para>
-
-</para>
-
-@utf8_filename:
-@Returns:
-
-<!-- ##### FUNCTION gl_xml_template_write_template_to_file ##### -->
-<para>
-
-</para>
-
-@template:
-@utf8_filename:
-
-<!-- ##### FUNCTION gl_xml_template_write_templates_to_file ##### -->
-<para>
-
-</para>
-
-@templates:
-@utf8_filename:
-
-<!-- ##### ENUM lglUnitsType ##### -->
-<para>
-This enumeration defines a set of units of distance supported by the libglabels XML distance
-attributes.
-</para>
-
-@LGL_UNITS_POINT: Points. Encoded as "pt" in XML distance attributes.
-@LGL_UNITS_INCH: Inches. Encoded as "in" in XML distance attributes.
-@LGL_UNITS_MM: Millmeters. Encoded as "mm" in XML distance attributes.
-@LGL_UNITS_CM: Centimeters. Encoded as "cm" in XML distance attributes.
-@LGL_UNITS_PICA: Picas. Encoded as "pc" in XML distance attributes.
-@LGL_UNITS_FIRST: First enumeration. Used for generic iteration through supported units..
-@LGL_UNITS_LAST: Last enumeration. Used for generic iteration through supported units.
-
-<!-- ##### FUNCTION lgl_category_free_id_list ##### -->
-<para>
-
-</para>
-
-@ids:
-
-<!-- ##### FUNCTION lgl_category_free_name_list ##### -->
-<para>
-
-</para>
-
-@names:
-
-<!-- ##### FUNCTION lgl_category_from_id ##### -->
-<para>
-
-</para>
-
-@id:
-@Returns:
-
-<!-- ##### FUNCTION lgl_category_from_name ##### -->
-<para>
-
-</para>
-
-@name:
-@Returns:
-
-<!-- ##### FUNCTION lgl_category_get_id_list ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-<!-- ##### FUNCTION lgl_category_get_name_list ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-<!-- ##### FUNCTION lgl_category_init ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION lgl_category_lookup_id_from_name ##### -->
-<para>
-
-</para>
-
-@name:
-@Returns:
-
-<!-- ##### FUNCTION lgl_category_lookup_name_from_id ##### -->
-<para>
-
-</para>
-
-@id:
-@Returns:
-
-<!-- ##### FUNCTION lgl_init ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION lgl_paper_free_id_list ##### -->
-<para>
-
-</para>
-
-@ids:
-
-<!-- ##### FUNCTION lgl_paper_free_name_list ##### -->
-<para>
-
-</para>
-
-@names:
-
-<!-- ##### FUNCTION lgl_paper_from_id ##### -->
-<para>
-
-</para>
-
-@id:
-@Returns:
-
-<!-- ##### FUNCTION lgl_paper_from_name ##### -->
-<para>
-
-</para>
-
-@name:
-@Returns:
-
-<!-- ##### FUNCTION lgl_paper_get_id_list ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-<!-- ##### FUNCTION lgl_paper_get_name_list ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-<!-- ##### FUNCTION lgl_paper_init ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION lgl_paper_is_id_known ##### -->
-<para>
-
-</para>
-
-@id:
-@Returns:
-
-<!-- ##### FUNCTION lgl_paper_is_id_other ##### -->
-<para>
-
-</para>
-
-@id:
-@Returns:
-
-<!-- ##### FUNCTION lgl_paper_lookup_id_from_name ##### -->
-<para>
-
-</para>
-
-@name:
-@Returns:
-
-<!-- ##### FUNCTION lgl_paper_lookup_name_from_id ##### -->
-<para>
-
-</para>
-
-@id:
-@Returns:
-
-<!-- ##### FUNCTION lgl_paper_print_known_papers ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION lgl_template_add_layout ##### -->
-<para>
-
-</para>
-
-@frame:
-@layout:
-
-<!-- ##### FUNCTION lgl_template_add_markup ##### -->
-<para>
-
-</para>
-
-@frame:
-@markup:
-
-<!-- ##### FUNCTION lgl_template_free_brand_list ##### -->
-<para>
-
-</para>
-
-@brands:
-
-<!-- ##### FUNCTION lgl_template_free_name_list ##### -->
-<para>
-
-</para>
-
-@names:
-
-<!-- ##### FUNCTION lgl_template_from_name ##### -->
-<para>
-
-</para>
-
-@name:
-@Returns:
-
-<!-- ##### FUNCTION lgl_template_get_brand_list ##### -->
-<para>
-
-</para>
-
-@page_size:
-@category:
-@Returns:
-
-<!-- ##### FUNCTION lgl_template_get_first_frame ##### -->
-<para>
-
-</para>
-
-@template:
-@Returns:
-
-<!-- ##### FUNCTION lgl_template_get_name_list_all ##### -->
-<para>
-
-</para>
-
-@brand:
-@page_size:
-@category:
-@Returns:
-
-<!-- ##### FUNCTION lgl_template_get_name_list_unique ##### -->
-<para>
-
-</para>
-
-@brand:
-@page_size:
-@category:
-@Returns:
-
-<!-- ##### FUNCTION lgl_template_init ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION lgl_template_print_aliases ##### -->
-<para>
-
-</para>
-
-@template:
-
-<!-- ##### FUNCTION lgl_template_print_known_templates ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION lgl_template_register ##### -->
-<para>
-
-</para>
-
-@template:
-
-<!-- ##### FUNCTION lgl_xml_template_create_templates_doc ##### -->
-<para>
-
-</para>
-
-@templates:
-@Returns:
-
of peel-off labels or cards.
</para>
-@brand: Brand name of label or card. E.g. "Avery."
+@brand: Vendor or brand name of label or card. E.g. "Avery."
@part: Part name or number of label or card. E.g. "8160."
-@equiv_part:
+@equiv_part: Part name or number of a part with identical layout. Must be from same vendor.
@description: A description of the template. E.g. "Mailing labels."
@paper_id: A paper ID. E.g. "A4" or "US-Letter."
@page_width: Page width in points. Used only if paper_id is "Other."
@page_height: Page height in points. Used only if paper_id is "Other."
-@product_url:
+@product_url: URL to a webpage describing product.
@category_ids: A list of category IDs that this template belongs to.
@frames: A list of (#lglTemplateFrame *) structures. GLabels currently only supports one frame
per template -- future versions may support multiple frames per template.
</para>
@LGL_TEMPLATE_FRAME_SHAPE_RECT: A rectangular frame. (May have rounded corners.)
+@LGL_TEMPLATE_FRAME_SHAPE_ELLIPSE: An elliptical frame.
@LGL_TEMPLATE_FRAME_SHAPE_ROUND: A round frame.
@LGL_TEMPLATE_FRAME_SHAPE_CD: A CD or DVD frame. (Includes credit-card style CDs.)
@x_waste: Amount of horizontal over-print to allow in points.
@y_waste: Amount of vertical over-print to allow in points.
+<!-- ##### STRUCT lglTemplateFrameEllipse ##### -->
+<para>
+This structure defines the frame for an elliptical label or card.
+</para>
+
+@shape: Common field. Always #LGL_TEMPLATE_FRAME_SHAPE_ELLIPSE for #lglTemplateFrameEllipse.
+@id: Common field. See #lglTemplateFrameAll.
+@layouts: Common field. See #lglTemplateFrameAll.
+@markups: Common field. See #lglTemplateFrameAll.
+@w: Width of label or card in points.
+@h: Height of label or card in points.
+@waste: Amount of over-print to allow in points.
+
<!-- ##### STRUCT lglTemplateFrameRound ##### -->
<para>
This structure defines the frame for a round label or card.
@LGL_TEMPLATE_MARKUP_LINE: A simple line segment.
@LGL_TEMPLATE_MARKUP_CIRCLE: A circle.
@LGL_TEMPLATE_MARKUP_RECT: A rectangle. Possibly with rounded corners.
+@LGL_TEMPLATE_MARKUP_ELLIPSE: An ellipse.
<!-- ##### UNION lglTemplateMarkup ##### -->
<para>
<!-- ##### SECTION Long_Description ##### -->
<para>
-This section defines a type to represent the varios units of distance
+This section defines a type to represent the various units of distance
supported by libglabels. It also defines a set of related functions.
</para>
projects / glabels / commitdiff