From 4dc2265918089ee08c6d82eed0cfd41e02d7d231 Mon Sep 17 00:00:00 2001
From: Khaled Hosny <khaledhosny@eglug.org>
Date: Wed, 23 Dec 2015 00:26:20 +0400
Subject: [PATCH] Intro from freedesktop.org/wiki/Software/HarfBuzz/

---
 docs/HarfBuzz.png      | Bin 0 -> 3419 bytes
 docs/Makefile.am       |   3 ++-
 docs/harfbuzz-docs.xml |  31 ++++++++++++++++++++++++++++++-
 3 files changed, 32 insertions(+), 2 deletions(-)
 create mode 100644 docs/HarfBuzz.png

diff --git a/docs/HarfBuzz.png b/docs/HarfBuzz.png
new file mode 100644
index 0000000000000000000000000000000000000000..d58d9fc5a58424a657f01416b49a697c71eae149
GIT binary patch
literal 3419
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
XOonx=a@qs`IUsXmYa^V2OWc0|0O@>;

literal 0
HcmV?d00001

diff --git a/docs/Makefile.am b/docs/Makefile.am
index f605f24b4..64344b851 100644
--- a/docs/Makefile.am
+++ b/docs/Makefile.am
@@ -65,7 +65,8 @@ EXTRA_HFILES=$(top_builddir)/src/hb-version.h
 
 # Images to copy into HTML directory.
 # e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
-HTML_IMAGES=
+HTML_IMAGES=  \
+	HarfBuzz.png
 
 # Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
 # e.g. content_files=running.sgml building.sgml changes-2.0.sgml
diff --git a/docs/harfbuzz-docs.xml b/docs/harfbuzz-docs.xml
index 60ff8e28d..a7efbf848 100644
--- a/docs/harfbuzz-docs.xml
+++ b/docs/harfbuzz-docs.xml
@@ -8,10 +8,39 @@
   <bookinfo>
     <title>HarfBuzz Manual</title>
     <releaseinfo>
-      for HarfBuzz &version;.
+      This document is for HarfBuzz &version;.
       <!--The latest version of this documentation can be found on-line at
       <ulink role="online-location" url="http://[SERVER]/libharfbuzz/index.html">http://[SERVER]/libharfbuzz/</ulink>.-->
     </releaseinfo>
+    <abstract>
+      <title>HarfBuzz</title>
+      <graphic fileref="HarfBuzz.png" format="PNG" align="center"/>
+      <para>
+        HarfBuzz is an <ulink url="http://www.microsoft.com/typography/otspec/">OpenType</ulink>
+        text shaping engine.
+      </para>
+      <para>
+        The current HarfBuzz codebase, formerly known as harfbuzz-ng, is
+        versioned 1.x.x and is stable and under active maintenance. This is
+        what is used in latest versions of Firefox, GNOME, ChromeOS, Chrome,
+        LibreOffice, XeTeX, Android, and KDE, among other places. The canonical
+        source tree is available
+        <ulink url="http://cgit.freedesktop.org/harfbuzz/">here</ulink>.
+        Also available on
+        <ulink url="https://github.com/behdad/harfbuzz">github</ulink>.
+        See below for release tarballs.
+      </para>
+      <para>
+        The old HarfBuzz codebase, these days known as harfbuzz-old, was
+        derived from <ulink url="http://freetype.org/">FreeType</ulink>,
+        <ulink url="http://pango.org/">Pango</ulink>, and
+        <ulink url="http://qt-project.org/">Qt</ulink> and is available
+        <ulink url="http://cgit.freedesktop.org/harfbuzz.old/">here</ulink>.
+        It is not actively developed or maintained, and is extremely buggy. All
+        users are encouraged to switch over to the new HarfBuzz as soon as
+        possible.  There are no release tarballs of old HarfBuzz whatsoever.
+      </para>
+    </abstract>
   </bookinfo>
 
   <part>