source: xsoft/other/fontforge.xml@ d18e0d7

<?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-date;-Unix-Source.tar.gz">
  <!ENTITY fontforge-download-ftp  " ">
  <!ENTITY fontforge-md5sum        "2193a30700a56aa7c466407ac37ce0e3">
  <!ENTITY fontforge-size          "120 MB">
  <!ENTITY fontforge-buildsize     "355 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>

    <note>

      <para>The download link below obtains
      <filename>fontforge-&fontforge-date;-Unix-Source.tar.gz</filename>. This
      is not the correct name for the archive, because it saves the file as
      <filename class="directory">fontforge-&fontforge-version;</filename>. The
      file should be renamed to the correct filename
      <filename>fontforge-&fontforge-version;.tar.gz</filename>. You can
      achieve this automatically by using the command:</para>
    
 <screen><userinput> wget -c <ulink url="&fontforge-download-http;"/> \
      -O fontforge-&fontforge-version;.tar.gz</userinput></screen>
    </note>

    <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>
<!--
    <para>
      The <application>FontForge</application> tarball specified above was not
      generated by the <application>FontForge</application> maintainers. It
      was created by the BLFS team by pulling a Git version and then generating 
      the autotools components and documentation. The BLFS team made no changes 
      to the existing source files.
    </para>-->

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

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="cairo"/>,
      <xref linkend="freetype2"/>,
      <xref linkend="harfbuzz"/>,
      <xref linkend="gtk2"/>,
      <xref linkend="libxml2"/> 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="pango"/>,
      <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;
./bootstrap --force &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 &amp;&amp; ./bootstrap --force</command>:
    These two 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>

  </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>