GnuCash

MacOSX/2.4.0/Readme * 1 Gnucash for OSX Quartz o 1.1 Prerequisites: o 1.2 Installation: + 1.2.1 Installing Finance::Quote o 1.3 Documentation: o 1.4 Known Issues: o 1.5 License and Included Binaries: Gnucash for OSX Quartz Prerequisites: Gnucash of OSX Quartz requires MacOSX 10.5 (Leopard) or MacOSX 10.6 (Snow Leopard). It will not work on 10.4 (Tiger) because some of the libraries on which it depends now use features introduced in 10.5. Installation: If you are upgrading from a version of Gnucash older than 2.3.9, please run the "Update Dirs" application in the dmg. This will convert your online banking setup to work with the new version of AqBanking and will copy your .gnucash directory to the more Mac-appropriate Library/Application Support/Gnucash. Simply drag Gnucash.app to the Applications folder (or anywhere else you like). When you first open GnuCash.app, it will create a link from the bundle Resources folder to /Library/Gnucash-2.4. It will do this automatically, and no authentication is required. Installing Finance::Quote You can easily install Finance::Quote by double-clicking the "FinanceQuote Update" applet in the dmg. You'll need to have Developer Tools (Tiger or Leopard) or XCode (Snow Leopard) installed. It's available as an optional install on your installation DVD. Documentation: Both the Gnucash Help system and the Gnucash Guide are provided in HTML format. They will open in your default browser when you select the appropriate item in the Help menu. Appropriate sections of help will be similarly opened when you click on a Help button in a dialog box. Known Issues: * Gnucash is not a native Mac application: It is a Gtk+ application which has been recompiled to run on OSX. Accordingly, some features to which Mac users are accustomed aren't supported. Some of these are non-menu-based keyboard shortcuts (key bindings; you can adjust them as you like in the gtkrc file), input methods, and Universal Access. * An instance of dbus is started by the application startup script, but dbus isn't designed to be run that way, so it doesn't shut down when you close the application. When Gnucash starts up again, it will kill any instances of dbus which are running from the same path, but if you move Gnucash.app or are switching between stable and development versions, you may wind up with more than one instance. You can clean out the running dbus-daemons by either issuing "killall dbus-daemon" at a command line or by telling it to quit from /Applications/Utilities/Activity Monitor. Note that if you want to delete Gnucash.app, you'll need to kill the running instance of dbus-daemon first or you'll get "file in use" errors from Finder. * As of Gnucash 2.3.9, Gnucash's configuration files are in $HOME/Library/Application Support/Gnucash instead of $HOME/.gnucash so that they're visible with Finder. GConf and AQBanking still have their configuration files in $HOME/.gconf, $HOME/.gconfd, and $HOME/.aqbanking (Note that 2.3.8 and previous used an older version of aqbanking which kept its config files in $HOME/.banking) * The only libdbi module included is for SQLite. If you need either the MySQL or Postgresql modules, you will have to build them yourself and install them into Gnucash.app/Contents/Resources/lib/dbd. License and Included Binaries: Gnucash is licensed under the Gnu General Public License Version 2, a copy of which can be found in the file LICENSE in this directory and in each bundle's Contents folder. There is also a file "Sources" which lists the several libraries included in the bundle upon which Gnucash depends along with their home webpages where you may find more licensing information and source downloads. A few of the libraries require patches to compile on OSX; all of those patches have been submitted as bugs to the respective libraries, but you'll find them at http://github.com/jralls/gnucash-on-osx/patches if you're really curious.