source: xsoft/office/gnucash.xml@ 79e6d17

10.0 10.1 11.0 11.1 11.2 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 krejzi/svn lazarus nosym perl-modules plabs/python-mods qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 79e6d17 was 79e6d17, checked in by Bruce Dubbs <bdubbs@…>, 10 years ago

Update to gnucash-2.4.11
Tag several packages for 7.2.
Formatting and other general touchups.
Remove references to GNOME_PREFIX for several GNOME2 packages.

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

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