cairo/doc/reference/xml/cairo_create.xml

<refentry id="cairo_create">
  <refmeta>
    <refentrytitle>cairo_create</refentrytitle>
    <manvolnum>3</manvolnum>
  </refmeta>
  <refnamediv>
    <refname>cairo_create</refname>
    <refpurpose>create a new <link linkend="cairo_t">cairo_t</link> object</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <programlisting><link linkend="cairo_t">cairo_t</link> * cairo_create (void)</programlisting>
    <variablelist role="params">
      <varlistentry>
        <term/>
        <listitem>
          <simpara>this takes no arguments</simpara>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsynopsisdiv>
  <refsect1>
    <title>Description</title>
    <para>
      <indexterm>
        <primary>functions</primary>
        <secondary>cairo_create</secondary>
      </indexterm>
      <indexterm>
        <primary/>
      </indexterm>
      This function creates a new <link linkend="cairo_t">cairo_t</link> with a reference count of one. Call <link linkend="cairo_destroy">cairo_destroy</link> to free the allocated resources.
    </para>
  </refsect1>
</refentry>