RubyGems - cairo - Versions diffs - 1.12.4-x86-mingw32 → 1.12.5-x86-mingw32 - Mend

cairo 1.12.4-x86-mingw32 → 1.12.5-x86-mingw32

Potentially problematic release.

This version of cairo might be problematic. Click here for more details.

Files changed (931) hide show

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

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>PostScript Surfaces</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
 <link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
 <link rel="up" href="cairo-surfaces.html" title="Surfaces">
 <link rel="prev" href="cairo-PNG-Support.html" title="PNG Support">
 <link rel="next" href="cairo-Recording-Surfaces.html" title="Recording Surfaces">
-<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -26,7 +26,7 @@
                   <a href="#cairo-PostScript-Surfaces.description" class="shortcut">Description</a>
 </td></tr>
 </table>
-<div class="refentry" title="PostScript Surfaces">
+<div class="refentry">
 <a name="cairo-PostScript-Surfaces"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
 <td valign="top">
@@ -35,7 +35,7 @@
 </td>
 <td valign="top" align="right"></td>
 </tr></table></div>
-<div class="refsynopsisdiv" title="Synopsis">
+<div class="refsynopsisdiv">
 <a name="cairo-PostScript-Surfaces.synopsis"></a><h2>Synopsis</h2>
 <pre class="synopsis">#define             <a class="link" href="cairo-PostScript-Surfaces.html#CAIRO-HAS-PS-SURFACE:CAPS" title="CAIRO_HAS_PS_SURFACE">CAIRO_HAS_PS_SURFACE</a>
 <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *   <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-create" title="cairo_ps_surface_create ()">cairo_ps_surface_create</a>             (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
@@ -64,16 +64,16 @@ const <span class="returnvalue">char</span> *        <a class="link" href="cairo
                                                          <em class="parameter"><code>const <span class="type">char</span> *comment</code></em>);
 </pre>
 </div>
-<div class="refsect1" title="Description">
+<div class="refsect1">
 <a name="cairo-PostScript-Surfaces.description"></a><h2>Description</h2>
 <p>
 The PostScript surface is used to render cairo graphics to Adobe
 PostScript files and is a multi-page vector surface backend.
 </p>
 </div>
-<div class="refsect1" title="Details">
+<div class="refsect1">
 <a name="cairo-PostScript-Surfaces.details"></a><h2>Details</h2>
-<div class="refsect2" title="CAIRO_HAS_PS_SURFACE">
+<div class="refsect2">
 <a name="CAIRO-HAS-PS-SURFACE:CAPS"></a><h3>CAIRO_HAS_PS_SURFACE</h3>
 <pre class="programlisting">#define CAIRO_HAS_PS_SURFACE 1
 </pre>
@@ -81,9 +81,10 @@ PostScript files and is a multi-page vector surface backend.
 Defined if the PostScript surface backend is available.
 This macro can be used to conditionally compile backend-specific code.
 </p>
+<p class="since">Since 1.2</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ps_surface_create ()">
+<div class="refsect2">
 <a name="cairo-ps-surface-create"></a><h3>cairo_ps_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_ps_surface_create             (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
                                                          <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
@@ -103,40 +104,34 @@ vary. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
-<td>a filename for the PS output (must be writable), <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> may be
-           used to specify no output. This will generate a PS surface that
-           may be queried and used as a source, without generating a
-           temporary file.
-</td>
+<td>a filename for the PS output (must be writable), <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> may be
+used to specify no output. This will generate a PS surface that
+may be queried and used as a source, without generating a
+temporary file.</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>width_in_points</code></em> :</span></p></td>
-<td>width of the surface, in points (1 point == 1/72.0 inch)
-</td>
+<td>width of the surface, in points (1 point == 1/72.0 inch)</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>height_in_points</code></em> :</span></p></td>
-<td>height of the surface, in points (1 point == 1/72.0 inch)
-</td>
+<td>height of the surface, in points (1 point == 1/72.0 inch)</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> a pointer to the newly created surface. The caller
+<td>a pointer to the newly created surface. The caller
 owns the surface and should call <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-destroy" title="cairo_surface_destroy ()"><code class="function">cairo_surface_destroy()</code></a> when done
 with it.
 This function always returns a valid pointer, but it will return a
 pointer to a "nil" surface if an error such as out of memory
-occurs. You can use <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.
-</td>
+occurs. You can use <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.2</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ps_surface_create_for_stream ()">
+<div class="refsect2">
 <a name="cairo-ps-surface-create-for-stream"></a><h3>cairo_ps_surface_create_for_stream ()</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_ps_surface_create_for_stream  (<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>,
@@ -157,11 +152,10 @@ output can vary. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>write_func</code></em> :</span></p></td>
-<td>a <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> to accept the output data, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
-             to indicate a no-op <em class="parameter"><code>write_func</code></em>. With a no-op <em class="parameter"><code>write_func</code></em>,
-             the surface may be queried or used as a source without
-             generating any temporary files.
-</td>
+<td>a <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> to accept the output data, may be <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
+to indicate a no-op <em class="parameter"><code>write_func</code></em>. With a no-op <em class="parameter"><code>write_func</code></em>,
+the surface may be queried or used as a source without
+generating any temporary files.</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>closure</code></em> :</span></p></td>
@@ -170,32 +164,27 @@ output can vary. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>width_in_points</code></em> :</span></p></td>
-<td>width of the surface, in points (1 point == 1/72.0 inch)
-</td>
+<td>width of the surface, in points (1 point == 1/72.0 inch)</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>height_in_points</code></em> :</span></p></td>
-<td>height of the surface, in points (1 point == 1/72.0 inch)
-</td>
+<td>height of the surface, in points (1 point == 1/72.0 inch)</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> a pointer to the newly created surface. The caller
+<td>a pointer to the newly created surface. The caller
 owns the surface and should call <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-destroy" title="cairo_surface_destroy ()"><code class="function">cairo_surface_destroy()</code></a> when done
 with it.
 This function always returns a valid pointer, but it will return a
 pointer to a "nil" surface if an error such as out of memory
-occurs. You can use <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.
-</td>
+occurs. You can use <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.2</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ps_surface_restrict_to_level ()">
+<div class="refsect2">
 <a name="cairo-ps-surface-restrict-to-level"></a><h3>cairo_ps_surface_restrict_to_level ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                cairo_ps_surface_restrict_to_level  (<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>,
                                                          <em class="parameter"><code><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> level</code></em>);</pre>
@@ -220,17 +209,16 @@ surface.
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
-<td>PostScript level
-</td>
+<td>PostScript level</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.6</p>
 </div>
 <hr>
-<div class="refsect2" title="enum cairo_ps_level_t">
+<div class="refsect2">
 <a name="cairo-ps-level-t"></a><h3>enum cairo_ps_level_t</h3>
-<pre class="programlisting">typedef enum _cairo_ps_level {
+<pre class="programlisting">typedef enum {
     CAIRO_PS_LEVEL_2,
     CAIRO_PS_LEVEL_3
 } cairo_ps_level_t;
@@ -245,19 +233,20 @@ conform to.
 <tbody>
 <tr>
 <td><p><a name="CAIRO-PS-LEVEL-2:CAPS"></a><span class="term"><code class="literal">CAIRO_PS_LEVEL_2</code></span></p></td>
-<td>The language level 2 of the PostScript specification.
+<td>The language level 2 of the PostScript specification. (Since 1.6)
 </td>
 </tr>
 <tr>
 <td><p><a name="CAIRO-PS-LEVEL-3:CAPS"></a><span class="term"><code class="literal">CAIRO_PS_LEVEL_3</code></span></p></td>
-<td>The language level 3 of the PostScript specification.
+<td>The language level 3 of the PostScript specification. (Since 1.6)
 </td>
 </tr>
 </tbody>
 </table></div>
+<p class="since">Since 1.6</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ps_get_levels ()">
+<div class="refsect2">
 <a name="cairo-ps-get-levels"></a><h3>cairo_ps_get_levels ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                cairo_ps_get_levels                 (<em class="parameter"><code><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> const **levels</code></em>,
                                                          <em class="parameter"><code><span class="type">int</span> *num_levels</code></em>);</pre>
@@ -270,25 +259,23 @@ Used to retrieve the list of supported levels. See
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>levels</code></em> :</span></p></td>
-<td>supported level list
-</td>
+<td>supported level list</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>num_levels</code></em> :</span></p></td>
-<td>list length
-</td>
+<td>list length</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.6</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ps_level_to_string ()">
+<div class="refsect2">
 <a name="cairo-ps-level-to-string"></a><h3>cairo_ps_level_to_string ()</h3>
 <pre class="programlisting">const <span class="returnvalue">char</span> *        cairo_ps_level_to_string            (<em class="parameter"><code><a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-level-t" title="enum cairo_ps_level_t"><span class="type">cairo_ps_level_t</span></a> level</code></em>);</pre>
 <p>
 Get the string representation of the given <em class="parameter"><code>level</code></em> id. This function
-will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>level</code></em> id isn't valid. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-get-levels" title="cairo_ps_get_levels ()"><code class="function">cairo_ps_get_levels()</code></a>
+will return <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>level</code></em> id isn't valid. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-get-levels" title="cairo_ps_get_levels ()"><code class="function">cairo_ps_get_levels()</code></a>
 for a way to get the list of valid level ids.
 </p>
 <div class="variablelist"><table border="0">
@@ -296,26 +283,23 @@ for a way to get the list of valid level ids.
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
-<td>a level id
-</td>
+<td>a level id</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> the string associated to given level.
-</td>
+<td>the string associated to given level.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.6</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ps_surface_set_eps ()">
+<div class="refsect2">
 <a name="cairo-ps-surface-set-eps"></a><h3>cairo_ps_surface_set_eps ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                cairo_ps_surface_set_eps            (<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>,
                                                          <em class="parameter"><code><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="type">cairo_bool_t</span></a> eps</code></em>);</pre>
 <p>
-If <em class="parameter"><code>eps</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the PostScript surface will output Encapsulated
+If <em class="parameter"><code>eps</code></em> is <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the PostScript surface will output Encapsulated
 PostScript.
 </p>
 <p>
@@ -336,15 +320,14 @@ than one page.
 <tr>
 <td><p><span class="term"><em class="parameter"><code>eps</code></em> :</span></p></td>
 <td>
-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to output EPS format PostScript
-</td>
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to output EPS format PostScript</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.6</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ps_surface_get_eps ()">
+<div class="refsect2">
 <a name="cairo-ps-surface-get-eps"></a><h3>cairo_ps_surface_get_eps ()</h3>
 <pre class="programlisting"><a class="link" href="cairo-Types.html#cairo-bool-t" title="cairo_bool_t"><span class="returnvalue">cairo_bool_t</span></a>        cairo_ps_surface_get_eps            (<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>
@@ -360,16 +343,15 @@ Check whether the PostScript surface will output Encapsulated PostScript.
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the surface will output Encapsulated PostScript.
-</td>
+<td>
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the surface will output Encapsulated PostScript.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.6</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ps_surface_set_size ()">
+<div class="refsect2">
 <a name="cairo-ps-surface-set-size"></a><h3>cairo_ps_surface_set_size ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                cairo_ps_surface_set_size           (<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>,
                                                          <em class="parameter"><code><span class="type">double</span> width_in_points</code></em>,
@@ -395,20 +377,18 @@ surface or immediately after completing a page with either
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>width_in_points</code></em> :</span></p></td>
-<td>new surface width, in points (1 point == 1/72.0 inch)
-</td>
+<td>new surface width, in points (1 point == 1/72.0 inch)</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>height_in_points</code></em> :</span></p></td>
-<td>new surface height, in points (1 point == 1/72.0 inch)
-</td>
+<td>new surface height, in points (1 point == 1/72.0 inch)</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.2</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ps_surface_dsc_begin_setup ()">
+<div class="refsect2">
 <a name="cairo-ps-surface-dsc-begin-setup"></a><h3>cairo_ps_surface_dsc_begin_setup ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                cairo_ps_surface_dsc_begin_setup    (<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>
@@ -435,7 +415,7 @@ See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-co
 <p class="since">Since 1.2</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ps_surface_dsc_begin_page_setup ()">
+<div class="refsect2">
 <a name="cairo-ps-surface-dsc-begin-page-setup"></a><h3>cairo_ps_surface_dsc_begin_page_setup ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                cairo_ps_surface_dsc_begin_page_setup
                                                         (<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>
@@ -464,7 +444,7 @@ See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-co
 <p class="since">Since 1.2</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ps_surface_dsc_comment ()">
+<div class="refsect2">
 <a name="cairo-ps-surface-dsc-comment"></a><h3>cairo_ps_surface_dsc_comment ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                cairo_ps_surface_dsc_comment        (<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>,
                                                          <em class="parameter"><code>const <span class="type">char</span> *comment</code></em>);</pre>
@@ -475,7 +455,7 @@ Emit a comment into the PostScript output for the given surface.
 The comment is expected to conform to the PostScript Language
 Document Structuring Conventions (DSC). Please see that manual for
 details on the available comments and their meanings. In
-particular, the %<code class="literal">IncludeFeature</code> comment allows a
+particular, the %%IncludeFeature comment allows a
 device-independent means of controlling printer device features. So
 the PostScript Printer Description Files Specification will also be
 a useful reference.
@@ -502,24 +482,26 @@ section apply only to a single page.
 <p>
 For comments to appear in the header section, this function should
 be called after the surface is created, but before a call to
-<code class="function">cairo_ps_surface_begin_setup()</code>.
+<a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-setup" title="cairo_ps_surface_dsc_begin_setup ()"><code class="function">cairo_ps_surface_dsc_begin_setup()</code></a>.
 </p>
 <p>
 For comments to appear in the Setup section, this function should
-be called after a call to <code class="function">cairo_ps_surface_begin_setup()</code> but before
-a call to <code class="function">cairo_ps_surface_begin_page_setup()</code>.
+be called after a call to <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-setup" title="cairo_ps_surface_dsc_begin_setup ()"><code class="function">cairo_ps_surface_dsc_begin_setup()</code></a> but
+before a call to <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()"><code class="function">cairo_ps_surface_dsc_begin_page_setup()</code></a>.
 </p>
 <p>
 For comments to appear in the PageSetup section, this function
-should be called after a call to <code class="function">cairo_ps_surface_begin_page_setup()</code>.
+should be called after a call to
+<a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()"><code class="function">cairo_ps_surface_dsc_begin_page_setup()</code></a>.
 </p>
 <p>
-Note that it is only necessary to call <code class="function">cairo_ps_surface_begin_page_setup()</code>
-for the first page of any surface. After a call to
-<a class="link" href="cairo-cairo-t.html#cairo-show-page" title="cairo_show_page ()"><code class="function">cairo_show_page()</code></a> or <a class="link" href="cairo-cairo-t.html#cairo-copy-page" title="cairo_copy_page ()"><code class="function">cairo_copy_page()</code></a> comments are unambiguously
-directed to the PageSetup section of the current page. But it
-doesn't hurt to call this function at the beginning of every page
-as that consistency may make the calling code simpler.
+Note that it is only necessary to call
+<a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-page-setup" title="cairo_ps_surface_dsc_begin_page_setup ()"><code class="function">cairo_ps_surface_dsc_begin_page_setup()</code></a> for the first page of any
+surface. After a call to <a class="link" href="cairo-cairo-t.html#cairo-show-page" title="cairo_show_page ()"><code class="function">cairo_show_page()</code></a> or <a class="link" href="cairo-cairo-t.html#cairo-copy-page" title="cairo_copy_page ()"><code class="function">cairo_copy_page()</code></a>
+comments are unambiguously directed to the PageSetup section of the
+current page. But it doesn't hurt to call this function at the
+beginning of every page as that consistency may make the calling
+code simpler.
 </p>
 <p>
 As a final note, cairo automatically generates several comments on
@@ -527,44 +509,68 @@ its own. As such, applications must not manually generate any of
 the following comments:
 </p>
 <p>
-Header section: %!PS-Adobe-3.0, %<code class="literal">Creator</code>, %<code class="literal">CreationDate</code>, %<code class="literal">Pages</code>,
-%<code class="literal">BoundingBox</code>, %<code class="literal">DocumentData</code>, %<code class="literal">LanguageLevel</code>, %<code class="literal">EndComments</code>.
+Header section: %!PS-Adobe-3.0, %%Creator, %%CreationDate, %%Pages,
+%%BoundingBox, %%DocumentData, %%LanguageLevel, %%EndComments.
 </p>
 <p>
-Setup section: %<code class="literal">BeginSetup</code>, %<code class="literal">EndSetup</code>
+Setup section: %%BeginSetup, %%EndSetup
 </p>
 <p>
-PageSetup section: %<code class="literal">BeginPageSetup</code>, %<code class="literal">PageBoundingBox</code>,
-%<code class="literal">EndPageSetup</code>.
+PageSetup section: %%BeginPageSetup, %%PageBoundingBox, %%EndPageSetup.
 </p>
 <p>
-Other sections: %<code class="literal">BeginProlog</code>, %<code class="literal">EndProlog</code>, %<code class="literal">Page</code>, %<code class="literal">Trailer</code>, %<code class="literal">EOF</code>
+Other sections: %%BeginProlog, %%EndProlog, %%Page, %%Trailer, %%EOF
 </p>
 <p>
 Here is an example sequence showing how this function might be used:
 </p>
 <p>
 </p>
-<div class="informalexample"><pre class="programlisting">
-<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface = cairo_ps_surface_create (filename, width, height);
-...
-cairo_ps_surface_dsc_comment (surface, "%%Title: My excellent document");
-cairo_ps_surface_dsc_comment (surface, "%%Copyright: Copyright (C) 2006 Cairo Lover")
-...
-cairo_ps_surface_dsc_begin_setup (surface);
-cairo_ps_surface_dsc_comment (surface, "%%IncludeFeature: *MediaColor White");
-...
-cairo_ps_surface_dsc_begin_page_setup (surface);
-cairo_ps_surface_dsc_comment (surface, "%%IncludeFeature: *PageSize A3");
-cairo_ps_surface_dsc_comment (surface, "%%IncludeFeature: *InputSlot LargeCapacity");
-cairo_ps_surface_dsc_comment (surface, "%%IncludeFeature: *MediaType Glossy");
-cairo_ps_surface_dsc_comment (surface, "%%IncludeFeature: *MediaColor Blue");
-... draw to first page here ..
-cairo_show_page (cr);
-...
-cairo_ps_surface_dsc_comment (surface, "%%IncludeFeature: *PageSize A5");
-...
-</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
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18</pre></td>
+        <td class="listing_code"><pre class="programlisting">cairo_surface_t <span class="gtkdoc opt">*</span>surface <span class="gtkdoc opt">=</span> <span class="function"><a href="../cairo/cairo-PostScript-Surfaces.html#cairo-ps-surface-create">cairo_ps_surface_create</a></span> <span class="gtkdoc opt">(</span>filename<span class="gtkdoc opt">,</span> width<span class="gtkdoc opt">,</span> height<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">...</span>
+<span class="function"><a href="../cairo/cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment">cairo_ps_surface_dsc_comment</a></span> <span class="gtkdoc opt">(</span>surface<span class="gtkdoc opt">,</span> <span class="string">&quot;%%Title: My excellent document&quot;</span><span class="gtkdoc opt">);</span>
+<span class="function"><a href="../cairo/cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment">cairo_ps_surface_dsc_comment</a></span> <span class="gtkdoc opt">(</span>surface<span class="gtkdoc opt">,</span> <span class="string">&quot;%%Copyright: Copyright (C) 2006 Cairo Lover&quot;</span><span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">...</span>
+<span class="function"><a href="../cairo/cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-setup">cairo_ps_surface_dsc_begin_setup</a></span> <span class="gtkdoc opt">(</span>surface<span class="gtkdoc opt">);</span>
+<span class="function"><a href="../cairo/cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment">cairo_ps_surface_dsc_comment</a></span> <span class="gtkdoc opt">(</span>surface<span class="gtkdoc opt">,</span> <span class="string">&quot;%%IncludeFeature: *MediaColor White&quot;</span><span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">...</span>
+<span class="function"><a href="../cairo/cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-begin-page-setup">cairo_ps_surface_dsc_begin_page_setup</a></span> <span class="gtkdoc opt">(</span>surface<span class="gtkdoc opt">);</span>
+<span class="function"><a href="../cairo/cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment">cairo_ps_surface_dsc_comment</a></span> <span class="gtkdoc opt">(</span>surface<span class="gtkdoc opt">,</span> <span class="string">&quot;%%IncludeFeature: *PageSize A3&quot;</span><span class="gtkdoc opt">);</span>
+<span class="function"><a href="../cairo/cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment">cairo_ps_surface_dsc_comment</a></span> <span class="gtkdoc opt">(</span>surface<span class="gtkdoc opt">,</span> <span class="string">&quot;%%IncludeFeature: *InputSlot LargeCapacity&quot;</span><span class="gtkdoc opt">);</span>
+<span class="function"><a href="../cairo/cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment">cairo_ps_surface_dsc_comment</a></span> <span class="gtkdoc opt">(</span>surface<span class="gtkdoc opt">,</span> <span class="string">&quot;%%IncludeFeature: *MediaType Glossy&quot;</span><span class="gtkdoc opt">);</span>
+<span class="function"><a href="../cairo/cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment">cairo_ps_surface_dsc_comment</a></span> <span class="gtkdoc opt">(</span>surface<span class="gtkdoc opt">,</span> <span class="string">&quot;%%IncludeFeature: *MediaColor Blue&quot;</span><span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">...</span> draw to first page here <span class="gtkdoc opt">..</span>
+<span class="function"><a href="../cairo/cairo-cairo-t.html#cairo-show-page">cairo_show_page</a></span> <span class="gtkdoc opt">(</span>cr<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">...</span>
+<span class="function"><a href="../cairo/cairo-PostScript-Surfaces.html#cairo-ps-surface-dsc-comment">cairo_ps_surface_dsc_comment</a></span> <span class="gtkdoc opt">(</span>surface<span class="gtkdoc opt">,</span> <span class="string">&quot;%%IncludeFeature: *PageSize A5&quot;</span><span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">...</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
 <p>
 </p>
 <div class="variablelist"><table border="0">
@@ -577,21 +583,20 @@ cairo_ps_surface_dsc_comment (surface, "%%IncludeFeature: *PageSize A5");
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>comment</code></em> :</span></p></td>
-<td>a comment string to be emitted into the PostScript output
-</td>
+<td>a comment string to be emitted into the PostScript output</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.2</p>
 </div>
 </div>
-<div class="refsect1" title="See Also">
+<div class="refsect1">
 <a name="cairo-PostScript-Surfaces.see-also"></a><h2>See Also</h2>
 <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
 </div>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.15</div>
+          Generated by GTK-Doc V1.18</div>
 </body>
 </html>