source: general/graphlib/harfbuzz.xml@ c0e7734

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY harfbuzz-download-http
           "http://www.freedesktop.org/software/harfbuzz/release/harfbuzz-&harfbuzz-version;.tar.bz2">
  <!ENTITY harfbuzz-download-ftp  " ">
  <!ENTITY harfbuzz-md5sum        "531ee8650626ecddcd90b2a4637e31d4">
  <!ENTITY harfbuzz-size          "1.2 MB">
  <!ENTITY harfbuzz-buildsize     "25 MB (additional 2 MB for the API  documentation and additional 2 MB for the tests)">
  <!ENTITY harfbuzz-time          "0.3 SBU">
]>

<sect1 id="harfbuzz" xreflabel="Harfbuzz-&harfbuzz-version;">
  <?dbhtml filename="harfbuzz.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>Harfbuzz-&harfbuzz-version;</title>

  <indexterm zone="harfbuzz">
    <primary sortas="a-Harfbuzz">Harfbuzz</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Harfbuzz</title>

    <para>
      The <application>Harfbuzz</application> package contains an OpenType text
      shaping engine.
    </para>

    &lfs75_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&harfbuzz-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&harfbuzz-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &harfbuzz-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &harfbuzz-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &harfbuzz-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &harfbuzz-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Harfbuzz Dependencies</bridgehead>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="glib2"/>,
      <xref linkend="icu"/> and
      <xref linkend="freetype2"/>
      (after <xref linkend="harfbuzz"/> is installed, reinstall
      <xref linkend="freetype2"/>)
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="cairo"/>,
      <xref linkend="gobject-introspection"/>,
      <xref linkend="gtk-doc"/>, and
      <xref linkend="graphite2"/>
    </para>

    <warning>
      <para>
        Recommended dependencies are not strictly required to build
        the package. However, you might not get expected results at
        runtime if you don't install them. Please do not report bugs
        with this package if you <emphasis>have not</emphasis>
        installed the recommended dependencies.
      </para>
    </warning>

    <para condition="html" role="usernotes">
      User Notes: <ulink url="&blfs-wiki;/harfbuzz"/>
    </para>
  </sect2>

  <sect2 role="installation">
    <title>Installation of Harfbuzz</title>

    <para>
      If you wish to run the test suite, run the following commands, to
      disable a test that fails:
    </para>

<screen><userinput>sed -i '/arabic-fallback-shaping.tests/d' test/shaping/Makefile.am &amp;&amp;
autoreconf -f -i</userinput></screen>

    <para>
      Install <application>Harfbuzz</application> by running the following
      commands:
    </para>

<screen><userinput>./configure --prefix=/usr --with-gobject &amp;&amp;
make</userinput></screen>

    <para>
      To test the results, issue: <command>make check</command>.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>make install</userinput></screen>
  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <parameter>--with-gobject</parameter>: This switch enables building
      of the <application>Harfbuzz</application> GObject wrapper. Remove
      it if you did not install <application>GLib</application>.
    </para>

    <para>
      <option>--with-graphite2</option>: This switch enables
      <application>Graphite2</application> support.
    </para>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
      href="../../xincludes/gtk-doc-rebuild.xml"/>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>
          hb-ot-shape-closure, hb-shape, and hb-view
        </seg>
        <seg>
          libharfbuzz.so, libharfbuzz-gobject.so and libharfbuzz-icu.so
        </seg>
        <seg>
          /usr/include/harfbuzz and
          /usr/share/gtk-doc/html/harfbuzz
        </seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <!-- <varlistentry id="hb-ot-shape-closure">
        <term><command>hb-ot-shape-closure</command></term>
        <listitem>
          <para>
            does this .....
          </para>
          <indexterm zone="harfbuzz hb-ot-shape-closure">
            <primary sortas="b-hb-ot-shape-closure">hb-ot-shape-closure</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="hb-shape">
        <term><command>hb-shape</command></term>
        <listitem>
          <para>
            does this .....
          </para>
          <indexterm zone="harfbuzz hb-shape">
            <primary sortas="b-hb-shape">hb-shape</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    <varlistentry id="hb-view">
        <term><command>hb-view</command></term>
        <listitem>
          <para>
            does this .....
          </para>
          <indexterm zone="harfbuzz hb-view">
            <primary sortas="b-hb-view">hb-view</primary>
          </indexterm>
        </listitem>
      </varlistentry> -->

      <varlistentry id="libharfbuzz">
        <term><filename class="libraryfile">libharfbuzz.so</filename></term>
        <listitem>
          <para>
            contains functions for complex text shaping.
          </para>
          <indexterm zone="harfbuzz libharfbuzz">
            <primary sortas="c-libharfbuzz">libharfbuzz.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>