cairo 1.15.10-x64-mingw32 → 1.15.11-x64-mingw32

data/vendor/local/share/doc/{libxml2-2.9.6 → libxml2-2.9.7}/html/xml.html

@@ -709,6 +709,50 @@ to the <a href="http://git.gnome.org/browse/libxml2/">GIT</a> code base.</p>
 
 <p>Here is the list of public releases:</p>
 
+<h3>2.9.7: Nov 02 2017</h3>
+<ul>
+  <li>Documentation:<br/>
+  xmlcatalog: refresh man page wrt. quering system catalog easily (Jan Pokorný)<br/>
+  </li>
+
+  <li>Portability:<br/>
+  Fix deprecated Travis compiler flag (Nick Wellnhofer),<br/>
+  Add declaration for DllMain (J. Peter Mugaas),<br/>
+  Fix preprocessor conditional in threads.h (J. Peter Mugaas),<br/>
+  Fix pointer comparison warnings on 64-bit Windows (J. Peter Mugaas),<br/>
+  Fix macro redefinition warning (J. Peter Mugaas),<br/>
+  Default to native threads on MinGW-w64 (Nick Wellnhofer),<br/>
+  Simplify Windows IO functions (Nick Wellnhofer),<br/>
+  Fix runtest on Windows (Nick Wellnhofer),<br/>
+  socklen_t is always int on Windows (Nick Wellnhofer),<br/>
+  Don't redefine socket error codes on Windows (Nick Wellnhofer),<br/>
+  Fix pointer/int cast warnings on 64-bit Windows (Nick Wellnhofer),<br/>
+  Fix Windows compiler warnings in xmlCanonicPath (Nick Wellnhofer)<br/>
+  </li>
+
+  <li>Bug Fixes:<br/>
+  xmlcatalog: restore ability to query system catalog easily (Jan Pokorný),<br/>
+  Fix comparison of nodesets to strings (Nick Wellnhofer)<br/>
+  </li>
+
+  <li>Improvements:<br/>
+  Add Makefile rules to rebuild HTML man pages (Nick Wellnhofer),<br/>
+  Fix mixed decls and code in timsort.h (Nick Wellnhofer),<br/>
+  Rework handling of return values in thread tests (Nick Wellnhofer),<br/>
+  Fix unused variable warnings in testrecurse (Nick Wellnhofer),<br/>
+  Fix -Wimplicit-fallthrough warnings (J. Peter Mugaas),<br/>
+  Upgrade timsort.h to latest revision (Nick Wellnhofer),<br/>
+  Increase warning level to /W3 under MSVC (Nick Wellnhofer),<br/>
+  Fix a couple of warnings in dict.c and threads.c (Nick Wellnhofer),<br/>
+  Update .gitignore for Windows (Nick Wellnhofer),<br/>
+  Fix unused variable warnings in nanohttp.c (Nick Wellnhofer),<br/>
+  Fix the Windows header mess (Nick Wellnhofer),<br/>
+  Don't include winsock2.h in xmllint.c (Nick Wellnhofer),<br/>
+  Remove generated file python/setup.py from version control (Nick Wellnhofer),<br/>
+  Use __linux__ macro in generated code (Nick Wellnhofer)<br/>
+  </li>
+
+</ul>
 <h3>v2.9.6: Oct 06 2017</h3>
 <ul>
   <li>Portability:<br/>

data/vendor/local/share/gtk-doc/html/cairo/cairo-Error-handling.html

@@ -204,7 +204,7 @@ to get a human-readable representation of an error message.</p>
 <tr>
 <td class="enum_member_name"><p><a name="CAIRO-STATUS-NULL-POINTER:CAPS"></a>CAIRO_STATUS_NULL_POINTER</p></td>
 <td class="enum_member_description">
-<p><code class="literal">NULL</code> pointer (Since 1.0)</p>
+<p><a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> pointer (Since 1.0)</p>
 </td>
 <td class="enum_member_annotations"> </td>
 </tr>

data/vendor/local/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html

@@ -339,7 +339,7 @@ FreeType backend font face (see <a class="link" href="cairo-FreeType-Fonts.html#
 <a name="cairo-ft-scaled-font-lock-face.returns"></a><h4>Returns</h4>
 <p> The <span class="type">FT_Face</span> object for <em class="parameter"><code>font</code></em>
 , scaled appropriately,
-or <code class="literal">NULL</code> if <em class="parameter"><code>scaled_font</code></em>
+or <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>scaled_font</code></em>
 is in an error state (see
 <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-status" title="cairo_scaled_font_status ()"><code class="function">cairo_scaled_font_status()</code></a>) or there is insufficient memory.</p>
 </div>

data/vendor/local/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html

@@ -341,7 +341,7 @@ the data is modified.</p>
 </div>
 <div class="refsect3">
 <a name="cairo-image-surface-get-data.returns"></a><h4>Returns</h4>
-<p> a pointer to the image data of this surface or <code class="literal">NULL</code>
+<p> a pointer to the image data of this surface or <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 if <em class="parameter"><code>surface</code></em>
 is not an image surface, or if <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-finish" title="cairo_surface_finish ()"><code class="function">cairo_surface_finish()</code></a>
 has been called.</p>

data/vendor/local/share/gtk-doc/html/cairo/cairo-PDF-Surfaces.html

@@ -159,19 +159,60 @@ PDF files and is a multi-page vector surface backend.</p>
 <p>The following mime types are supported: <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JPEG:CAPS" title="CAIRO_MIME_TYPE_JPEG"><code class="literal">CAIRO_MIME_TYPE_JPEG</code></a>,
 <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JP2:CAPS" title="CAIRO_MIME_TYPE_JP2"><code class="literal">CAIRO_MIME_TYPE_JP2</code></a>, <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-UNIQUE-ID:CAPS" title="CAIRO_MIME_TYPE_UNIQUE_ID"><code class="literal">CAIRO_MIME_TYPE_UNIQUE_ID</code></a>,
 <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2:CAPS" title="CAIRO_MIME_TYPE_JBIG2"><code class="literal">CAIRO_MIME_TYPE_JBIG2</code></a>, <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2-GLOBAL:CAPS" title="CAIRO_MIME_TYPE_JBIG2_GLOBAL"><code class="literal">CAIRO_MIME_TYPE_JBIG2_GLOBAL</code></a>,
-<a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2-GLOBAL-ID:CAPS" title="CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID"><code class="literal">CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID</code></a>.</p>
+<a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2-GLOBAL-ID:CAPS" title="CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID"><code class="literal">CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID</code></a>,
+<a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-CCITT-FAX:CAPS" title="CAIRO_MIME_TYPE_CCITT_FAX"><code class="literal">CAIRO_MIME_TYPE_CCITT_FAX</code></a>, <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-CCITT-FAX-PARAMS:CAPS" title="CAIRO_MIME_TYPE_CCITT_FAX_PARAMS"><code class="literal">CAIRO_MIME_TYPE_CCITT_FAX_PARAMS</code></a>.</p>
+<div class="refsect2">
+<a name="id-1.5.5.5.4"></a><h3>JBIG2 Images</h3>
 <p>JBIG2 data in PDF must be in the embedded format as described in
 ISO/IEC 11544. Image specific JBIG2 data must be in
 <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2:CAPS" title="CAIRO_MIME_TYPE_JBIG2"><code class="literal">CAIRO_MIME_TYPE_JBIG2</code></a>.  Any global segments in the JBIG2 data
 (segments with page association field set to 0) must be in
 <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2-GLOBAL:CAPS" title="CAIRO_MIME_TYPE_JBIG2_GLOBAL"><code class="literal">CAIRO_MIME_TYPE_JBIG2_GLOBAL</code></a>. The global data may be shared by
 multiple images. All images sharing the same global data must set
-<a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2-GLOBAL-ID:CAPS" title="CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID"><code class="literal">CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID</code></a> to a unique identifer. At least
+<a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2-GLOBAL-ID:CAPS" title="CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID"><code class="literal">CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID</code></a> to a unique identifier. At least
 one of the images must provide the global data using
 <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2-GLOBAL:CAPS" title="CAIRO_MIME_TYPE_JBIG2_GLOBAL"><code class="literal">CAIRO_MIME_TYPE_JBIG2_GLOBAL</code></a>. The global data will only be
-embedded once but shared by all JBIG2 images with the same
+embedded once and shared by all JBIG2 images with the same
 <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JBIG2-GLOBAL-ID:CAPS" title="CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID"><code class="literal">CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID</code></a>.</p>
 </div>
+<hr>
+<div class="refsect2">
+<a name="ccitt"></a><h3>CCITT Fax Images</h3>
+<p>The <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-CCITT-FAX:CAPS" title="CAIRO_MIME_TYPE_CCITT_FAX"><code class="literal">CAIRO_MIME_TYPE_CCITT_FAX</code></a> mime data requires a number of decoding
+parameters These parameters are specified using <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-CCITT-FAX-PARAMS:CAPS" title="CAIRO_MIME_TYPE_CCITT_FAX_PARAMS"><code class="literal">CAIRO_MIME_TYPE_CCITT_FAX_PARAMS</code></a>.</p>
+<p><a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-CCITT-FAX-PARAMS:CAPS" title="CAIRO_MIME_TYPE_CCITT_FAX_PARAMS"><code class="literal">CAIRO_MIME_TYPE_CCITT_FAX_PARAMS</code></a> mime data must contain a string of the form
+"param1=value1 param2=value2 ...".</p>
+<p><em class="parameter"><code>Columns</code></em>
+: [required] An integer specifying the width of the image in pixels.</p>
+<p><em class="parameter"><code>Rows</code></em>
+: [required] An integer specifying the height of the image in scan lines.</p>
+<p><em class="parameter"><code>K</code></em>
+: [optional] An integer identifying the encoding scheme used. &lt; 0
+is 2 dimensional Group 4, = 0 is Group3 1 dimensional, &gt; 0 is mixed 1
+and 2 dimensional encoding. Default is 0.</p>
+<p><em class="parameter"><code>EndOfLine</code></em>
+: [optional] If true end-of-line bit patterns are present. Default is false.</p>
+<p><em class="parameter"><code>EncodedByteAlign</code></em>
+: [optional] If true the end of line is padded
+with 0 bits so the next line begins on a byte boundary. Default is false.</p>
+<p><em class="parameter"><code>EndOfBlock</code></em>
+: [optional] If true the data contains an end-of-block pattern. Default is true.</p>
+<p><em class="parameter"><code>BlackIs1</code></em>
+: [optional] If true 1 bits are black pixels. Default is false.</p>
+<p><em class="parameter"><code>DamagedRowsBeforeError</code></em>
+: [optional] An integer specifying the
+number of damages rows tolerated before an error occurs. Default is 0.</p>
+<p>Boolean values may be "true" or "false", or 1 or 0.</p>
+<p>These parameters are the same as the CCITTFaxDecode parameters in the
+<a class="ulink" href="https://www.adobe.com/products/postscript/pdfs/PLRM.pdf" target="_top">PostScript Language Reference</a>
+and <a class="ulink" href="https://www.adobe.com/content/dam/Adobe/en/devnet/pdf/pdfs/PDF32000_2008.pdf" target="_top">Portable Document Format (PDF)</a>.
+Refer to these documents for further details.</p>
+<p>An example <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-CCITT-FAX-PARAMS:CAPS" title="CAIRO_MIME_TYPE_CCITT_FAX_PARAMS"><code class="literal">CAIRO_MIME_TYPE_CCITT_FAX_PARAMS</code></a> string is:</p>
+<pre class="programlisting">
+"Columns=10230 Rows=40000 K=1 EndOfLine=true EncodedByteAlign=1 BlackIs1=false"
+</pre>
+</div>
+</div>
 <div class="refsect1">
 <a name="cairo-PDF-Surfaces.functions_details"></a><h2>Functions</h2>
 <div class="refsect2">
@@ -194,7 +235,7 @@ to <em class="parameter"><code>filename</code></em>
 <tbody>
 <tr>
 <td class="parameter_name"><p>filename</p></td>
-<td class="parameter_description"><p>a filename for the PDF output (must be writable), <code class="literal">NULL</code> may be
+<td class="parameter_description"><p>a filename for the PDF output (must be writable), <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> may be
 used to specify no output. This will generate a PDF surface that
 may be queried and used as a source, without generating a
 temporary file.</p></td>
@@ -247,7 +288,7 @@ incrementally to the stream represented by <em class="parameter"><code>write_fun
 <tbody>
 <tr>
 <td class="parameter_name"><p>write_func</p></td>
-<td class="parameter_description"><p>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 <code class="literal">NULL</code>
+<td class="parameter_description"><p>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="/usr/share/gtk-doc/html/glibglib-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>
 ,
@@ -361,7 +402,7 @@ cairo_pdf_get_versions (<em class="parameter"><code><a class="link" href="cairo-
 cairo_pdf_version_to_string (<em class="parameter"><code><a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-version-t" title="enum cairo_pdf_version_t"><span class="type">cairo_pdf_version_t</span></a> version</code></em>);</pre>
 <p>Get the string representation of the given <em class="parameter"><code>version</code></em>
  id. This function
-will return <code class="literal">NULL</code> if <em class="parameter"><code>version</code></em>
+will return <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>version</code></em>
  isn't valid. See <a class="link" href="cairo-PDF-Surfaces.html#cairo-pdf-get-versions" title="cairo_pdf_get_versions ()"><code class="function">cairo_pdf_get_versions()</code></a>
 for a way to get the list of valid version ids.</p>
 <div class="refsect3">

data/vendor/local/share/gtk-doc/html/cairo/cairo-PNG-Support.html

@@ -133,7 +133,8 @@ given PNG file.</p>
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>filename</p></td>
-<td class="parameter_description"><p>name of PNG file to load</p></td>
+<td class="parameter_description"><p>name of PNG file to load. On Windows this filename
+is encoded in UTF-8.</p></td>
 <td class="parameter_annotations"> </td>
 </tr></tbody>
 </table></div>
@@ -276,7 +277,8 @@ image.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>filename</p></td>
-<td class="parameter_description"><p>the name of a file to write to</p></td>
+<td class="parameter_description"><p>the name of a file to write to; on Windows this filename
+is encoded in UTF-8.</p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 </tbody>

data/vendor/local/share/gtk-doc/html/cairo/cairo-Paths.html

@@ -248,7 +248,7 @@ cairo_copy_path (<em class="parameter"><code><a class="link" href="cairo-cairo-t
 <a class="link" href="cairo-Paths.html#cairo-path-t" title="cairo_path_t"><span class="type">cairo_path_t</span></a>. See <a class="link" href="cairo-Paths.html#cairo-path-data-t" title="union cairo_path_data_t"><span class="type">cairo_path_data_t</span></a> for hints on how to iterate
 over the returned data structure.</p>
 <p>This function will always return a valid pointer, but the result
-will have no data (<code class="literal">data==<code class="literal">NULL</code></code> and
+will have no data (<code class="literal">data==<a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></code> and
 <code class="literal">num_data==0</code>), if either of the following
 conditions hold:</p>
 <div class="orderedlist"><ol class="orderedlist" type="1">
@@ -297,7 +297,7 @@ value). That is, the result is guaranteed to not have any elements
 of type <a class="link" href="cairo-Paths.html#CAIRO-PATH-CURVE-TO:CAPS"><code class="literal">CAIRO_PATH_CURVE_TO</code></a> which will instead be replaced by a
 series of <a class="link" href="cairo-Paths.html#CAIRO-PATH-LINE-TO:CAPS"><code class="literal">CAIRO_PATH_LINE_TO</code></a> elements.</p>
 <p>This function will always return a valid pointer, but the result
-will have no data (<code class="literal">data==<code class="literal">NULL</code></code> and
+will have no data (<code class="literal">data==<a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></code> and
 <code class="literal">num_data==0</code>), if either of the following
 conditions hold:</p>
 <div class="orderedlist"><ol class="orderedlist" type="1">
@@ -1051,7 +1051,7 @@ serious text-using applications. See <a class="link" href="cairo-Paths.html#cair
 </tr>
 <tr>
 <td class="parameter_name"><p>utf8</p></td>
-<td class="parameter_description"><p>a NUL-terminated string of text encoded in UTF-8, or <code class="literal">NULL</code></p></td>
+<td class="parameter_description"><p>a NUL-terminated string of text encoded in UTF-8, or <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 </tbody>

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

@@ -152,6 +152,34 @@
 <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>
+<p>The following mime types are supported: <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JPEG:CAPS" title="CAIRO_MIME_TYPE_JPEG"><code class="literal">CAIRO_MIME_TYPE_JPEG</code></a>,
+<a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-UNIQUE-ID:CAPS" title="CAIRO_MIME_TYPE_UNIQUE_ID"><code class="literal">CAIRO_MIME_TYPE_UNIQUE_ID</code></a>,
+<a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-CCITT-FAX:CAPS" title="CAIRO_MIME_TYPE_CCITT_FAX"><code class="literal">CAIRO_MIME_TYPE_CCITT_FAX</code></a>, <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-CCITT-FAX-PARAMS:CAPS" title="CAIRO_MIME_TYPE_CCITT_FAX_PARAMS"><code class="literal">CAIRO_MIME_TYPE_CCITT_FAX_PARAMS</code></a>,
+<a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-CCITT-FAX:CAPS" title="CAIRO_MIME_TYPE_CCITT_FAX"><code class="literal">CAIRO_MIME_TYPE_CCITT_FAX</code></a>, <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-CCITT-FAX-PARAMS:CAPS" title="CAIRO_MIME_TYPE_CCITT_FAX_PARAMS"><code class="literal">CAIRO_MIME_TYPE_CCITT_FAX_PARAMS</code></a>,
+<a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-EPS:CAPS" title="CAIRO_MIME_TYPE_EPS"><code class="literal">CAIRO_MIME_TYPE_EPS</code></a>, <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-EPS-PARAMS:CAPS" title="CAIRO_MIME_TYPE_EPS_PARAMS"><code class="literal">CAIRO_MIME_TYPE_EPS_PARAMS</code></a>.</p>
+<p>Source surfaces used by the PostScript surface that have a
+<a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-UNIQUE-ID:CAPS" title="CAIRO_MIME_TYPE_UNIQUE_ID"><code class="literal">CAIRO_MIME_TYPE_UNIQUE_ID</code></a> mime type will be stored in PostScript
+printer memory for the duration of the print
+job. <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-UNIQUE-ID:CAPS" title="CAIRO_MIME_TYPE_UNIQUE_ID"><code class="literal">CAIRO_MIME_TYPE_UNIQUE_ID</code></a> should only be used for small
+frequently used sources.</p>
+<p>The <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-CCITT-FAX:CAPS" title="CAIRO_MIME_TYPE_CCITT_FAX"><code class="literal">CAIRO_MIME_TYPE_CCITT_FAX</code></a> and <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-CCITT-FAX-PARAMS:CAPS" title="CAIRO_MIME_TYPE_CCITT_FAX_PARAMS"><code class="literal">CAIRO_MIME_TYPE_CCITT_FAX_PARAMS</code></a> mime types
+are documented in <a class="link" href="cairo-PDF-Surfaces.html#ccitt" title="CCITT Fax Images">CCITT Fax Images</a>.</p>
+<div class="refsect2">
+<a name="eps"></a><h3>Embedding EPS files</h3>
+<p>Encapsulated PostScript files can be embedded in the PS output by
+setting the CAIRO_MIME_TYPE_EPS mime data on a surface to the EPS
+data and painting the surface.  The EPS will be scaled and
+translated to the extents of the surface the EPS data is attached
+to.</p>
+<p>The <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-EPS:CAPS" title="CAIRO_MIME_TYPE_EPS"><code class="literal">CAIRO_MIME_TYPE_EPS</code></a> mime type requires the
+<a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-EPS-PARAMS:CAPS" title="CAIRO_MIME_TYPE_EPS_PARAMS"><code class="literal">CAIRO_MIME_TYPE_EPS_PARAMS</code></a> mime data to also be provided in order
+to specify the embeddding parameters.  <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-EPS-PARAMS:CAPS" title="CAIRO_MIME_TYPE_EPS_PARAMS"><code class="literal">CAIRO_MIME_TYPE_EPS_PARAMS</code></a>
+mime data must contain a string of the form "bbox=[llx lly urx
+ury]" that specifies the bounding box (in PS coordinates) of the
+EPS graphics. The parameters are: lower left x, lower left y, upper
+right x, upper right y. Normally the bbox data is identical to the
+%%<code class="literal">BoundingBox</code> data in the EPS file.</p>
+</div>
 </div>
 <div class="refsect1">
 <a name="cairo-PostScript-Surfaces.functions_details"></a><h2>Functions</h2>
@@ -179,7 +207,7 @@ vary. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-ps-surface-
 <tbody>
 <tr>
 <td class="parameter_name"><p>filename</p></td>
-<td class="parameter_description"><p>a filename for the PS output (must be writable), <code class="literal">NULL</code> may be
+<td class="parameter_description"><p>a filename for the PS output (must be writable), <a href="/usr/share/gtk-doc/html/glibglib-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.</p></td>
@@ -236,7 +264,7 @@ output can vary. See <a class="link" href="cairo-PostScript-Surfaces.html#cairo-
 <tbody>
 <tr>
 <td class="parameter_name"><p>write_func</p></td>
-<td class="parameter_description"><p>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 <code class="literal">NULL</code>
+<td class="parameter_description"><p>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="/usr/share/gtk-doc/html/glibglib-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>
 ,
@@ -351,7 +379,7 @@ cairo_ps_get_levels (<em class="parameter"><code><a class="link" href="cairo-Pos
 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 <code class="literal">NULL</code> if <em class="parameter"><code>level</code></em>
+will return <a href="/usr/share/gtk-doc/html/glibglib-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="refsect3">
@@ -382,7 +410,7 @@ for a way to get the list of valid level ids.</p>
 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 <code class="literal">TRUE</code>, the PostScript surface will output Encapsulated
+ is <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the PostScript surface will output Encapsulated
 PostScript.</p>
 <p>This function should only be called before any drawing operations
 have been performed on the current page. The simplest way to do
@@ -405,7 +433,7 @@ than one page.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>eps</p></td>
-<td class="parameter_description"><p><code class="literal">TRUE</code> to output EPS format PostScript</p></td>
+<td class="parameter_description"><p><a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to output EPS format PostScript</p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 </tbody>
@@ -436,7 +464,7 @@ cairo_ps_surface_get_eps (<em class="parameter"><code><a class="link" href="cair
 </div>
 <div class="refsect3">
 <a name="cairo-ps-surface-get-eps.returns"></a><h4>Returns</h4>
-<p> <code class="literal">TRUE</code> if the surface will output Encapsulated PostScript.</p>
+<p> <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the surface will output Encapsulated PostScript.</p>
 </div>
 <p class="since">Since: 1.6</p>
 </div>

data/vendor/local/share/gtk-doc/html/cairo/cairo-Recording-Surfaces.html

@@ -140,7 +140,7 @@ accurate replay.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>extents</p></td>
-<td class="parameter_description"><p>the extents to record in pixels, can be <code class="literal">NULL</code> to record
+<td class="parameter_description"><p>the extents to record in pixels, can be <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to record
 unbounded operations.</p></td>
 <td class="parameter_annotations"> </td>
 </tr>
@@ -237,8 +237,8 @@ cairo_recording_surface_get_extents (<em class="parameter"><code><a class="link"
 </div>
 <div class="refsect3">
 <a name="cairo-recording-surface-get-extents.returns"></a><h4>Returns</h4>
-<p> <code class="literal">TRUE</code> if the surface is bounded, of recording type, and
-not in an error state, otherwise <code class="literal">FALSE</code></p>
+<p> <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the surface is bounded, of recording type, and
+not in an error state, otherwise <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
 </div>
 <p class="since">Since: 1.12</p>
 </div>

data/vendor/local/share/gtk-doc/html/cairo/cairo-Regions.html

@@ -581,8 +581,8 @@ cairo_region_is_empty (<em class="parameter"><code>const <a class="link" href="c
 </div>
 <div class="refsect3">
 <a name="cairo-region-is-empty.returns"></a><h4>Returns</h4>
-<p> <code class="literal">TRUE</code> if <em class="parameter"><code>region</code></em>
-is empty, <code class="literal">FALSE</code> if it isn't.</p>
+<p> <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>region</code></em>
+is empty, <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it isn't.</p>
 </div>
 <p class="since">Since: 1.10</p>
 </div>
@@ -626,10 +626,10 @@ cairo_region_contains_point (<em class="parameter"><code>const <a class="link" h
 </div>
 <div class="refsect3">
 <a name="cairo-region-contains-point.returns"></a><h4>Returns</h4>
-<p> <code class="literal">TRUE</code> if (<em class="parameter"><code>x</code></em>
+<p> <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if (<em class="parameter"><code>x</code></em>
 , <em class="parameter"><code>y</code></em>
 ) is contained in <em class="parameter"><code>region</code></em>
-, <code class="literal">FALSE</code> if it is not.</p>
+, <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it is not.</p>
 </div>
 <p class="since">Since: 1.10</p>
 </div>
@@ -685,8 +685,8 @@ is partially inside and partially outside <em class="parameter"><code>region</co
 <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_region_equal (<em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *a</code></em>,
                     <em class="parameter"><code>const <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> *b</code></em>);</pre>
-<p>Compares whether region_a is equivalent to region_b. <code class="literal">NULL</code> as an argument
-is equal to itself, but not to any non-<code class="literal">NULL</code> region.</p>
+<p>Compares whether region_a is equivalent to region_b. <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> as an argument
+is equal to itself, but not to any non-<a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> region.</p>
 <div class="refsect3">
 <a name="cairo-region-equal.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -698,12 +698,12 @@ is equal to itself, but not to any non-<code class="literal">NULL</code> region.
 <tbody>
 <tr>
 <td class="parameter_name"><p>a</p></td>
-<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> or <code class="literal">NULL</code></p></td>
+<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> or <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 <tr>
 <td class="parameter_name"><p>b</p></td>
-<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> or <code class="literal">NULL</code></p></td>
+<td class="parameter_description"><p>a <a class="link" href="cairo-Regions.html#cairo-region-t" title="cairo_region_t"><span class="type">cairo_region_t</span></a> or <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 </tbody>
@@ -711,8 +711,8 @@ is equal to itself, but not to any non-<code class="literal">NULL</code> region.
 </div>
 <div class="refsect3">
 <a name="cairo-region-equal.returns"></a><h4>Returns</h4>
-<p> <code class="literal">TRUE</code> if both regions contained the same coverage,
-<code class="literal">FALSE</code> if it is not or any region is in an error status.</p>
+<p> <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both regions contained the same coverage,
+<a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it is not or any region is in an error status.</p>
 </div>
 <p class="since">Since: 1.10</p>
 </div>

data/vendor/local/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html

@@ -129,6 +129,8 @@ correctness of URI is left to the client code.</p>
 <p>If <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-URI:CAPS" title="CAIRO_MIME_TYPE_URI"><code class="literal">CAIRO_MIME_TYPE_URI</code></a> is not present, but <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-JPEG:CAPS" title="CAIRO_MIME_TYPE_JPEG"><code class="literal">CAIRO_MIME_TYPE_JPEG</code></a>
 or <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-PNG:CAPS" title="CAIRO_MIME_TYPE_PNG"><code class="literal">CAIRO_MIME_TYPE_PNG</code></a> is specified, the corresponding data is
 Base64-encoded and emitted.</p>
+<p>If <a class="link" href="cairo-cairo-surface-t.html#CAIRO-MIME-TYPE-UNIQUE-ID:CAPS" title="CAIRO_MIME_TYPE_UNIQUE_ID"><code class="literal">CAIRO_MIME_TYPE_UNIQUE_ID</code></a> is present, all surfaces with the same
+unique identifier will only be embedded once.</p>
 <div class="refsect3">
 <a name="cairo-svg-surface-create.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -140,7 +142,7 @@ Base64-encoded and emitted.</p>
 <tbody>
 <tr>
 <td class="parameter_name"><p>filename</p></td>
-<td class="parameter_description"><p>a filename for the SVG output (must be writable), <code class="literal">NULL</code> may be
+<td class="parameter_description"><p>a filename for the SVG output (must be writable), <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> may be
 used to specify no output. This will generate a SVG surface that
 may be queried and used as a source, without generating a
 temporary file.</p></td>
@@ -193,7 +195,7 @@ incrementally to the stream represented by <em class="parameter"><code>write_fun
 <tbody>
 <tr>
 <td class="parameter_name"><p>write_func</p></td>
-<td class="parameter_description"><p>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 <code class="literal">NULL</code>
+<td class="parameter_description"><p>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="/usr/share/gtk-doc/html/glibglib-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>
 ,
@@ -307,7 +309,7 @@ cairo_svg_get_versions (<em class="parameter"><code><a class="link" href="cairo-
 cairo_svg_version_to_string (<em class="parameter"><code><a class="link" href="cairo-SVG-Surfaces.html#cairo-svg-version-t" title="enum cairo_svg_version_t"><span class="type">cairo_svg_version_t</span></a> version</code></em>);</pre>
 <p>Get the string representation of the given <em class="parameter"><code>version</code></em>
  id. This function
-will return <code class="literal">NULL</code> if <em class="parameter"><code>version</code></em>
+will return <a href="/usr/share/gtk-doc/html/glibglib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>version</code></em>
  isn't valid. See <a class="link" href="cairo-SVG-Surfaces.html#cairo-svg-get-versions" title="cairo_svg_get_versions ()"><code class="function">cairo_svg_get_versions()</code></a>
 for a way to get the list of valid version ids.</p>
 <div class="refsect3">
@@ -345,8 +347,35 @@ This macro can be used to conditionally compile backend-specific code.</p>
 <hr>
 <div class="refsect2">
 <a name="cairo-svg-version-t"></a><h3>enum cairo_svg_version_t</h3>
-<p><a class="link" href="cairo-SVG-Surfaces.html#cairo-svg-version-t" title="enum cairo_svg_version_t"><span class="type">cairo_svg_version_t</span></a> is used to describe the version number of the SVG
-specification that a generated SVG file will conform to.</p>
+<p><em class="parameter"><code>CAIRO_SVG_UNIT_USER</code></em>
+: User unit, a value in the current coordinate system.
+  If used in the root element for the initial coordinate systems it
+  corresponds to pixels. (Since 1.16)
+<em class="parameter"><code>CAIRO_SVG_UNIT_EM</code></em>
+: The size of the element's font. (Since 1.16)
+<em class="parameter"><code>CAIRO_SVG_UNIT_EX</code></em>
+: The x-height of the element’s font. (Since 1.16)
+<em class="parameter"><code>CAIRO_SVG_UNIT_PX</code></em>
+: Pixels (1px = 1/96th of 1in). (Since 1.16)
+<em class="parameter"><code>CAIRO_SVG_UNIT_IN</code></em>
+: Inches (1in = 2.54cm = 96px). (Since 1.16)
+<em class="parameter"><code>CAIRO_SVG_UNIT_CM</code></em>
+: Centimeters (1cm = 96px/2.54). (Since 1.16)
+<em class="parameter"><code>CAIRO_SVG_UNIT_MM</code></em>
+: Millimeters (1mm = 1/10th of 1cm). (Since 1.16)
+<em class="parameter"><code>CAIRO_SVG_UNIT_PT</code></em>
+: Points (1pt = 1/72th of 1in). (Since 1.16)
+<em class="parameter"><code>CAIRO_SVG_UNIT_PC</code></em>
+: Picas (1pc = 1/6th of 1in). (Since 1.16)
+<em class="parameter"><code>CAIRO_SVG_UNIT_PERCENT</code></em>
+: Percent, a value that is some fraction of another
+  reference value. (Since 1.16)</p>
+<p><span class="type">cairo_svg_unit_t</span> is used to describe the units valid for coordinates and
+lengths in the SVG specification.</p>
+<p>See also:
+https://www.w3.org/TR/SVG/coords.html<span class="type">Units</span>
+https://www.w3.org/TR/SVG/types.html<span class="type">DataTypeLength</span>
+https://www.w3.org/TR/css-values-3/<span class="type">lengths</span></p>
 <div class="refsect3">
 <a name="cairo-svg-version-t.members"></a><h4>Members</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -358,22 +387,18 @@ specification that a generated SVG file will conform to.</p>
 <tbody>
 <tr>
 <td class="enum_member_name"><p><a name="CAIRO-SVG-VERSION-1-1:CAPS"></a>CAIRO_SVG_VERSION_1_1</p></td>
-<td class="enum_member_description">
-<p>The version 1.1 of the SVG specification. (Since 1.2)</p>
-</td>
+<td class="enum_member_description"> </td>
 <td class="enum_member_annotations"> </td>
 </tr>
 <tr>
 <td class="enum_member_name"><p><a name="CAIRO-SVG-VERSION-1-2:CAPS"></a>CAIRO_SVG_VERSION_1_2</p></td>
-<td class="enum_member_description">
-<p>The version 1.2 of the SVG specification. (Since 1.2)</p>
-</td>
+<td class="enum_member_description"> </td>
 <td class="enum_member_annotations"> </td>
 </tr>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since: 1.2</p>
+<p class="since">Since: 1.16</p>
 </div>
 </div>
 <div class="refsect1">