summaryrefslogtreecommitdiff
path: root/doc/public/xml/cairo-status.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/public/xml/cairo-status.xml')
-rw-r--r--doc/public/xml/cairo-status.xml354
1 files changed, 354 insertions, 0 deletions
diff --git a/doc/public/xml/cairo-status.xml b/doc/public/xml/cairo-status.xml
new file mode 100644
index 000000000..bd2fc5014
--- /dev/null
+++ b/doc/public/xml/cairo-status.xml
@@ -0,0 +1,354 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+<!ENTITY version SYSTEM "version.xml">
+]>
+<refentry id="cairo-Error-handling">
+<refmeta>
+<refentrytitle role="top_of_page" id="cairo-Error-handling.top_of_page">Error handling</refentrytitle>
+<manvolnum>3</manvolnum>
+<refmiscinfo>
+ CAIRO Library
+</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>Error handling</refname>
+<refpurpose>Decoding cairo's status</refpurpose>
+</refnamediv>
+
+<refsect1 id="cairo-Error-handling.functions" role="functions_proto">
+<title role="functions_proto.title">Functions</title>
+<informaltable pgwide="1" frame="none">
+<tgroup cols="2">
+<colspec colname="functions_return" colwidth="150px"/>
+<colspec colname="functions_name"/>
+<tbody>
+<row><entry role="function_type">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
+</entry><entry role="function_name"><link linkend="cairo-status-to-string">cairo_status_to_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
+<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
+</entry><entry role="function_name"><link linkend="cairo-debug-reset-static-data">cairo_debug_reset_static_data</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
+
+</tbody>
+</tgroup>
+</informaltable>
+</refsect1>
+<refsect1 id="cairo-Error-handling.other" role="other_proto">
+<title role="other_proto.title">Types and Values</title>
+<informaltable role="enum_members_table" pgwide="1" frame="none">
+<tgroup cols="2">
+<colspec colname="name" colwidth="150px"/>
+<colspec colname="description"/>
+<tbody>
+<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="cairo-status-t">cairo_status_t</link></entry></row>
+
+</tbody>
+</tgroup>
+</informaltable>
+</refsect1>
+<refsect1 id="cairo-Error-handling.object-hierarchy" role="object_hierarchy">
+<title role="object_hierarchy.title">Object Hierarchy</title>
+<screen>
+</screen>
+</refsect1>
+
+
+<refsect1 id="cairo-Error-handling.description" role="desc">
+<title role="desc.title">Description</title>
+<para>Cairo uses a single status type to represent all kinds of errors. A status
+value of <link linkend="CAIRO-STATUS-SUCCESS:CAPS"><literal>CAIRO_STATUS_SUCCESS</literal></link> represents no error and has an integer value
+of zero. All other status values represent an error.</para>
+<para>Cairo's error handling is designed to be easy to use and safe. All major
+cairo objects <firstterm>retain</firstterm> an error status internally which
+can be queried anytime by the users using cairo*_status() calls. In
+the mean time, it is safe to call all cairo functions normally even if the
+underlying object is in an error status. This means that no error handling
+code is required before or after each individual cairo function call.</para>
+
+</refsect1>
+<refsect1 id="cairo-Error-handling.functions_details" role="details">
+<title role="details.title">Functions</title>
+<refsect2 id="cairo-status-to-string" role="function" condition="since:1.0">
+<title>cairo_status_to_string&#160;()</title>
+<indexterm zone="cairo-status-to-string" role="1.0"><primary sortas="status_to_string">cairo_status_to_string</primary></indexterm>
+<programlisting language="C">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
+cairo_status_to_string (<parameter><link linkend="cairo-status-t"><type>cairo_status_t</type></link> status</parameter>);</programlisting>
+<para>Provides a human-readable description of a <link linkend="cairo-status-t"><type>cairo_status_t</type></link>.</para>
+<refsect3 role="parameters">
+<title>Parameters</title>
+<informaltable role="parameters_table" pgwide="1" frame="none">
+<tgroup cols="3">
+<colspec colname="parameters_name" colwidth="150px"/>
+<colspec colname="parameters_description"/>
+<colspec colname="parameters_annotations" colwidth="200px"/>
+<tbody>
+<row><entry role="parameter_name"><para>status</para></entry>
+<entry role="parameter_description"><para>a cairo status</para></entry>
+<entry role="parameter_annotations"></entry></row>
+</tbody></tgroup></informaltable>
+</refsect3><refsect3 role="returns">
+<title>Returns</title>
+<para> a string representation of the status</para>
+<para></para>
+</refsect3><para role="since">Since 1.0</para></refsect2>
+<refsect2 id="cairo-debug-reset-static-data" role="function" condition="since:1.0">
+<title>cairo_debug_reset_static_data&#160;()</title>
+<indexterm zone="cairo-debug-reset-static-data" role="1.0"><primary sortas="debug_reset_static_data">cairo_debug_reset_static_data</primary></indexterm>
+<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
+cairo_debug_reset_static_data (<parameter><type>void</type></parameter>);</programlisting>
+<para>Resets all static data within cairo to its original state,
+(ie. identical to the state at the time of program invocation). For
+example, all caches within cairo will be flushed empty.</para>
+<para>This function is intended to be useful when using memory-checking
+tools such as valgrind. When valgrind's memcheck analyzes a
+cairo-using program without a call to <link linkend="cairo-debug-reset-static-data"><function>cairo_debug_reset_static_data()</function></link>,
+it will report all data reachable via cairo's static objects as
+"still reachable". Calling <link linkend="cairo-debug-reset-static-data"><function>cairo_debug_reset_static_data()</function></link> just prior
+to program termination will make it easier to get squeaky clean
+reports from valgrind.</para>
+<para>WARNING: It is only safe to call this function when there are no
+active cairo objects remaining, (ie. the appropriate destroy
+functions have been called as necessary). If there are active cairo
+objects, this call is likely to cause a crash, (eg. an assertion
+failure due to a hash table being destroyed when non-empty).</para>
+<para role="since">Since 1.0</para></refsect2>
+
+</refsect1>
+<refsect1 id="cairo-Error-handling.other_details" role="details">
+<title role="details.title">Types and Values</title>
+<refsect2 id="cairo-status-t" role="enum" condition="since:1.0">
+<title>enum cairo_status_t</title>
+<indexterm zone="cairo-status-t" role="1.0"><primary sortas="status_t">cairo_status_t</primary></indexterm>
+<para><link linkend="cairo-status-t"><type>cairo_status_t</type></link> is used to indicate errors that can occur when
+using Cairo. In some cases it is returned directly by functions.
+but when using <link linkend="cairo-t"><type>cairo_t</type></link>, the last error, if any, is stored in
+the context and can be retrieved with <link linkend="cairo-status"><function>cairo_status()</function></link>.</para>
+<para>New entries may be added in future versions. Use <link linkend="cairo-status-to-string"><function>cairo_status_to_string()</function></link>
+to get a human-readable representation of an error message.</para>
+<refsect3 role="enum_members">
+<title>Members</title>
+<informaltable role="enum_members_table" pgwide="1" frame="none">
+<tgroup cols="3">
+<colspec colname="enum_members_name" colwidth="300px"/>
+<colspec colname="enum_members_description"/>
+<colspec colname="enum_members_annotations" colwidth="200px"/>
+<tbody>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-SUCCESS:CAPS">CAIRO_STATUS_SUCCESS</para></entry>
+<entry role="enum_member_description"><para>no error has occurred (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-NO-MEMORY:CAPS">CAIRO_STATUS_NO_MEMORY</para></entry>
+<entry role="enum_member_description"><para>out of memory (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-RESTORE:CAPS">CAIRO_STATUS_INVALID_RESTORE</para></entry>
+<entry role="enum_member_description"><para>cairo_restore() called without matching <link linkend="cairo-save"><function>cairo_save()</function></link> (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-POP-GROUP:CAPS">CAIRO_STATUS_INVALID_POP_GROUP</para></entry>
+<entry role="enum_member_description"><para>no saved group to pop, i.e. <link linkend="cairo-pop-group"><function>cairo_pop_group()</function></link> without matching <link linkend="cairo-push-group"><function>cairo_push_group()</function></link> (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-NO-CURRENT-POINT:CAPS">CAIRO_STATUS_NO_CURRENT_POINT</para></entry>
+<entry role="enum_member_description"><para>no current point defined (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-MATRIX:CAPS">CAIRO_STATUS_INVALID_MATRIX</para></entry>
+<entry role="enum_member_description"><para>invalid matrix (not invertible) (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-STATUS:CAPS">CAIRO_STATUS_INVALID_STATUS</para></entry>
+<entry role="enum_member_description"><para>invalid value for an input <link linkend="cairo-status-t"><type>cairo_status_t</type></link> (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-NULL-POINTER:CAPS">CAIRO_STATUS_NULL_POINTER</para></entry>
+<entry role="enum_member_description"><para><link linkend="NULL:CAPS"><literal>NULL</literal></link> pointer (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-STRING:CAPS">CAIRO_STATUS_INVALID_STRING</para></entry>
+<entry role="enum_member_description"><para>input string not valid UTF-8 (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-PATH-DATA:CAPS">CAIRO_STATUS_INVALID_PATH_DATA</para></entry>
+<entry role="enum_member_description"><para>input path data not valid (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-READ-ERROR:CAPS">CAIRO_STATUS_READ_ERROR</para></entry>
+<entry role="enum_member_description"><para>error while reading from input stream (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-WRITE-ERROR:CAPS">CAIRO_STATUS_WRITE_ERROR</para></entry>
+<entry role="enum_member_description"><para>error while writing to output stream (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-SURFACE-FINISHED:CAPS">CAIRO_STATUS_SURFACE_FINISHED</para></entry>
+<entry role="enum_member_description"><para>target surface has been finished (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-SURFACE-TYPE-MISMATCH:CAPS">CAIRO_STATUS_SURFACE_TYPE_MISMATCH</para></entry>
+<entry role="enum_member_description"><para>the surface type is not appropriate for the operation (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-PATTERN-TYPE-MISMATCH:CAPS">CAIRO_STATUS_PATTERN_TYPE_MISMATCH</para></entry>
+<entry role="enum_member_description"><para>the pattern type is not appropriate for the operation (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-CONTENT:CAPS">CAIRO_STATUS_INVALID_CONTENT</para></entry>
+<entry role="enum_member_description"><para>invalid value for an input <link linkend="cairo-content-t"><type>cairo_content_t</type></link> (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-FORMAT:CAPS">CAIRO_STATUS_INVALID_FORMAT</para></entry>
+<entry role="enum_member_description"><para>invalid value for an input <link linkend="cairo-format-t"><type>cairo_format_t</type></link> (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-VISUAL:CAPS">CAIRO_STATUS_INVALID_VISUAL</para></entry>
+<entry role="enum_member_description"><para>invalid value for an input Visual* (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-FILE-NOT-FOUND:CAPS">CAIRO_STATUS_FILE_NOT_FOUND</para></entry>
+<entry role="enum_member_description"><para>file not found (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-DASH:CAPS">CAIRO_STATUS_INVALID_DASH</para></entry>
+<entry role="enum_member_description"><para>invalid value for a dash setting (Since 1.0)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-DSC-COMMENT:CAPS">CAIRO_STATUS_INVALID_DSC_COMMENT</para></entry>
+<entry role="enum_member_description"><para>invalid value for a DSC comment (Since 1.2)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-INDEX:CAPS">CAIRO_STATUS_INVALID_INDEX</para></entry>
+<entry role="enum_member_description"><para>invalid index passed to getter (Since 1.4)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-CLIP-NOT-REPRESENTABLE:CAPS">CAIRO_STATUS_CLIP_NOT_REPRESENTABLE</para></entry>
+<entry role="enum_member_description"><para>clip region not representable in desired format (Since 1.4)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-TEMP-FILE-ERROR:CAPS">CAIRO_STATUS_TEMP_FILE_ERROR</para></entry>
+<entry role="enum_member_description"><para>error creating or writing to a temporary file (Since 1.6)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-STRIDE:CAPS">CAIRO_STATUS_INVALID_STRIDE</para></entry>
+<entry role="enum_member_description"><para>invalid value for stride (Since 1.6)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-FONT-TYPE-MISMATCH:CAPS">CAIRO_STATUS_FONT_TYPE_MISMATCH</para></entry>
+<entry role="enum_member_description"><para>the font type is not appropriate for the operation (Since 1.8)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-USER-FONT-IMMUTABLE:CAPS">CAIRO_STATUS_USER_FONT_IMMUTABLE</para></entry>
+<entry role="enum_member_description"><para>the user-font is immutable (Since 1.8)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-USER-FONT-ERROR:CAPS">CAIRO_STATUS_USER_FONT_ERROR</para></entry>
+<entry role="enum_member_description"><para>error occurred in a user-font callback function (Since 1.8)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-NEGATIVE-COUNT:CAPS">CAIRO_STATUS_NEGATIVE_COUNT</para></entry>
+<entry role="enum_member_description"><para>negative number used where it is not allowed (Since 1.8)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-CLUSTERS:CAPS">CAIRO_STATUS_INVALID_CLUSTERS</para></entry>
+<entry role="enum_member_description"><para>input clusters do not represent the accompanying text and glyph array (Since 1.8)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-SLANT:CAPS">CAIRO_STATUS_INVALID_SLANT</para></entry>
+<entry role="enum_member_description"><para>invalid value for an input <link linkend="cairo-font-slant-t"><type>cairo_font_slant_t</type></link> (Since 1.8)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-WEIGHT:CAPS">CAIRO_STATUS_INVALID_WEIGHT</para></entry>
+<entry role="enum_member_description"><para>invalid value for an input <link linkend="cairo-font-weight-t"><type>cairo_font_weight_t</type></link> (Since 1.8)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-SIZE:CAPS">CAIRO_STATUS_INVALID_SIZE</para></entry>
+<entry role="enum_member_description"><para>invalid value (typically too big) for the size of the input (surface, pattern, etc.) (Since 1.10)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-USER-FONT-NOT-IMPLEMENTED:CAPS">CAIRO_STATUS_USER_FONT_NOT_IMPLEMENTED</para></entry>
+<entry role="enum_member_description"><para>user-font method not implemented (Since 1.10)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-DEVICE-TYPE-MISMATCH:CAPS">CAIRO_STATUS_DEVICE_TYPE_MISMATCH</para></entry>
+<entry role="enum_member_description"><para>the device type is not appropriate for the operation (Since 1.10)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-DEVICE-ERROR:CAPS">CAIRO_STATUS_DEVICE_ERROR</para></entry>
+<entry role="enum_member_description"><para>an operation to the device caused an unspecified error (Since 1.10)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-MESH-CONSTRUCTION:CAPS">CAIRO_STATUS_INVALID_MESH_CONSTRUCTION</para></entry>
+<entry role="enum_member_description"><para>a mesh pattern
+ construction operation was used outside of a
+ <link linkend="cairo-mesh-pattern-begin-patch"><function>cairo_mesh_pattern_begin_patch()</function></link>/<link linkend="cairo-mesh-pattern-end-patch"><function>cairo_mesh_pattern_end_patch()</function></link>
+ pair (Since 1.12)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-DEVICE-FINISHED:CAPS">CAIRO_STATUS_DEVICE_FINISHED</para></entry>
+<entry role="enum_member_description"><para>target device has been finished (Since 1.12)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-JBIG2-GLOBAL-MISSING:CAPS">CAIRO_STATUS_JBIG2_GLOBAL_MISSING</para></entry>
+<entry role="enum_member_description"><para><link linkend="CAIRO-MIME-TYPE-JBIG2-GLOBAL-ID:CAPS"><literal>CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID</literal></link> has been used on at least one image
+ but no image provided <link linkend="CAIRO-MIME-TYPE-JBIG2-GLOBAL:CAPS"><literal>CAIRO_MIME_TYPE_JBIG2_GLOBAL</literal></link> (Since 1.14)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-LAST-STATUS:CAPS">CAIRO_STATUS_LAST_STATUS</para></entry>
+<entry role="enum_member_description"><para>this is a special value indicating the number of
+ status values defined in this enumeration. When using this value, note
+ that the version of cairo at run-time may have additional status values
+ defined than the value of this symbol at compile-time. (Since 1.10)</para>
+</entry>
+<entry role="enum_member_annotations"></entry>
+</row>
+</tbody></tgroup></informaltable>
+</refsect3><para role="since">Since 1.0</para></refsect2>
+
+</refsect1>
+<refsect1 id="cairo-Error-handling.see-also">
+<title>See Also</title>
+<para>cairo_status(), <link linkend="cairo-surface-status"><function>cairo_surface_status()</function></link>, <link linkend="cairo-pattern-status"><function>cairo_pattern_status()</function></link>,
+ <link linkend="cairo-font-face-status"><function>cairo_font_face_status()</function></link>, <link linkend="cairo-scaled-font-status"><function>cairo_scaled_font_status()</function></link>,
+ <link linkend="cairo-region-status"><function>cairo_region_status()</function></link></para>
+
+</refsect1>
+
+</refentry>