From 3b37f7e8004331a4790d6d864f6e3943b8c606b3 Mon Sep 17 00:00:00 2001 From: Randy McMurchy Date: Sun, 5 Aug 2007 18:42:42 +0000 Subject: [PATCH] Updated to GnuCash-2.2.0 git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@7014 af4574ff-66df-0310-9fd7-8a98e5e911e0 --- general.ent | 4 +- general/genlib/libgsf.xml | 5 +- general/prog/perl-modules.xml | 3 +- introduction/welcome/changelog.xml | 16 +- introduction/welcome/credits.xml | 6 +- xsoft/office/gnucash.xml | 235 ++++++++++++++++------------- 6 files changed, 155 insertions(+), 114 deletions(-) diff --git a/general.ent b/general.ent index 1a716b8784..876821753f 100644 --- a/general.ent +++ b/general.ent @@ -3,7 +3,7 @@ $LastChangedBy$ $Date$ --> - + @@ -566,7 +566,7 @@ $Date$ - + diff --git a/general/genlib/libgsf.xml b/general/genlib/libgsf.xml index d32ad9b959..1b5aa82dd4 100644 --- a/general/genlib/libgsf.xml +++ b/general/genlib/libgsf.xml @@ -73,9 +73,10 @@ library which provides GNOME-2 support), and - Note: you need to build the + Note: you should build the libgsf-gnome-1.so library if you - plan on building with GNOME support. + plan on building or + with GNOME support. User Notes: diff --git a/general/prog/perl-modules.xml b/general/prog/perl-modules.xml index db4247577d..ab9eb6739e 100644 --- a/general/prog/perl-modules.xml +++ b/general/prog/perl-modules.xml @@ -556,7 +556,8 @@ - Crypt-SSLeay-&Crypt-SSLeay-version; (optional, for HTTPS support) diff --git a/introduction/welcome/changelog.xml b/introduction/welcome/changelog.xml index 40a8c04ebd..a9dd23fb5d 100644 --- a/introduction/welcome/changelog.xml +++ b/introduction/welcome/changelog.xml @@ -41,6 +41,15 @@ --> + + August 5th, 2007 + + + [randy] - Updated to GnuCash-2.2.0. + + + + August 3rd, 2007 @@ -54,11 +63,8 @@ [randy] - Updated to SLIB-3a4. - [randy] - Updated to Guile-1.8.2. This update effectively - breaks the current GnuCash instructions, so a note has been placed - on the GnuCash page to use the stable BLFS book to install the - package. This note is temporary and will be removed when GnuCash - is updated to version 2.x. Since no other BLFS packages depend on the + [randy] - Updated to Guile-1.8.2. This breaks the GnuCash + package instructions and since no other BLFS packages depend on the GNOME-1.4 libraries, the entire GNOME-1.4 section of the book has been commented out. diff --git a/introduction/welcome/credits.xml b/introduction/welcome/credits.xml index e7b497312b..952be71c7b 100644 --- a/introduction/welcome/credits.xml +++ b/introduction/welcome/credits.xml @@ -204,8 +204,8 @@ - Dash: - Agathoklis Hatzimanikas + Dash and rxvt-unicode: + Ag Hatzimanikas @@ -273,7 +273,7 @@ additions), Expect, FOP, FreeTTS, FriBidi, GC, GCC (rewrite), GMime, gnome-audio, gnome-backgrounds, gnome-menus, gnome-mount, gnome-screensaver, gnome-volume-manager, GNOME Doc Utils, - GNOME Keyring Manager, GnuCash (many additions), GOffice, Graphviz, + GNOME Keyring Manager, GnuCash (version 2), GOffice, Graphviz, GStreamer Base Plug-ins, GStreamer Good Plug-ins, GStreamer Ugly Plug-ins, HAL, Heimdal, HTML Tidy, icon-naming-utils, ISO Codes, JadeTeX, Java Access Bridge, JUnit, K3b, LessTif (rewrite), libexif, diff --git a/xsoft/office/gnucash.xml b/xsoft/office/gnucash.xml index dd120a45cd..8210aebb9c 100644 --- a/xsoft/office/gnucash.xml +++ b/xsoft/office/gnucash.xml @@ -6,13 +6,14 @@ - - - - - + + + + + - + + ]> @@ -33,12 +34,7 @@ Introduction to GnuCash GnuCash 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. + manager. Package Information @@ -70,27 +66,28 @@ Download MD5 sum: &gnucash-docs-md5sum; + + Download size: &gnucash-docs-size; + GnuCash Dependencies Required , - , and - - + , + , + , and + Optional , - - , - , - , Guile-www, and Electric Fence + Optional (Required for the Help System) + + Optional (for On-Line Banking) LibOFX @@ -99,8 +96,7 @@ and AqBanking (requires Gwenhywfar - and also see libchipcard2) + and libchipcard3) User Notes: @@ -113,93 +109,136 @@ Install GnuCash by running the following commands: -sed -i 's/^host_os=.*$/&-gnu/' configure && -./configure --prefix=/opt/gnome-1.4 \ - --sysconfdir=/etc \ - --disable-guppi \ - --disable-error-on-warning && +sed -i 's|xml::${sysconfdir}|xml::&gnome-etc-dir;|' configure && + +./configure \ + --prefix=/usr \ + --sysconfdir=/etc \ + --libexecdir=/usr/lib \ + --with-gconf-schema-file-dir=&gnome-etc-dir;/gconf/schemas && make + If you wish to create the API documentation in HTML format, you must + have and installed, + then issue: make doc. If you wish to create the API + Design Guide in several formats, you must have + installed and issue: + make -C src/doc/design html pdf ps. + To test the results, issue make check. All tests should pass. An easy way to look at the results of the tests is to issue grep -A1 ============== check.log (this is assuming you - redirected the output from the tests to the aforementioned filename). + redirected the output from the tests to the indicated filename). Now, as the root user: -make install +make install && - If desired, create a symbolic link from the - GnuCash documentation directory to the - system-wide documentation directory using the following command as the - root user: +mv -v /usr/share/gnucash/doc /usr/share/doc/gnucash-&gnucash-version; && +ln -v -s ../doc/gnucash-&gnucash-version; /usr/share/gnucash/doc && -ln -v -s /opt/gnome-1.4/share/gnucash/doc \ - /usr/share/doc/gnucash-&gnucash-version; +for FILENAME in doc/{misc*,gnome*,generic*,build*}.txt \ + doc/{gtkrc*,TRANSLATION_HOWTO,README.translator.txt} \ + doc/README.{build-system,OFX,HBCI} +do + install -v -m644 ${FILENAME} /usr/share/doc/gnucash-&gnucash-version; +done && - If desired, create symbolic links to the - GnuCash .desktop and icon - files in the system-wide directories using the following commands as the - root user: +install -v -m755 -d /usr/share/doc/gnucash-&gnucash-version;/api/engine && +install -v -m644 src/doc/{TODO*,*.txt,*.html} \ + /usr/share/doc/gnucash-&gnucash-version;/api && +install -v -m644 src/engine/*.txt \ + /usr/share/doc/gnucash-&gnucash-version;/api/engine -install -v -m755 -d /usr/share/pixmaps/gnucash && -ln -v -s /opt/gnome-1.4/share/pixmaps/gnucash/gnucash-icon.png \ - /usr/share/pixmaps/gnucash && -ln -v -s /opt/gnome-1.4/share/gnome/apps/Applications/gnucash.desktop \ - /usr/share/applications + If you built the API HTML or Design Guide documentation, issue the + following commands (modified as necessary, depending on what docs are + being installed) as the root + user: - If you want to install the Help documentation (requires - to be installed), unpack the additional +install -v -m755 -d /usr/share/doc/gnucash-&gnucash-version;/{design,api}/html && +install -v -m644 src/doc/design/gnucash-design.html/* \ + /usr/share/doc/gnucash-&gnucash-version;/design/html && +install -v -m644 src/doc/design/gnucash-design.{pdf,ps,dvi} \ + /usr/share/doc/gnucash-&gnucash-version;/design && +install -v -m644 src/doc/html/* \ + /usr/share/doc/gnucash-&gnucash-version;/api/html + + If you want to install the Help documentation system, you must have + installed. Then unpack the additional tarball, change into the gnucash-docs-&gnucash-docs-version; source directory and issue the following commands as an unprivileged user: -./configure --prefix=/opt/gnome-1.4 \ +./configure --prefix=/usr \ --localstatedir=/var/lib && make + HTML versions of the Help Manual and Users Guide can be created if + the DocBook XML tools are installed (, + and ). A PDF version + of the Users Guide can be created if you have + and installed. Issue the following commands to + create the documentation (modify as appropriate for your desires): + +make -C help html && +make -C guide html && +make -C guide pdf + Now, as the root user: make install + If you built the Help Manual or Users Guide, install them using the + following commands as the root + user (modify as necessary): + +install -v -m755 -d /usr/share/doc/gnucash-&gnucash-version;/{users_guide,help} && +cp -v -R help/C/gnucash-help/* \ + /usr/share/doc/gnucash-&gnucash-version;/help && +cp -v -R guide/C/gnucash-guide/* \ + /usr/share/doc/gnucash-&gnucash-version;/users_guide && +install -v -m644 guide/C/gnucash-guide.pdf \ + /usr/share/doc/gnucash-&gnucash-version; + Command Explanations - sed -i 's/^\(host_os=.*\)$/\1-gnu/' configure: - This command is used to fix a broken configure script. - Without it, no shared libraries are built, and the program will not - function properly. - - --prefix=/opt/gnome-1.4: - GnuCash-&gnucash-version; is a - GNOME-1.4 application. + sed -i 's|xml::${sysconfdir}|xml::&gnome-etc-dir;|' + configure: This command is used because the location of the + GConf source database is hard-coded into + the configure script as + $sysconfdir/gconf + (rendering the parameter useless). + The modification ensures that the GConf database + is properly updated while still allowing the package configuration files + to be installed in + /etc/gnucash. --sysconfdir=/etc: This installs configuration files in /etc/gnucash instead of - /opt/gnome-1.4/etc/gnucash. + /usr/etc/gnucash. + + --with-gconf-schema-file-dir=&gnome-etc-dir;/gconf/schemas: + This parameter ensures that the GConf schema + files are installed in the proper location instead of + /etc/gconf. + + mv -v /usr/share/gnucash/doc + /usr/share/doc/gnucash-&gnucash-version; and + ln -v -s ../doc/gnucash-&gnucash-version; + /usr/share/gnucash/doc: These commands are used to relocate the + documentation files to the customary location and create a symbolic link + to the original location. - --disable-guppi: This compiles - GnuCash without support for creating - GUI graphs and plots. Remove this option if you have - Guppi installed. - - -disable-error-on-warning: Without this - parameter the build will fail because a warning is generated. This option - forces the build to ignore the warning. - : This parameter is required if you want to build in SQL support using PostgreSQL. - : This parameter is required if you want - to build in on-line banking support using - LibOFX. - : This parameter is required if you want to build in on-line banking support using AqBanking. See @@ -216,23 +255,16 @@ make Configuration Information If you wish to use GnuCash to retrieve - stock price quotes and stock historical information, you'll need to + stock price quotes, you'll need to install the following Perl modules: - , , - , - and . - - + , + , + , + , + , and + . Alternatively, you can run the + /usr/bin/gnc-fq-update script as the + root user. @@ -247,22 +279,23 @@ make Installed Directories - dump-finance-quote, gnc-prices, gnc-test-env, gnucash, - gnucash-config, gnucash-env, gnucash-make-guids, gnucash-run-script - and update-finance-quote - 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 - /opt/gnome-1.4/lib/gnucash + gnc-fq-check, gnc-fq-dump, gnc-fq-helper, gnc-fq-update, + gnc-test-env, gnucash, gnucash-bin, gnucash-env, gnucash-make-guids, + gnucash-valgrind, and update-gnucash-gconf + libgnc-backend-file-utils.so, libgnc-backend-postgres.so, + libgnc-business-ledger.so,libgnc-core-utils.so, libgnc-gnome.so, + libgnc-module.so, libgnc-qof.so and numerous support libraries + installed in + /usr/lib/gnucash /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 + /usr/include/gnucash, + /usr/lib/gnucash, + and the following subdirectories of /usr/share/: + doc/gnucash-&gnucash-version;, + gnome/help/gnucash, + gnucash, + omf/gnucash-docs, and + /xml/gnucash