[librsvg: 10/23] Move all the introductory material to overview.xml




commit 2f67661c200de951046a8861a94e7c4da0fafac8
Author: Federico Mena Quintero <federico gnome org>
Date:   Thu Jan 6 15:42:01 2022 -0600

    Move all the introductory material to overview.xml
    
    With this, the toplevel rsvg-docs.xml is mostly just inclusions from
    the real content files.
    
    Part-of: <https://gitlab.gnome.org/GNOME/librsvg/-/merge_requests/650>

 doc/overview.xml  | 41 +++++++++++++++++++++++++++++++++++++++++
 doc/rsvg-docs.xml | 42 ------------------------------------------
 2 files changed, 41 insertions(+), 42 deletions(-)
---
diff --git a/doc/overview.xml b/doc/overview.xml
index d0d3eea24..bc656eed6 100644
--- a/doc/overview.xml
+++ b/doc/overview.xml
@@ -2,6 +2,47 @@
 <chapter>
   <title>Overview of Librsvg's API</title>
 
+  <para>
+    Librsvg is a library for rendering Scalable Vector Graphics files (SVG).
+    Specifically, it can take non-animated, non-scripted SVG documents and render them
+    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 <ulink
+    url="https://www.w3.org/TR/SVG/";>SVG 1.1</ulink> and <ulink
+    url="https://www.w3.org/TR/SVG2/";>SVG2</ulink> specifications.  The main features
+    of SVG that librsvg does not support are the following:
+  </para>
+
+  <itemizedlist>
+    <listitem>
+      <para>
+       Scripting or animation - Librsvg reads SVG data and
+       renders it to a static image.  There is no provision to
+       execute scripts that may control animation parameters.
+      </para>
+    </listitem>
+
+    <listitem>
+      <para>
+       Access to the DOM - Librsvg creates an internal
+       representation of the SVG data, but it does not provide
+       outside access to the resulting Document Object Model
+       (DOM).
+      </para>
+    </listitem>
+
+    <listitem>
+      <para>
+       SVG fonts - Instead, librsvg relies on the system's fonts,
+       particularly those that are available through Cairo/Pango.
+      </para>
+    </listitem>
+  </itemizedlist>
+
   <para>
     Librsvg's API is divided into two main parts:  one for loading SVG
     data and one for rendering it.  In the <emphasis>loading
diff --git a/doc/rsvg-docs.xml b/doc/rsvg-docs.xml
index 61d9f3c5a..6dcab93d7 100644
--- a/doc/rsvg-docs.xml
+++ b/doc/rsvg-docs.xml
@@ -43,48 +43,6 @@
 
   <part id="rsvg">
     <title>API Reference</title>
-    <partintro>
-      <para>
-        Librsvg is a library for rendering Scalable Vector Graphics files (SVG).
-        Specifically, it can take non-animated, non-scripted SVG documents and render them
-        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 <ulink
-       url="https://www.w3.org/TR/SVG/";>SVG 1.1</ulink> and <ulink
-       url="https://www.w3.org/TR/SVG2/";>SVG2</ulink> specifications.  The main features
-       of SVG that librsvg does not support are the following:
-      </para>
-
-      <itemizedlist>
-       <listitem>
-         <para>
-           Scripting or animation - Librsvg reads SVG data and
-           renders it to a static image.  There is no provision to
-           execute scripts that may control animation parameters.
-         </para>
-       </listitem>
-
-       <listitem>
-         <para>
-           Access to the DOM - Librsvg creates an internal
-           representation of the SVG data, but it does not provide
-           outside access to the resulting Document Object Model
-           (DOM).
-         </para>
-       </listitem>
-
-       <listitem>
-         <para>
-           SVG fonts - Instead, librsvg relies on the system's fonts,
-           particularly those that are available through Cairo/Pango.
-         </para>
-       </listitem>
-      </itemizedlist>
-    </partintro>
 
     <xi:include href="overview.xml"/>
     <xi:include href="recommendations.xml"/>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]