source: x/lib/cairo.xml@ fb0fc4e

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY cairo-download-http "http://cairographics.org/releases/cairo-&cairo-version;.tar.gz">
  <!ENTITY cairo-download-ftp  "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/cairo-&cairo-version;.tar.gz">
  <!ENTITY cairo-md5sum        "f0ff35c91983b7bf226154e68b280be3">
  <!ENTITY cairo-size          "1.4 MB">
  <!ENTITY cairo-buildsize     "29.4 MB">
  <!ENTITY cairo-time          "0.4 SBU">
]>

<sect1 id="cairo" xreflabel="cairo-&cairo-version;">
  <?dbhtml filename="cairo.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>cairo-&cairo-version;</title>

  <indexterm zone="cairo">
    <primary sortas="a-cairo">cairo</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to cairo</title>

    <para><application>cairo</application> is a 2D graphics library with
    support for multiple output devices. Currently supported output targets
    include the <application>X</application> Window System, win32, and image
    buffers. Experimental backends include OpenGL (through glitz), Quartz,
    XCB, PostScript and PDF file output. cairo is designed to produce
    consistent output on all output media while taking advantage of display
    hardware acceleration when available (e.g., through the X Render
    Extension). The <application>cairo</application> API provides operations
    similar to the drawing operators of PostScript and PDF. Operations in
    <application>cairo</application> include stroking and filling cubic
    Bézier splines, transforming and compositing translucent images, and
    antialiased text rendering. All drawing operations can be transformed by
    any affine transformation (scale, rotation, shear, etc.).</para>

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&cairo-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&cairo-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &cairo-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &cairo-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &cairo-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &cairo-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">cairo Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para>X (<xref linkend="xorg"/> or <xref linkend="xfree86"/>)</para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para><ulink url="http://www.freedesktop.org/Software/glitz">glitz</ulink>,
    <ulink url="http://xcb.freedesktop.org/wiki/">XCB</ulink> and
    <xref linkend="gtk-doc"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of cairo</title>

    <note>
      <para><application>XFree86</application> installs the
      <application>X Render</application> extension library during the package
      installation, but does not install an <filename>xrender.pc</filename>
      file. Cairo will look for this file during configuration. Satisfy the
      need for this file by creating one using the following command as the
      <systemitem class="username">root</systemitem> user (not required if you
      have <application>Xorg</application> installed):</para>

<screen role="root"><userinput>cat &gt; /usr/X11R6/lib/pkgconfig/xrender.pc &lt;&lt; "EOF"
<literal>prefix=/usr/X11R6
exec_prefix=${prefix}
libdir=${exec_prefix}/lib
includedir=${prefix}/include

Name: Xrender
Description: X Render Library
Version: 0.8.3
Cflags: -I${includedir} -I/usr/X11R6/include
Libs: -L${libdir} -lXrender  -L/usr/X11R6/lib -lX11</literal>
EOF</userinput></screen>

    </note>

    <para>Install <application>cairo</application> by running the following
    commands:</para>

<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

    <para>To test the results, issue: <command>make check</command>.</para>

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make install</userinput></screen>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>None</seg>
        <seg>libcairo.[so,a]</seg>
        <seg>/usr/include/cairo and /usr/share/gtk-doc/html/cairo</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="libcairo">
        <term><filename class='libraryfile'>libcairo.[so,a]</filename></term>
        <listitem>
          <para>contains the 2D graphics functions required for rendering to
          the various output targets.</para>
          <indexterm zone="cairo libcairo">
            <primary sortas="c-libcairo">libcairo.[so,a]</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>