RubyGems - cairo - Versions diffs - 1.15.14-x86-mingw32 → 1.16.0-x86-mingw32 - Mend

cairo 1.15.14-x86-mingw32 → 1.16.0-x86-mingw32

Files changed (295) hide show

data/vendor/local/share/gtk-doc/html/cairo/cairo-Version-Information.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="cairo-support.html" title="Utilities">
 <link rel="prev" href="cairo-Error-handling.html" title="Error handling">
 <link rel="next" href="cairo-Types.html" title="Types">
-<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -178,14 +178,27 @@ Run-time
 For example, checking that the cairo version is greater than or equal
 to 1.0.0 could be achieved at compile-time or run-time as follows:
-<div class="informalexample"><pre class="programlisting">
-##if CAIRO_VERSION &gt;= CAIRO_VERSION_ENCODE(1, 0, 0)
-printf ("Compiling with suitable cairo version: %s\n", %CAIRO_VERSION_STRING);
-##endif
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc ppc">##if CAIRO_VERSION &gt;= CAIRO_VERSION_ENCODE(1, 0, 0)</span>
+<span class="function">printf</span> <span class="gtkdoc opt">(</span><span class="string">&quot;Compiling with suitable cairo version: %s</span><span class="gtkdoc esc">\n</span><span class="string">&quot;</span><span class="gtkdoc opt">, %</span>CAIRO_VERSION_STRING<span class="gtkdoc opt">);</span>
+<span class="gtkdoc ppc">##endif</span>
+<span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function"><a href="cairo-Version-Information.html#cairo-version">cairo_version</a></span><span class="gtkdoc opt">() &gt;=</span> <span class="function"><a href="cairo-Version-Information.html#CAIRO-VERSION-ENCODE:CAPS">CAIRO_VERSION_ENCODE</a></span><span class="gtkdoc opt">(</span><span class="number">1</span><span class="gtkdoc opt">,</span> <span class="number">0</span><span class="gtkdoc opt">,</span> <span class="number">0</span><span class="gtkdoc opt">))</span>
+    <span class="function">printf</span> <span class="gtkdoc opt">(</span><span class="string">&quot;Running with suitable cairo version: %s</span><span class="gtkdoc esc">\n</span><span class="string">&quot;</span><span class="gtkdoc opt">,</span> <span class="function"><a href="cairo-Version-Information.html#cairo-version-string">cairo_version_string</a></span> <span class="gtkdoc opt">());</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
-if (cairo_version() &gt;= CAIRO_VERSION_ENCODE(1, 0, 0))
-    printf ("Running with suitable cairo version: %s\n", cairo_version_string ());
-</pre></div>
 </div>
 </div>
 <div class="refsect1">
@@ -280,9 +293,17 @@ integer as per <a class="link" href="cairo-Version-Information.html#CAIRO-VERSIO
 later versions compare greater than earlier versions.</p>
 <p>A run-time comparison to check that cairo's version is greater than
 or equal to version X.Y.Z could be performed as follows:</p>
-<div class="informalexample"><pre class="programlisting">
-if (cairo_version() &gt;= CAIRO_VERSION_ENCODE(X,Y,Z)) {...}
-</pre></div>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function"><a href="cairo-Version-Information.html#cairo-version">cairo_version</a></span><span class="gtkdoc opt">() &gt;=</span> <span class="function"><a href="cairo-Version-Information.html#CAIRO-VERSION-ENCODE:CAPS">CAIRO_VERSION_ENCODE</a></span><span class="gtkdoc opt">(</span>X<span class="gtkdoc opt">,</span>Y<span class="gtkdoc opt">,</span>Z<span class="gtkdoc opt">)) {...}</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
 <p>See also <a class="link" href="cairo-Version-Information.html#cairo-version-string" title="cairo_version_string ()"><code class="function">cairo_version_string()</code></a> as well as the compile-time
 equivalents <a class="link" href="cairo-Version-Information.html#CAIRO-VERSION:CAPS" title="CAIRO_VERSION"><code class="literal">CAIRO_VERSION</code></a> and <a class="link" href="cairo-Version-Information.html#CAIRO-VERSION-STRING:CAPS" title="CAIRO_VERSION_STRING"><code class="literal">CAIRO_VERSION_STRING</code></a>.</p>
 <div class="refsect3">
@@ -351,6 +372,6 @@ at compile-time, in the form of "X.Y.Z".</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="cairo-fonts.html" title="Fonts">
 <link rel="prev" href="cairo-FreeType-Fonts.html" title="FreeType Fonts">
 <link rel="next" href="cairo-Quartz-(CGFont)-Fonts.html" title="Quartz (CGFont) Fonts">
-<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -221,7 +221,7 @@ and can be used with functions such as <a class="link" href="cairo-Win32-Fonts.h
 <td class="parameter_name"><p>logfont</p></td>
 <td class="parameter_description"><p>A <span class="type">LOGFONTW</span> structure specifying the font to use.
 If <em class="parameter"><code>font</code></em>
-is <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the lfHeight, lfWidth, lfOrientation and lfEscapement
+is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the lfHeight, lfWidth, lfOrientation and lfEscapement
 fields of this structure are ignored. Otherwise lfWidth, lfOrientation and
 lfEscapement must be zero.</p></td>
 <td class="parameter_annotations"> </td>
@@ -431,6 +431,6 @@ This macro can be used to conditionally compile backend-specific code.</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="cairo-surfaces.html" title="Surfaces">
 <link rel="prev" href="cairo-Recording-Surfaces.html" title="Recording Surfaces">
 <link rel="next" href="cairo-SVG-Surfaces.html" title="SVG Surfaces">
-<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -68,6 +68,14 @@
 <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *
 </td>
 <td class="function_name">
+<a class="link" href="cairo-Win32-Surfaces.html#cairo-win32-surface-create-with-format" title="cairo_win32_surface_create_with_format ()">cairo_win32_surface_create_with_format</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *
+</td>
+<td class="function_name">
 <a class="link" href="cairo-Win32-Surfaces.html#cairo-win32-printing-surface-create" title="cairo_win32_printing_surface_create ()">cairo_win32_printing_surface_create</a> <span class="c_punctuation">()</span>
 </td>
 </tr>
@@ -124,7 +132,7 @@ queried for its initial clip extents, and this will be used as the
 size of the cairo surface.  The resulting surface will always be of
 format <a class="link" href="cairo-Image-Surfaces.html#CAIRO-FORMAT-RGB24:CAPS"><code class="literal">CAIRO_FORMAT_RGB24</code></a>; should you need another surface format,
 you will need to create one through
-<code class="function">cairo_win32_surface_create_with_format()</code> or
+<a class="link" href="cairo-Win32-Surfaces.html#cairo-win32-surface-create-with-format" title="cairo_win32_surface_create_with_format ()"><code class="function">cairo_win32_surface_create_with_format()</code></a> or
 <a class="link" href="cairo-Win32-Surfaces.html#cairo-win32-surface-create-with-dib" title="cairo_win32_surface_create_with_dib ()"><code class="function">cairo_win32_surface_create_with_dib()</code></a>.</p>
 <div class="refsect3">
 <a name="cairo-win32-surface-create.parameters"></a><h4>Parameters</h4>
@@ -241,6 +249,52 @@ bitmap will be uninitialized.</p>
 </div>
 <hr>
 <div class="refsect2">
+<a name="cairo-win32-surface-create-with-format"></a><h3>cairo_win32_surface_create_with_format ()</h3>
+<pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *
+cairo_win32_surface_create_with_format
+                               (<em class="parameter"><code><span class="type">HDC</span> hdc</code></em>,
+                                <em class="parameter"><code><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> format</code></em>);</pre>
+<p>Creates a cairo surface that targets the given DC.  The DC will be
+queried for its initial clip extents, and this will be used as the
+size of the cairo surface.</p>
+<p>Supported formats are:
+<a class="link" href="cairo-Image-Surfaces.html#CAIRO-FORMAT-ARGB32:CAPS"><code class="literal">CAIRO_FORMAT_ARGB32</code></a>
+<a class="link" href="cairo-Image-Surfaces.html#CAIRO-FORMAT-RGB24:CAPS"><code class="literal">CAIRO_FORMAT_RGB24</code></a></p>
+<p>Note: <em class="parameter"><code>format</code></em>
+ only tells cairo how to draw on the surface, not what
+the format of the surface is. Namely, cairo does not (and cannot)
+check that <em class="parameter"><code>hdc</code></em>
+ actually supports alpha-transparency.</p>
+<div class="refsect3">
+<a name="cairo-win32-surface-create-with-format.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>hdc</p></td>
+<td class="parameter_description"><p>the DC to create a surface for</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>format</p></td>
+<td class="parameter_description"><p>format of pixels in the surface to create</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="cairo-win32-surface-create-with-format.returns"></a><h4>Returns</h4>
+<p> the newly created surface, NULL on failure</p>
+</div>
+<p class="since">Since: 1.14</p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="cairo-win32-printing-surface-create"></a><h3>cairo_win32_printing_surface_create ()</h3>
 <pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *
 cairo_win32_printing_surface_create (<em class="parameter"><code><span class="type">HDC</span> hdc</code></em>);</pre>
@@ -278,8 +332,8 @@ associated methods must be used for correct output.</p>
 <a name="cairo-win32-surface-get-dc"></a><h3>cairo_win32_surface_get_dc ()</h3>
 <pre class="programlisting"><span class="returnvalue">HDC</span>
 cairo_win32_surface_get_dc (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
-<p>Returns the HDC associated with this surface, or <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none.
-Also returns <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the surface is not a win32 surface.</p>
+<p>Returns the HDC associated with this surface, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none.
+Also returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the surface is not a win32 surface.</p>
 <p>A call to <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-flush" title="cairo_surface_flush ()"><code class="function">cairo_surface_flush()</code></a> is required before using the HDC to
 ensure that all pending drawing operations are finished and to
 restore any temporary modification cairo has made to its state. A
@@ -302,7 +356,7 @@ the content of the HDC has been modified.</p>
 </div>
 <div class="refsect3">
 <a name="cairo-win32-surface-get-dc.returns"></a><h4>Returns</h4>
-<p> HDC or <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no HDC available.</p>
+<p> HDC or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no HDC available.</p>
 </div>
 <p class="since">Since: 1.2</p>
 </div>
@@ -313,7 +367,7 @@ the content of the HDC has been modified.</p>
 cairo_win32_surface_get_image (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
 <p>Returns a <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> image surface that refers to the same bits
 as the DIB of the Win32 surface.  If the passed-in win32 surface
-is not a DIB surface, <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned.</p>
+is not a DIB surface, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned.</p>
 <div class="refsect3">
 <a name="cairo-win32-surface-get-image.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -332,7 +386,7 @@ is not a DIB surface, <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.
 <div class="refsect3">
 <a name="cairo-win32-surface-get-image.returns"></a><h4>Returns</h4>
 <p> a <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> (owned by the win32 <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>),
-or <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the win32 surface is not a DIB.</p>
+or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the win32 surface is not a DIB.</p>
 </div>
 <p class="since">Since: 1.4</p>
 </div>
@@ -354,6 +408,6 @@ This macro can be used to conditionally compile backend-specific code.</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/cairo/cairo-XCB-Surfaces.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="cairo-surfaces.html" title="Surfaces">
 <link rel="prev" href="cairo-Quartz-Surfaces.html" title="Quartz Surfaces">
 <link rel="next" href="cairo-XLib-Surfaces.html" title="XLib Surfaces">
-<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -323,14 +323,14 @@ children will be included.</p>
 <td class="parameter_annotations"> </td>
 </tr>
 <tr>
-<td class="parameter_name"><p>screen</p></td>
-<td class="parameter_description"><p>the XCB screen associated with <em class="parameter"><code>drawable</code></em>
-</p></td>
+<td class="parameter_name"><p>drawable</p></td>
+<td class="parameter_description"><p>an XCB drawable</p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 <tr>
-<td class="parameter_name"><p>drawable</p></td>
-<td class="parameter_description"><p>an XCB drawable</p></td>
+<td class="parameter_name"><p>screen</p></td>
+<td class="parameter_description"><p>the XCB screen associated with <em class="parameter"><code>drawable</code></em>
+</p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 <tr>
@@ -645,8 +645,6 @@ This macro can be used to conditionally compile backend-specific code.</p>
 <a name="CAIRO-HAS-XCB-SHM-FUNCTIONS:CAPS"></a><h3>CAIRO_HAS_XCB_SHM_FUNCTIONS</h3>
 <pre class="programlisting">#define CAIRO_HAS_XCB_SHM_FUNCTIONS 1
 </pre>
-<p>
-</p>
 </div>
 </div>
 <div class="refsect1">
@@ -655,6 +653,6 @@ This macro can be used to conditionally compile backend-specific code.</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-Surfaces.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="cairo-surfaces.html" title="Surfaces">
 <link rel="prev" href="cairo-XCB-Surfaces.html" title="XCB Surfaces">
 <link rel="next" href="cairo-XLib-XRender-Backend.html" title="XLib-XRender Backend">
-<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -502,7 +502,7 @@ constructor.</p>
 </div>
 <div class="refsect3">
 <a name="cairo-xlib-surface-get-visual.returns"></a><h4>Returns</h4>
-<p> the Visual or <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is no appropriate Visual for
+<p> the Visual or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is no appropriate Visual for
 <em class="parameter"><code>surface</code></em>
 .</p>
 </div>
@@ -708,6 +708,6 @@ This macro can be used to conditionally compile backend-specific code.</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-XRender-Backend.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="cairo-surfaces.html" title="Surfaces">
 <link rel="prev" href="cairo-XLib-Surfaces.html" title="XLib Surfaces">
 <link rel="next" href="cairo-Script-Surfaces.html" title="Script Surfaces">
-<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -180,7 +180,7 @@ value is the format passed to that constructor.</p>
 <a name="cairo-xlib-surface-get-xrender-format.returns"></a><h4>Returns</h4>
 <p> the XRenderPictFormat* associated with <em class="parameter"><code>surface</code></em>
 ,
-or <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the surface is not an xlib surface
+or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the surface is not an xlib surface
 or if the X Render extension is not available.</p>
 </div>
 <p class="since">Since: 1.6</p>
@@ -203,6 +203,6 @@ This macro can be used to conditionally compile backend-specific code.</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-device-t.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="cairo-surfaces.html" title="Surfaces">
 <link rel="prev" href="cairo-surfaces.html" title="Surfaces">
 <link rel="next" href="cairo-cairo-surface-t.html" title="cairo_surface_t">
-<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -223,28 +223,55 @@ in a multithreaded environment. This is done internally, but can also
 be used by applications.</p>
 <p>Putting this all together, a function that works with devices should
 look something like this:</p>
-<div class="informalexample"><pre class="programlisting">
-void
-my_device_modifying_function (cairo_device_t *device)
-{
-  cairo_status_t status;
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">void</span>
+<span class="function">my_device_modifying_function</span> <span class="gtkdoc opt">(</span>cairo_device_t <span class="gtkdoc opt">*</span>device<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  cairo_status_t status<span class="gtkdoc opt">;</span>
-  // Ensure the device is properly reset
-  cairo_device_flush (device);
-  // Try to acquire the device
-  status = cairo_device_acquire (device);
-  if (status != CAIRO_STATUS_SUCCESS) {
-    printf ("Failed to acquire the device: %s\n", cairo_status_to_string (status));
-    return;
-  }
+  <span class="gtkdoc slc">// Ensure the device is properly reset</span>
+  <span class="function"><a href="cairo-cairo-device-t.html#cairo-device-flush">cairo_device_flush</a></span> <span class="gtkdoc opt">(</span>device<span class="gtkdoc opt">);</span>
+  <span class="gtkdoc slc">// Try to acquire the device</span>
+  status <span class="gtkdoc opt">=</span> <span class="function"><a href="cairo-cairo-device-t.html#cairo-device-acquire">cairo_device_acquire</a></span> <span class="gtkdoc opt">(</span>device<span class="gtkdoc opt">);</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>status <span class="gtkdoc opt">!=</span> CAIRO_STATUS_SUCCESS<span class="gtkdoc opt">) {</span>
+    <span class="function">printf</span> <span class="gtkdoc opt">(</span><span class="string">&quot;Failed to acquire the device: %s</span><span class="gtkdoc esc">\n</span><span class="string">&quot;</span><span class="gtkdoc opt">,</span> <span class="function"><a href="cairo-Error-handling.html#cairo-status-to-string">cairo_status_to_string</a></span> <span class="gtkdoc opt">(</span>status<span class="gtkdoc opt">));</span>
+    <span class="keyword">return</span><span class="gtkdoc opt">;</span>
+  <span class="gtkdoc opt">}</span>
-  // Do the custom operations on the device here.
-  // But do not call any Cairo functions that might acquire devices.
+  <span class="gtkdoc slc">// Do the custom operations on the device here.</span>
+  <span class="gtkdoc slc">// But do not call any Cairo functions that might acquire devices.</span>
-  // Release the device when done.
-  cairo_device_release (device);
-}
-</pre></div>
+  <span class="gtkdoc slc">// Release the device when done.</span>
+  <span class="function"><a href="cairo-cairo-device-t.html#cairo-device-release">cairo_device_release</a></span> <span class="gtkdoc opt">(</span>device<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
 <div class="note"><p>Please refer to the documentation of each backend for
 additional usage requirements, guarantees provided, and
 interactions with existing surface API of the device functions for
@@ -475,7 +502,7 @@ cairo_device_set_user_data (<em class="parameter"><code><a class="link" href="ca
                             <em class="parameter"><code><a class="link" href="cairo-Types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()"><span class="type">cairo_destroy_func_t</span></a> destroy</code></em>);</pre>
 <p>Attach user data to <em class="parameter"><code>device</code></em>
 .  To remove user data from a surface,
-call this function with the key that was used to set it and <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
+call this function with the key that was used to set it and <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 for <em class="parameter"><code>data</code></em>
 .</p>
 <div class="refsect3">
@@ -528,7 +555,7 @@ cairo_device_get_user_data (<em class="parameter"><code><a class="link" href="ca
 <p>Return user data previously attached to <em class="parameter"><code>device</code></em>
  using the
 specified key.  If no user data has been attached with the given
-key this function returns <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
+key this function returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
 <div class="refsect3">
 <a name="cairo-device-get-user-data.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -554,7 +581,7 @@ attached to</p></td>
 </div>
 <div class="refsect3">
 <a name="cairo-device-get-user-data.returns"></a><h4>Returns</h4>
-<p> the user data previously attached or <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
+<p> the user data previously attached or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
 </div>
 <p class="since">Since: 1.10</p>
 </div>
@@ -634,40 +661,30 @@ that function for details.</p>
 <a name="cairo-device-observer-elapsed"></a><h3>cairo_device_observer_elapsed ()</h3>
 <pre class="programlisting"><span class="returnvalue">double</span>
 cairo_device_observer_elapsed (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="cairo-device-observer-fill-elapsed"></a><h3>cairo_device_observer_fill_elapsed ()</h3>
 <pre class="programlisting"><span class="returnvalue">double</span>
 cairo_device_observer_fill_elapsed (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="cairo-device-observer-glyphs-elapsed"></a><h3>cairo_device_observer_glyphs_elapsed ()</h3>
 <pre class="programlisting"><span class="returnvalue">double</span>
 cairo_device_observer_glyphs_elapsed (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="cairo-device-observer-mask-elapsed"></a><h3>cairo_device_observer_mask_elapsed ()</h3>
 <pre class="programlisting"><span class="returnvalue">double</span>
 cairo_device_observer_mask_elapsed (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="cairo-device-observer-paint-elapsed"></a><h3>cairo_device_observer_paint_elapsed ()</h3>
 <pre class="programlisting"><span class="returnvalue">double</span>
 cairo_device_observer_paint_elapsed (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -676,16 +693,12 @@ cairo_device_observer_paint_elapsed (<em class="parameter"><code><a class="link"
 cairo_device_observer_print (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>,
                              <em class="parameter"><code><a class="link" href="cairo-PNG-Support.html#cairo-write-func-t" title="cairo_write_func_t ()"><span class="type">cairo_write_func_t</span></a> write_func</code></em>,
                              <em class="parameter"><code><span class="type">void</span> *closure</code></em>);</pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="cairo-device-observer-stroke-elapsed"></a><h3>cairo_device_observer_stroke_elapsed ()</h3>
 <pre class="programlisting"><span class="returnvalue">double</span>
 cairo_device_observer_stroke_elapsed (<em class="parameter"><code><a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a> *device</code></em>);</pre>
-<p>
-</p>
 </div>
 </div>
 <div class="refsect1">
@@ -803,6 +816,6 @@ the wrong type is undefined.</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>