[librsvg] Move back to DocBook 4.3

From: Federico Mena Quintero <federico src gnome org>
To: commits-list gnome org
Cc:
Subject: [librsvg] Move back to DocBook 4.3
Date: Sat, 3 Aug 2019 01:03:32 +0000 (UTC)
commit 4acc3ad31c93c1ec64055b2392259c9f2fb068d3
Author: Federico Mena Quintero <federico gnome org>
Date:   Fri Aug 2 17:08:00 2019 -0500

    Move back to DocBook 4.3
    
    Apparently some tools are not entirely happy about DocBook 5 yet.

 doc/rsvg-docs.xml     | 28 ++++++++++++++--------------
 librsvg/rsvg-handle.c | 20 ++++++++++----------
 librsvg/rsvg.h        | 23 +++++++++++------------
 3 files changed, 35 insertions(+), 36 deletions(-)
---
diff --git a/doc/rsvg-docs.xml b/doc/rsvg-docs.xml
index 3d0046f5..bff4007f 100644
--- a/doc/rsvg-docs.xml
+++ b/doc/rsvg-docs.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML 5.0//EN"
-               "http://www.oasis-open.org/docbook/xml/5.0";
-[
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"; [
+  <!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
   <!ENTITY version SYSTEM "version.xml">
 ]>
-<book xmlns:xi="http://www.w3.org/2001/XInclude";>
+<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude";>
   <!--
     Copyright © 2009, 2010 Christian Persch
     Copyright © 2017 Federico Mena Quintero
@@ -16,13 +16,13 @@
 
     A copy of the license is included in the COPYING file.
     -->
-  <info>
+  <bookinfo>
     <title>Librsvg Reference Manual</title>
     <releaseinfo>
       For librsvg version &version;
 
       The latest version of this documentation can be found on-line at the
-      <link href="http://library.gnome.org/devel/rsvg/index.html"; role="online-location">GNOME 
Library</link>.
+      <ulink url="http://library.gnome.org/devel/rsvg/index.html"; role="online-location">GNOME 
Library</ulink>.
     </releaseinfo>
 
     <copyright>
@@ -55,7 +55,7 @@
 
         You may obtain a copy of the <citetitle>GNU General Public Licence</citetitle>
         from the Free Software Foundation at
-        <link href="http://www.gnu.org/licences/";>GNU Licences web site</link>
+        <ulink url="http://www.gnu.org/licences/";>GNU Licences web site</ulink>
         or by writing to:
 
         <address>
@@ -66,25 +66,25 @@
         </address>
       </para>
     </legalnotice>
-  </info>
+  </bookinfo>
 
   <part id="rsvg">
     <title>API Reference</title>
     <partintro>
       <para>
         Librsvg is a library for rendering Scalable Vector Graphics 1.1
-        files (<link href="https://www.w3.org/TR/SVG/";>SVG 1.1</link>).
+        files (<ulink url="https://www.w3.org/TR/SVG/";>SVG 1.1</ulink>).
         Specifically, it can take non-animated, non-scripted SVG data
-        and render it into a <link href="https://www.cairographics.org/";>Cairo</link>
+        and render it into a <ulink url="https://www.cairographics.org/";>Cairo</ulink>
         surface.  Normally this means an in-memory raster surface, but
         it could also be any of the other surface types that Cairo
         supports.
       </para>
 
       <para>
-       Librsvg supports many of the graphic features in the <link
-       href="https://www.w3.org/TR/SVG/";>SVG 1.1
-       specification</link>.  The main features of SVG 1.1 that
+       Librsvg supports many of the graphic features in the <ulink
+       url="https://www.w3.org/TR/SVG/";>SVG 1.1
+       specification</ulink>.  The main features of SVG 1.1 that
        librsvg does not support are the following:
       </para>
 
@@ -192,7 +192,7 @@
     <para>
       You may obtain a copy of the <citetitle>GNU General Public Licence</citetitle>
       from the Free Software Foundation at
-      <link href="http://www.gnu.org/licences/";>GNU Licences web site</link>
+      <ulink url="http://www.gnu.org/licences/";>GNU Licences web site</ulink>
       or by writing to:
 
       <address>
diff --git a/librsvg/rsvg-handle.c b/librsvg/rsvg-handle.c
index 19b2fe71..a20aebda 100644
--- a/librsvg/rsvg-handle.c
+++ b/librsvg/rsvg-handle.c
@@ -35,10 +35,10 @@
  * Librsvg does not do animation nor scripting, and can load
  * references to external data only in some situations; see below.
  *
- * Librsvg supports reading <link
- * href="https://www.w3.org/TR/SVG11/";>SVG 1.1</link> data, and is
- * gradually adding support for features in <link
- * href="https://www.w3.org/TR/SVG2/";>SVG 2</link>.  Librsvg also supports
+ * Librsvg supports reading <ulink
+ * url="https://www.w3.org/TR/SVG11/";>SVG 1.1</ulink> data, and is
+ * gradually adding support for features in <ulink
+ * url="https://www.w3.org/TR/SVG2/";>SVG 2</ulink>.  Librsvg also supports
  * SVGZ files, which are just an SVG stream compressed with the GZIP algorithm.
  *
  * # The "base file" and resolving references to external files
@@ -1217,7 +1217,7 @@ rsvg_handle_set_size_callback (RsvgHandle *handle,
  * ]|
  *
  * API ordering: This function must be called on a fully-loaded @handle.  See
- * the section <link href="#API-ordering">API ordering</link> for details.
+ * the section <ulink url="#API-ordering">API ordering</ulink> for details.
  *
  * Panics: this function will panic if the @handle is not fully-loaded.
  *
@@ -1259,7 +1259,7 @@ rsvg_handle_get_intrinsic_dimensions (RsvgHandle *handle,
  * render anything, and instead will return an error.
  *
  * API ordering: This function must be called on a fully-loaded @handle.  See
- * the section <link href="#API-ordering">API ordering</link> for details.
+ * the section <ulink url="#API-ordering">API ordering</ulink> for details.
  *
  * Panics: this function will panic if the @handle is not fully-loaded.
  *
@@ -1315,7 +1315,7 @@ rsvg_handle_render_document (RsvgHandle           *handle,
  * the child elements.
  *
  * API ordering: This function must be called on a fully-loaded @handle.  See
- * the section <link href="#API-ordering">API ordering</link> for details.
+ * the section <ulink url="#API-ordering">API ordering</ulink> for details.
  *
  * Panics: this function will panic if the @handle is not fully-loaded.
  *
@@ -1369,7 +1369,7 @@ rsvg_handle_get_geometry_for_layer (RsvgHandle     *handle,
  * root element.
  *
  * API ordering: This function must be called on a fully-loaded @handle.  See
- * the section <link href="#API-ordering">API ordering</link> for details.
+ * the section <ulink url="#API-ordering">API ordering</ulink> for details.
  *
  * Panics: this function will panic if the @handle is not fully-loaded.
  *
@@ -1431,7 +1431,7 @@ rsvg_handle_render_layer (RsvgHandle           *handle,
  * the child elements.
  *
  * API ordering: This function must be called on a fully-loaded @handle.  See
- * the section <link href="#API-ordering">API ordering</link> for details.
+ * the section <ulink url="#API-ordering">API ordering</ulink> for details.
  *
  * Panics: this function will panic if the @handle is not fully-loaded.
  *
@@ -1483,7 +1483,7 @@ rsvg_handle_get_geometry_for_element (RsvgHandle     *handle,
  * be rendered.  FIXME: mention proportional scaling.
  *
  * API ordering: This function must be called on a fully-loaded @handle.  See
- * the section <link href="#API-ordering">API ordering</link> for details.
+ * the section <ulink url="#API-ordering">API ordering</ulink> for details.
  *
  * Panics: this function will panic if the @handle is not fully-loaded.
  *
diff --git a/librsvg/rsvg.h b/librsvg/rsvg.h
index 617dbd97..70a4cca3 100644
--- a/librsvg/rsvg.h
+++ b/librsvg/rsvg.h
@@ -102,7 +102,6 @@ struct _RsvgHandleClass {
 
 /**
  * RsvgHandle:
- * @parent: parent instance
  *
  * Lets you load SVG data and render it.
  */
@@ -231,9 +230,9 @@ gboolean rsvg_handle_has_sub (RsvgHandle *handle, const char *id);
  * @RSVG_UNIT_PT: points, or 1/72 inch
  * @RSVG_UNIT_PC: picas, or 1/6 inch (12 points)
  *
- * Units for the #RsvgLength struct.  These have the same meaning as <link
- * href="https://www.w3.org/TR/CSS21/syndata.html#length-units";>CSS length
- * units</link>.
+ * Units for the #RsvgLength struct.  These have the same meaning as <ulink
+ * url="https://www.w3.org/TR/CSS21/syndata.html#length-units";>CSS length
+ * units</ulink>.
  */
 typedef enum {
     RSVG_UNIT_PERCENT,
@@ -257,8 +256,8 @@ typedef enum {
  * <literal>height</literal> attributes of an <literal>&lt;svg&gt;</literal>
  * element.
  *
- * This is equivalent to <link
- * href="https://www.w3.org/TR/CSS21/syndata.html#length-units";>CSS lengths</link>.
+ * This is equivalent to <ulink
+ * url="https://www.w3.org/TR/CSS21/syndata.html#length-units";>CSS lengths</ulink>.
  *
  * It is up to the calling application to convert lengths in non-pixel units
  * (i.e. those where the @unit field is not #RSVG_UNIT_PX) into something
@@ -286,9 +285,9 @@ void rsvg_handle_get_intrinsic_dimensions (RsvgHandle *handle,
  * RsvgHandleFlags:
  * @RSVG_HANDLE_FLAGS_NONE: No flags are set.
  * @RSVG_HANDLE_FLAG_UNLIMITED: Disable safety limits in the XML parser.
- *   Libxml2 has <link
- *   href="https://gitlab.gnome.org/GNOME/libxml2/blob/master/include/libxml/parserInternals.h";>several
- *   limits</link> designed to keep malicious XML content from consuming too
+ *   Libxml2 has <ulink
+ *   url="https://gitlab.gnome.org/GNOME/libxml2/blob/master/include/libxml/parserInternals.h";>several
+ *   limits</ulink> designed to keep malicious XML content from consuming too
  *   much memory while parsing.  For security reasons, this should only be used
  *   for trusted input!
  *   Since: 2.40.3
@@ -298,9 +297,9 @@ void rsvg_handle_get_intrinsic_dimensions (RsvgHandle *handle,
  *  the final output, instead of passing uncompressed images.  This will make a
  *  Keeps the image data when loading images, for use by cairo when painting to
  *  e.g. a PDF surface.  For example, this will make the a resulting PDF file
- *  smaller and faster.  Please see <link
- *  href="https://www.cairographics.org/manual/cairo-cairo-surface-t.html#cairo-surface-set-mime-data";>the
- *  Cairo documentation</link> for details.
+ *  smaller and faster.  Please see <ulink
+ *  url="https://www.cairographics.org/manual/cairo-cairo-surface-t.html#cairo-surface-set-mime-data";>the
+ *  Cairo documentation</ulink> for details.
  *  Since: 2.40.3
  */
 typedef enum /*< flags >*/
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]