Import upstream release 1.11.21.11.2upstream-experimental

1 files changed, 19 insertions, 18 deletions

diff --git a/doc/public/html/cairo-PostScript-Surfaces.html b/doc/public/html/cairo-PostScript-Surfaces.html
index 630f66a..ccdf26f 100644
--- a/doc/public/html/cairo-PostScript-Surfaces.html
+++ b/doc/public/html/cairo-PostScript-Surfaces.html
@@ -475,7 +475,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 +502,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,18 +529,17 @@ 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:
@@ -546,7 +547,7 @@ Here is an example sequence showing how this function might be used:
 <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_surface_t *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")