source: general/graphlib/freetype2.xml@ 678c25bd

<?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 freetype2-download-http "&sourceforge-repo;/freetype/freetype-&freetype2-version;.tar.bz2">
  <!ENTITY freetype2-download-ftp  "&gentoo-ftp-repo;/freetype-&freetype2-version;.tar.bz2">
  <!ENTITY freetype2-md5sum        "0037b25a8c090bc8a1218e867b32beb1">
  <!ENTITY freetype2-size          "1.7 MB">
  <!ENTITY freetype2-buildsize     "43 MB (with additional documentation)">
  <!ENTITY freetype2-time          "0.2 SBU (with additional documentation)">

  <!ENTITY freetype2-doc-version   "&freetype2-version;">
  <!ENTITY freetype2-doc-download-http "&sourceforge-repo;/freetype/freetype-doc-&freetype2-doc-version;.tar.bz2">
  <!ENTITY freetype2-doc-download-ftp  "&gentoo-ftp-repo;/freetype-doc-&freetype2-doc-version;.tar.bz2">
  <!ENTITY freetype2-doc-md5sum        "ec2629b81f80decdae04a4b528097b81">
  <!ENTITY freetype2-doc-size          "5.2 KB">
]>

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

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

  <title>FreeType-&freetype2-version;</title>

  <indexterm zone="freetype2">
    <primary sortas="a-FreeType">FreeType</primary>
  </indexterm>

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

    <para>
      The <application>FreeType2</application> package contains
      a library which allows applications to properly render
      <application>TrueType</application> fonts.
    </para>

    &lfs79_checked;

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

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <title>Additional Documentation</title>
      <listitem>
        <para>
          Download (HTTP): <ulink url="&freetype2-doc-download-http;"/>
        </para>
      </listitem>
<!--      <listitem>
        <para>
          Download (FTP): <ulink url="&freetype2-doc-download-ftp;"/>
        </para>
      </listitem> -->
      <listitem>
        <para>
          Download MD5 sum: &freetype2-doc-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &freetype2-doc-size;
        </para>
      </listitem>
    </itemizedlist>

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

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="harfbuzz"/>
      (first, install without it, after it is installed, reinstall
      <xref linkend="freetype2"/>),
      <xref linkend="libpng"/>, and
      <xref linkend="which"/>
    </para>

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

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

    <para>
      If you downloaded the additional documentation, unpack it into the
      source tree using the following command:
    </para>

<screen><userinput>tar -xf ../freetype-doc-&freetype2-doc-version;.tar.bz2 --strip-components=2 -C docs</userinput></screen>

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

<screen><userinput>sed -e "/AUX.*.gxvalid/s@^# @@" \
    -e "/AUX.*.otvalid/s@^# @@" \
    -i modules.cfg              &amp;&amp;

sed -r -e 's:.*(#.*SUBPIXEL.*) .*:\1:' \
    -i include/freetype/config/ftoption.h  &amp;&amp;

./configure --prefix=/usr --disable-static &amp;&amp;
make</userinput></screen>

    <para>
      This package does not come with a test suite.
    </para>

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

<screen role="root"><userinput>make install &amp;&amp;
install -v -m755 -d /usr/share/doc/freetype-&freetype2-version; &amp;&amp;
cp -v -R docs/*     /usr/share/doc/freetype-&freetype2-version;</userinput></screen>

  </sect2>

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

    <para>
      <command>sed -e ...</command>: The first command enables GX/AAT and OpenType
      table validation and the second command enables Subpixel Rendering and
      Subpixel Hinting in order to improve font rendering. Note that Subpixel
      Rendering may have patent issues.  Be sure to read the <literal>'Other
      patent issues'</literal> part of
      <ulink url="http://www.freetype.org/patents.html"/>
      before enabling this option.
    </para>

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

  </sect2>

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

    <segmentedlist>
      <segtitle>Installed Program</segtitle>
      <segtitle>Installed Library</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>
          freetype-config
        </seg>
        <seg>
          libfreetype.so
        </seg>
        <seg>
          /usr/include/freetype2 and
          /usr/share/doc/freetype-&freetype2-version;
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="freetype-config">
        <term><command>freetype-config</command></term>
        <listitem>
          <para>
            is used to get <application>FreeType</application> compilation
            and linking information.
          </para>
          <indexterm zone="freetype2 freetype-config">
            <primary sortas="b-freetype-config">freetype-config</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libfreetype">
        <term><filename class="libraryfile">libfreetype.so</filename></term>
        <listitem>
          <para>
            contains functions for rendering various font types, such
            as TrueType and Type1.
          </para>
          <indexterm zone="freetype2 libfreetype">
            <primary sortas="c-libfreetype">libfreetype.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>