source: xsoft/other/fontforge.xml@ 8471938

<?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 fontforge-download-http "&sources-anduin-other-http;/fontforge-&fontforge-version;.tar.xz">-->
  <!ENTITY fontforge-download-http "https://github.com/fontforge/fontforge/releases/download/&fontforge-version;/fontforge-&fontforge-version;.tar.gz">
  <!ENTITY fontforge-download-ftp  " ">
  <!ENTITY fontforge-md5sum        "210839cf621de2b19929e57964509260">
  <!ENTITY fontforge-size          "118 MB">
  <!ENTITY fontforge-buildsize     "395 MB">
  <!ENTITY fontforge-time          "2.1 SBU (additional 0.3 SBU for the tests)">
]>

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

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

  <title>FontForge-&fontforge-version;</title>

  <indexterm zone="fontforge">
    <primary sortas="a-FontForge">FontForge</primary>
  </indexterm>

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

    <para>
      The <application>FontForge</application> package contains an
      outline font editor that lets you create your own postscript,
      truetype, opentype, cid-keyed, multi-master, cff, svg and
      bitmap (bdf, FON, NFNT) fonts, or edit existing ones.
    </para>

    &lfs77_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>

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

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

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="freetype2"/>,
      <xref linkend="git"/>,
      <xref linkend="glib2"/>,  and
      <xref linkend="libxml2"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="cairo"/>,
      <xref linkend="gtk2"/>,
      <xref linkend="harfbuzz"/>,
      <xref linkend="pango"/> (required if Xorg libraries are present), and
      <xref linkend="xorg7-lib"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="giflib"/>,
      <xref linkend="libjpeg"/>,
      <xref linkend="libpng"/>,
      <xref linkend="libtiff"/>,
      <xref linkend="python2"/>,
      <ulink url="https://github.com/fontforge/libspiro">libspiro</ulink>,
      <ulink url="https://bitbucket.org/sortsmill/libunicodenames">
      libunicodenames</ulink>,
      <ulink url="https://github.com/fontforge/libuninameslist">
      libuninameslist</ulink>, and
      <ulink url="http://www.zeromq.org/">libzmq</ulink>,
    </para>

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

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

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

<screen><userinput>rm -rf libltdl &amp;&amp;
rm m4/argz.m4  &amp;&amp;
./bootstrap    &amp;&amp;
./configure --prefix=/usr     \
            --enable-gtk2-use \
            --disable-static  \
            --docdir=/usr/share/doc/fontforge-&fontforge-version; &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>
      <command>rm -rf libltdl ... ./bootstrap</command>:
      These commands work around the old version of libtool in the source,
      and the idiosyncracies of the bootstrap command, to allow it to build with
      current libtool where some files have been renamed.
    </para>

    <para>
      <parameter>--enable-gtk2-use</parameter>: allows to use the GTK+2 graphics
      instead of basic Xorg graphics.
    </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 Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>
          fontforge, fontimage, fontlint and sfddiff
        </seg>
        <seg>
          libfontforgeexe.so, libfontforge.so, libgdraw.so,
          libgioftp.so, libgunicode.so, libgutils.so, and
          /usr/lib/python&python2-majorver;/site-packages/{fontforge,psMat}.so
        </seg>
        <seg>
          /usr/include/fontforge,
          /usr/share/doc/fontforge-&fontforge-version; and
          /usr/share/fontforge
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="fontforge-prog">
        <term><command>fontforge</command></term>
        <listitem>
          <para>
            is a program that allows you to create and
            modify font files.
          </para>
          <indexterm zone="fontforge fontforge-prog">
            <primary sortas="b-fontforge">fontforge</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="fontimage">
        <term><command>fontimage</command></term>
        <listitem>
          <para>
            is a program that produces an image showing
            representative glyphs of the font.
          </para>
          <indexterm zone="fontforge fontimage">
            <primary sortas="b-fontimage">fontimage</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="fontlint">
        <term><command>fontlint</command></term>
        <listitem>
          <para>
            is a program that checks the font for certain
            common errors.
          </para>
          <indexterm zone="fontforge fontlint">
            <primary sortas="b-fontlint">fontlint</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="sfddiff">
        <term><command>sfddiff</command></term>
        <listitem>
          <para>
            is a program that compares two font files.
          </para>
          <indexterm zone="fontforge sfddiff">
            <primary sortas="b-sfddiff">sfddiff</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>