source: xsoft/office/gnucash.xml@ da836cf

10.0 10.1 11.0 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since da836cf was da836cf, checked in by Andrew Benton <andy@…>, 10 years ago

gnucash testsuite is b0rken

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@9544 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 10.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY gnucash-download-http
8 "&sourceforge-repo;/gnucash/gnucash-&gnucash-version;.tar.bz2">
9 <!ENTITY gnucash-download-ftp
10 " ">
11 <!ENTITY gnucash-src-md5sum "eebcf231beffe39a9c1b5f09625bb38e">
12 <!ENTITY gnucash-size "8.9 MB">
13 <!ENTITY gnucash-buildsize "234 MB">
14 <!ENTITY gnucash-time "2.2 SBU">
15 <!ENTITY gnucash-docs-version "2.4.1">
16 <!ENTITY gnucash-docs-download
17 "&sourceforge-repo;/gnucash/gnucash-docs-&gnucash-docs-version;.tar.gz">
18 <!ENTITY gnucash-docs-md5sum "38daeb3b15f296726ee8124122040f08">
19 <!ENTITY gnucash-docs-size "32.5 MB">
20 <!ENTITY gnucash-docs-buildsize "27 MB">
21 <!ENTITY gnucash-docs-time "0.5 SBU">
22]>
23
24<sect1 id="gnucash" xreflabel="GnuCash-&gnucash-version;">
25 <?dbhtml filename="gnucash.html" ?>
26
27 <sect1info>
28 <othername>$LastChangedBy$</othername>
29 <date>$Date$</date>
30 </sect1info>
31
32 <title>GnuCash-&gnucash-version;</title>
33
34 <indexterm zone="gnucash">
35 <primary sortas="a-GnuCash">GnuCash</primary>
36 </indexterm>
37
38 <sect2 role="package">
39 <title>Introduction to GnuCash</title>
40
41 <para><application>GnuCash</application> is a personal finance
42 manager.</para>
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>
48 Download (HTTP): <ulink url="&gnucash-download-http;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download (FTP): <ulink url="&gnucash-download-ftp;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download MD5 sum: &gnucash-src-md5sum;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download size: &gnucash-size;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated disk space required: &gnucash-buildsize;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated build time: &gnucash-time;
74 </para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
79 <itemizedlist spacing="compact">
80 <listitem>
81 <para>
82 Required patch:
83 <ulink url="&patch-root;/gnucash-&gnucash-version;-guile-2_fixes-1.patch"/>
84 </para>
85 </listitem>
86 <listitem>
87 <para>
88 Optional Help documentation: <ulink url="&gnucash-docs-download;"/>
89 </para>
90 </listitem>
91 <listitem>
92 <para>
93 Download MD5 sum: &gnucash-docs-md5sum;
94 </para>
95 </listitem>
96 <listitem>
97 <para>
98 Download size: &gnucash-docs-size;
99 </para>
100 </listitem>
101 <listitem>
102 <para>
103 Estimated disk space required: &gnucash-docs-buildsize;
104 </para>
105 </listitem>
106 <listitem>
107 <para>
108 Estimated build time: &gnucash-docs-time;
109 </para>
110 </listitem>
111 </itemizedlist>
112
113 <bridgehead renderas="sect3">GnuCash Dependencies</bridgehead>
114
115 <bridgehead renderas="sect4">Required</bridgehead>
116 <para role="required">
117 <xref linkend="guile"/>,
118 <xref linkend="libgnomeui"/>,
119 <xref linkend="gnome-vfs"/>,
120 <xref linkend="slib"/> and
121 <xref linkend="goffice"/>.
122 </para>
123 <para role="required">
124 <xref linkend="gtkhtml"/> or
125 <xref linkend="webkitgtk"/> (configured <option>--with-gtk=2.0</option>).
126 </para>
127
128 <bridgehead renderas="sect4">Optional</bridgehead>
129 <para role="optional">
130 <ulink url="http://libdbi.sourceforge.net/">libdbi</ulink> (and
131 <ulink url="http://libdbi-drivers.sourceforge.net/">libdbi drivers</ulink>) and
132 <ulink url="ftp://ftp.gnu.org/pub/gnu/guile/">Guile-www</ulink>
133 </para>
134
135 <bridgehead renderas="sect4">Optional (Required for the Help System)</bridgehead>
136 <para role="optional">
137 <xref linkend="rarian"/> and
138 <xref linkend="yelp"/> (run-time requirement to view the Help documents).
139 </para>
140
141 <bridgehead renderas="sect4">Optional (for On-Line Banking)</bridgehead>
142 <para role="optional">
143 <ulink url="http://libofx.sourceforge.net/">LibOFX</ulink> (requires
144 <xref linkend="opensp"/> and <xref linkend="curl"/>),
145 <ulink url="http://sourceforge.net/projects/ktoblzcheck">KtoBlzCheck</ulink> and
146 <ulink url="http://www.aquamaniac.de/aqbanking/">AqBanking</ulink> (requires
147 <ulink url="http://gwenhywfar.sourceforge.net/">Gwenhywfar</ulink> and
148 <ulink url="http://www.libchipcard.de/">libchipcard3</ulink>)
149 </para>
150
151 <para condition="html" role="usernotes">
152 User Notes: <ulink url="&blfs-wiki;/gnucash"/>
153 </para>
154
155 </sect2>
156
157 <sect2 role="installation">
158 <title>Installation of GnuCash</title>
159
160 <para>Install <application>GnuCash</application> by running the following
161 commands:</para>
162
163<screen><userinput>patch -p1 &lt; ../gnucash-&gnucash-version;-guile-2_fixes-1.patch &amp;&amp;
164./configure --prefix=${GNOME_PREFIX} --sysconfdir=${GNOME_SYSCONFDIR} &amp;&amp;
165make</userinput></screen>
166
167 <para>
168 If you wish to create the API documentation in HTML format, you must
169 have <xref linkend="doxygen"/> and <xref linkend="graphviz"/> installed,
170 then issue: <command>make doc</command>. If you wish to create the API
171 Design Guide in several formats, you must have <xref linkend="texlive"/>
172 installed and issue: <command>make -C src/doc/design html pdf
173 ps</command>.
174 </para>
175
176 <para>
177 The test suite is currently broken due to problems with <application>Guile
178 2</application>.
179 <!-- To test the results, issue: <command>make check</command>.-->
180 </para>
181
182 <para>
183 Now, as the <systemitem class="username">root</systemitem> user:
184 </para>
185
186<screen role="root"><userinput>make install</userinput></screen>
187
188 <para>
189 If you want to install the Help documentation system, you must have
190 <xref linkend="yelp"/> and <xref linkend="rarian"/> installed in order to
191 view the Help documents. Unpack the additional tarball, change into the
192 <filename class="directory">gnucash-docs-&gnucash-docs-version;</filename>
193 source directory and issue the following commands as an unprivileged
194 user:
195 </para>
196
197<screen><userinput>./configure --prefix=${GNOME_PREFIX} &amp;&amp;
198make</userinput></screen>
199
200 <para>
201 HTML versions of the Users Guide can be created if the DocBook XML tools
202 are installed (<xref linkend="libxslt"/>, <xref linkend="DocBook"/> and
203 <xref linkend="docbook-xsl"/>). A PDF version of the Users Guide can be
204 created if you have <xref linkend="docbook-utils"/>,
205 <xref linkend="jadetex"/> and <xref linkend="fop"/> installed.
206 Issue the following commands to create the documentation:
207 </para>
208
209<screen><userinput>make -C guide html &amp;&amp;
210make -C guide pdf</userinput></screen>
211
212 <para>
213 Now, as the <systemitem class="username">root</systemitem> user:
214 </para>
215
216<screen role="root"><userinput>make install</userinput></screen>
217
218 <para>
219 If you built the Users Guide, install it as the
220 <systemitem class="username">root</systemitem> user:
221 </para>
222
223<screen role="root"><userinput>mkdir -p ${GNOME_PREFIX}/share/doc/gnucash-&gnucash-docs-version; &amp;&amp;
224cp -v -R guide/C/gnucash-guide/* ${GNOME_PREFIX}/share/doc/gnucash-&gnucash-docs-version; &amp;&amp;
225cp -v guide/C/gnucash-guide.pdf ${GNOME_PREFIX}/share/doc/gnucash-&gnucash-docs-version;</userinput></screen>
226 </sect2>
227
228 <sect2 role="commands">
229 <title>Command Explanations</title>
230
231 <para>
232 <parameter>--sysconfdir=${GNOME_SYSCONFDIR}</parameter>: This installs
233 configuration files in
234 <filename class="directory">${GNOME_SYSCONFDIR}/gnucash</filename> instead
235 of <filename class="directory">/usr/etc/gnucash</filename>.
236 </para>
237
238 <para>
239 <option>--with-html-engine=webkit</option>: Add this option to use
240 <xref linkend="webkitgtk"/> (configured <option>--with-gtk=2.0</option>)
241 instead of <xref linkend="gtkhtml"/>.
242 </para>
243
244 <para>
245 <option>--disable-dbi</option>: Add this option if you've not installed
246 <application>libdbi</application>.
247 </para>
248 </sect2>
249
250 <sect2 role="configuration">
251 <title>Configuring GnuCash</title>
252
253 <sect3>
254 <title>Configuration Information</title>
255
256 <para>
257 If you wish to use <application>GnuCash</application> to retrieve
258 stock price quotes, you'll need to
259 install the following <application>Perl</application> modules:
260 <xref linkend="perl-lwp"/>, <xref linkend="perl-date-manip"/>,
261 <xref linkend="perl-html-parser"/>,
262 <xref linkend="perl-html-tableextract"/>,
263 <xref linkend="perl-crypt-ssleay"/>, and
264 <xref linkend="perl-finance-quote"/>. Alternatively, you can run the
265 <command>gnc-fq-update</command> script as the
266 <systemitem class="username">root</systemitem> user.
267 </para>
268 </sect3>
269 </sect2>
270
271 <sect2 role="content">
272 <title>Contents</title>
273
274 <segmentedlist>
275 <segtitle>Installed Programs</segtitle>
276 <segtitle>Installed Libraries</segtitle>
277 <segtitle>Installed Directories</segtitle>
278
279 <seglistitem>
280 <seg>
281 gnc-fq-check, gnc-fq-dump, gnc-fq-helper, gnc-fq-update,
282 gnucash, gnucash-env, gnucash-make-guids, gnucash-valgrind and
283 update-gnucash-gconf
284 </seg>
285 <seg>
286 libgnc-backend-sql.so, libgnc-backend-xml-utils.so,
287 libgnc-business-ledger.so,libgnc-core-utils.so, libgnc-gnome.so,
288 libgnc-module.so, libgnc-qof.so and numerous support libraries
289 installed in <filename class="directory">/usr/lib/gnucash</filename>
290 </seg>
291 <seg>
292 ${GNOME_SYSCONFDIR}/gnucash, ${GNOME_PREFIX}/include/gnucash,
293 ${GNOME_PREFIX}/lib/gnucash, ${GNOME_PREFIX}/libexec/gnucash and
294 ${GNOME_PREFIX}/share/doc/gnucash-&gnucash-version;.
295 </seg>
296 </seglistitem>
297 </segmentedlist>
298
299 <variablelist>
300 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
301 <?dbfo list-presentation="list"?>
302 <?dbhtml list-presentation="table"?>
303
304 <varlistentry id="gnucash-prog">
305 <term><command>gnucash</command></term>
306 <listitem>
307 <para>is a personal finance manager.</para>
308 <indexterm zone="gnucash gnucash-prog">
309 <primary sortas="b-gnucash">gnucash</primary>
310 </indexterm>
311 </listitem>
312 </varlistentry>
313 </variablelist>
314 </sect2>
315</sect1>
Note: See TracBrowser for help on using the repository browser.