source: xsoft/office/gnucash.xml@ dcd55b37

<?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 gnucash-download-http "http://www.gnucash.org/pub/gnucash/sources/stable/gnucash-&gnucash-version;.tar.gz">
  <!ENTITY gnucash-download-ftp  "ftp://ftp.at.gnucash.org/pub/gnucash/gnucash/sources/stable/gnucash-&gnucash-version;.tar.gz">
  <!ENTITY gnucash-src-md5sum    "81e7c703db56bb203e106664157779cc">
  <!ENTITY gnucash-size          "8.2 MB">
  <!ENTITY gnucash-buildsize     "123 MB (additional 22 MB for Help documentation)">
  <!ENTITY gnucash-time          "3.2 SBU (additional 0.3 SBU to run the test suite)">
  <!ENTITY gnucash-docs-version  "1.8.5">
  <!ENTITY gnucash-docs-download "http://www.gnucash.org/pub/gnucash/sources/stable/gnucash-docs-&gnucash-docs-version;.tar.gz">
  <!ENTITY gnucash-docs-md5sum   "9758d8e523530c2509912761e327a9d5">
]>

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

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

  <title>GnuCash-&gnucash-version;</title>

  <indexterm zone="gnucash">
    <primary sortas="a-GnuCash">GnuCash</primary>
  </indexterm>

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

    <para><application>GnuCash</application> is a personal finance
    manager. The BLFS team is in the process of updating GnuCash
    to version 2.x. This is a major change. Many of the dependency
    packages for version 2.x are not compatible with the current
    version. Some of these dependency packages have already been updated
    which means these instructions are obsolete. Please see the stable
    BLFS book for instructions to build GnuCash version 1.8.x.</para>

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

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing='compact'>
      <listitem>
        <para>Help documentation: <ulink url="&gnucash-docs-download;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &gnucash-docs-md5sum;</para>
      </listitem>
    </itemizedlist>

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

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="guile"/>,
    <xref linkend="slib"/>, and
    <!-- <xref linkend="gtkhtml1"/>,
    <xref linkend="libghttp"/>,
    <xref linkend="gwrap"/>, and -->
    <xref linkend="perl-xml-parser"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="postgresql"/>,
    <!-- <xref linkend="guppi"/>, -->
    <xref linkend="scrollkeeper"/>,
    <xref linkend="doxygen"/>,
    <xref linkend="graphviz"/>,
    <ulink url="ftp://ftp.gnu.org/pub/gnu/guile/">Guile-www</ulink>, and
    <ulink url="http://perens.com/FreeSoftware/">Electric Fence</ulink></para>

    <bridgehead renderas="sect4">Optional (for On-Line Banking)</bridgehead>
    <para role="optional"><ulink
    url="http://libofx.sourceforge.net/">LibOFX</ulink>
    (requires <xref linkend="opensp"/> and <xref linkend="curl"/>),
    <ulink url="http://sourceforge.net/projects/ktoblzcheck">KtoBlzCheck</ulink>,
    and <ulink url="http://www.aquamaniac.de/aqbanking/">AqBanking</ulink>
    (requires <ulink
    url="http://gwenhywfar.sourceforge.net/">Gwenhywfar</ulink>
    and also see <ulink
    url="http://www.libchipcard.de/">libchipcard2</ulink>)</para>

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

  </sect2>

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

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

<screen><userinput>sed -i 's/^host_os=.*$/&amp;-gnu/' configure &amp;&amp;
./configure --prefix=/opt/gnome-1.4 \
            --sysconfdir=/etc \
            --disable-guppi \
            --disable-error-on-warning &amp;&amp;
make</userinput></screen>

    <para>To test the results, issue <command>make check</command>. All tests
    should pass. An easy way to look at the results of the tests is to issue
    <command>grep -A1 ============== check.log</command> (this is assuming you
    redirected the output from the tests to the aforementioned filename).</para>

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

<screen role='root'><userinput>make install</userinput></screen>

    <para>If desired, create a symbolic link from the
    <application>GnuCash</application> documentation directory to the
    system-wide documentation directory using the following command as the
    <systemitem class="username">root</systemitem> user:</para>

<screen role='root'><userinput>ln -v -s /opt/gnome-1.4/share/gnucash/doc \
         /usr/share/doc/gnucash-&gnucash-version;</userinput></screen>

    <para>If desired, create symbolic links to the
    <application>GnuCash</application> <filename>.desktop</filename> and icon
    files in the system-wide directories using the following commands as the
    <systemitem class="username">root</systemitem> user:</para>

<screen role='root'><userinput>install -v -m755 -d /usr/share/pixmaps/gnucash &amp;&amp;
ln -v -s /opt/gnome-1.4/share/pixmaps/gnucash/gnucash-icon.png \
         /usr/share/pixmaps/gnucash &amp;&amp;
ln -v -s /opt/gnome-1.4/share/gnome/apps/Applications/gnucash.desktop \
         /usr/share/applications</userinput></screen>

    <para>If you want to install the Help documentation (requires
    <xref linkend="scrollkeeper"/> to be installed), unpack the additional
    tarball, change into the
    <filename class='directory'>gnucash-docs-&gnucash-docs-version;</filename>
    source directory and issue the following commands as an unprivileged
    user:</para>

<screen><userinput>./configure --prefix=/opt/gnome-1.4 \
            --localstatedir=/var/lib &amp;&amp;
make</userinput></screen>

    <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>sed -i 's/^\(host_os=.*\)$/\1-gnu/' configure</command>:
    This command is used to fix a broken <command>configure</command> script.
    Without it, no shared libraries are built, and the program will not
    function properly.</para>

    <para><parameter>--prefix=/opt/gnome-1.4</parameter>:
    <application>GnuCash</application>-&gnucash-version; is a
    <application>GNOME</application>-1.4 application.</para>

    <para><parameter>--sysconfdir=/etc</parameter>: This installs configuration
    files in <filename class='directory'>/etc/gnucash</filename> instead of
    <filename class='directory'>/opt/gnome-1.4/etc/gnucash</filename>.</para>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../../xincludes/scrollkeeper-dir.xml"/>

    <para><parameter>--disable-guppi</parameter>: This compiles
    <application>GnuCash</application> without support for creating
    GUI graphs and plots. Remove this option if you have
    <application>Guppi</application> installed.</para>

    <para><parameter>-disable-error-on-warning</parameter>: Without this
    parameter the build will fail because a warning is generated. This option
    forces the build to ignore the warning.</para>

    <para><option>--enable-sql</option>: This parameter is required if you want
    to build in SQL support using <application>PostgreSQL</application>.</para>

    <para><option>--enable-ofx</option>: This parameter is required if you want
    to build in on-line banking support using
    <application>LibOFX</application>.</para>

    <para><option>--enable-hbci</option>: This parameter is required if you
    want to build in on-line banking support using
    <application>AqBanking</application>. See
    <filename>doc/README.HBCI</filename> in the
    <application>GnuCash</application> source tree for complete
    information.</para>

  </sect2>

  <sect2 role="configuration">
    <title>Configuring GnuCash</title>

    <sect3>
      <title>Configuration Information</title>

      <para>If you wish to use <application>GnuCash</application> to retrieve
      stock price quotes and stock historical information, you'll need to
      install the following <application>Perl</application> modules:
      <xref linkend="perl-lwp"/>, <xref linkend="perl-date-manip"/>,
      <xref linkend="perl-html-parser"/>, <xref linkend="perl-finance-quote"/>
      and <xref linkend="perl-finance-quotehist"/>.</para>

      <!--
      <note>
        <para><application>GnuCash</application> must be run as
        <systemitem class="username">root</systemitem> once before use. Simply
        executing <command>gnucash</command> from an <application>X</application>
        terminal and clicking on the cancel button is sufficient. This must be
        done prior to setting up accounts as an unprivileged user, due to the
        fact that <application>GnuCash</application> must update scheme catalogs
        before it is used.</para>
      </note>
      -->

    </sect3>

  </sect2>

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

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

      <seglistitem>
        <seg>dump-finance-quote, gnc-prices, gnc-test-env, gnucash,
        gnucash-config, gnucash-env, gnucash-make-guids, gnucash-run-script
        and update-finance-quote</seg>
        <seg>libcore-utils.so, libgnc-app-file-gnome.so, libgncgnome.so,
        libgncmodule.so, libgw-core-utils.so, libgw-gnc.so and numerous
        support libraries installed in
        <filename class='directory'>/opt/gnome-1.4/lib/gnucash</filename></seg>
        <seg>/etc/gnucash,
        /opt/gnome-1.4/include/gnucash,
        /opt/gnome-1.4/lib/gnucash,
        /opt/gnome-1.4/libexec/gnucash,
        /opt/gnome-1.4/share/gnome/apps/Applications,
        /opt/gnome-1.4/share/gnome/help/gnucash,
        /opt/gnome-1.4/share/gnucash,
        /opt/gnome-1.4/share/omf/gnucash-docs and
        /opt/gnome-1.4/share/pixmaps/gnucash</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="gnucash-prog">
        <term><command>gnucash</command></term>
        <listitem>
          <para>is a personal finance manager.</para>
          <indexterm zone="gnucash gnucash-prog">
            <primary sortas="b-gnucash">gnucash</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>