Update README for 3.0.

This commit is contained in:
John Ralls 2018-04-06 15:46:29 -07:00
parent 91c18beac1
commit 87b0ac06b8

83
README
View File

@ -1,7 +1,7 @@
############################################################ ############################################################
GnuCash 2.6.x README file. GnuCash 3.x README file.
The last known stable series is the 2.6.0 series. The current stable series is GnuCash 3.x.
------------------------------------------------------------ ------------------------------------------------------------
################## ##################
@ -54,9 +54,9 @@ Features include:
picks duplicate transactions and assigns contra accounts based on picks duplicate transactions and assigns contra accounts based on
similar previously-imported transactions. similar previously-imported transactions.
- HBCI Support: GnuCash also supports the German Home Banking - HBCI/FinTX Support: GnuCash also supports the German FinTS (formerly
Computer Interface protocol which includes statement download, Home Banking Computer Interface protocol which includes statement download,
initiate bank transfers and direct debits. initiate bank transfers and direct debits.
- Quicken File Import: Import Quicken QIF style files. QIF files - Quicken File Import: Import Quicken QIF style files. QIF files
are automatically merged to eliminate duplicate transactions. are automatically merged to eliminate duplicate transactions.
@ -65,8 +65,7 @@ Features include:
makes reconciliation easy. makes reconciliation easy.
- Stock/Mutual Fund Portfolios: Track stocks individually (one per - Stock/Mutual Fund Portfolios: Track stocks individually (one per
account) or in portfolio of accounts (a group of accounts that can account).
be displayed together).
- Get Stock & Mutual Fund quotes from various web sites, update - Get Stock & Mutual Fund quotes from various web sites, update
portfolio automatically (more funds being added regularly). portfolio automatically (more funds being added regularly).
@ -80,10 +79,6 @@ Features include:
supported and can be bought and sold (traded). Currency movements supported and can be bought and sold (traded). Currency movements
between accounts are fully balanced when double-entry is enabled. between accounts are fully balanced when double-entry is enabled.
- New Multi-Currency Transaction Handling: GnuCash no longer
requires separate currency exchange accounts to handle multiple
currency transfers.
- Chart of Accounts: A master account can have a hierarchy of detail - Chart of Accounts: A master account can have a hierarchy of detail
accounts underneath it. This allows similar account types accounts underneath it. This allows similar account types
(e.g. Cash, Bank, Stock) to be grouped into one master account (e.g. Cash, Bank, Stock) to be grouped into one master account
@ -108,11 +103,11 @@ Features include:
viewing a portfolio of many stocks, by showing all transactions in viewing a portfolio of many stocks, by showing all transactions in
that portfolio. that portfolio.
- Written in C with embedded scheme support via Guile. - Written in C/C++ with embedded scheme support via Guile.
- File access is locked in a network-safe fashion, preventing - File access is locked in a network-safe fashion, preventing
accidental damage if several users attempt to access the same accidental damage if several users attempt to access the same
file, even if the file is NFS-mounted. file, even if the file is on a shared file system.
- SQL storage is supported using MySQL, Postgresql, and - SQL storage is supported using MySQL, Postgresql, and
SQLite3. Note that this does not support multiple concurrent SQLite3. Note that this does not support multiple concurrent
@ -136,31 +131,17 @@ The following packages are required to be installed to run GnuCash:
[see README.dependencies] [see README.dependencies]
The optional online stock and currency price retrieval feature requires Perl. This is generally already installed on Gnu/Linux and *BSD, and MacOSX. The optional online stock and currency price retrieval feature requires Perl.
This is generally already installed on Gnu/Linux and *BSD, and MacOS.
In addition, some perl modules need to be installed. You can run the In addition, some perl modules need to be installed. You can run the
script 'update-finance-quote' as root to obtain the latest versions of script 'gnc-fq-update' as root to obtain the latest versions of
required packages. This program requires an C compiler, which is required packages.
generally already installed in Gnu/Linux and *BSD, but must be
installed separately on MacOSX; on versions 10.6 and earlier, install
Xcode from the distribution DVD or by downloading from
http://developer.apple.com (you'll need to log in with your Apple ID);
for 10.7 and 10.8, you can get Xcode for free from the App store. 10.9
has a cool feature that detects an attempt to compile and offers to
install the command-line build tools for you.
Microsoft Windows users can use the "Install Online Quotes" program in the Start menu's Gnucash group. Microsoft Windows users can use the "Install Online Quotes" program in the
Start menu's Gnucash group; it will install perl and all of the required
To use the OFX and HBCI import features you need to obtain modules more-or-less automatically. MacOS users will find "Update Finance Quote"
the following; in the distribution disk image; it will automate running gnc-fq-update for you.
libofx: This library provide support for OFX file imports.
GnuCash-2.0.0 and newer needs at least the version libofx-0.7.0
or newer. Sources can be found at
http://sourceforge.net/projects/libofx/
aqbanking: This library provide support for HBCI and openOFX online actions.
Three libraries, Ktoblzcheck, Gwenhywfar, and AQBanking, are required.
All may be obtained from
http://www2.aquamaniac.de/sites/download/packages.php
####### #######
Running Running
@ -209,7 +190,7 @@ Building & Installing
GnuCash uses CMake to handle the build process. Details are available GnuCash uses CMake to handle the build process. Details are available
in cmake/README_CMAKE.txt (If you are building directly from Git, read in cmake/README_CMAKE.txt (If you are building directly from Git, read
the README.git file for more instructions.) the README.git file for more instructions.)
Prior to building GnuCash, you will have to obtain and install the Prior to building GnuCash, you will have to obtain and install the
following packages: following packages:
@ -227,18 +208,6 @@ following packages:
SWIG: 2.0.10 or later is needed. See http://www.swig.org or SWIG: 2.0.10 or later is needed. See http://www.swig.org or
http://sourceforge.net/projects/swig/ http://sourceforge.net/projects/swig/
What you'll need to get and install in order to make sure you have all
of these pieces properly installed for your particular operating
system flavor will vary, but here's at least a partial list of what
you'll need for the systems we know about:
Debian/GNU/Linux: see README.dependencies and
current:
libgnome-dev
libwebkit-dev
guile
libguile9-dev
Generally, up-to-date build instructions for various Linux Generally, up-to-date build instructions for various Linux
distributions can be found on the GnuCash wiki at distributions can be found on the GnuCash wiki at
https://wiki.gnucash.org/wiki/Building https://wiki.gnucash.org/wiki/Building
@ -280,24 +249,25 @@ details.
Supported Platforms Supported Platforms
------------------- -------------------
GnuCash 2.x is known to work with the following operating systems: GnuCash 3.x is known to work with the following operating systems:
GNU/Linux -- x86, Sparc, PPC GNU/Linux -- x86, Sparc, PPC
FreeBSD -- x86 FreeBSD -- x86
OpenBSD -- x86 OpenBSD -- x86
MacOS X -- PPC and Intel, Versions 10.5 and later MacOS -- Intel, Versions 10.9 and later
GnuCash can probably be made to work on any platform for which Gtk+ can, GnuCash can probably be made to work on any platform for which Gtk+ can
given sufficient effort. If you try and encounter difficulty, please join and for which there is a C++11 compiler available, given sufficient expertise
the developer's mailing list, gnucash-devel@gnucash.org. and effort. If you try and encounter difficulty, please subscribe to the
developer's mailing list, gnucash-devel@gnucash.org and we'll try to help you.
######################### #########################
Downloads Downloads
------------------------- -------------------------
GnuCash sources and Mac and Windows binaries are hosted at GnuCash sources and Mac and Windows binaries are hosted at
SourceForge. Links for the current version are provided at SourceForge and Github. Links for the current version are provided at
http://www.gnucash.org. We depend upon distribution packagers for http://www.gnucash.org. We depend upon distribution packagers for
GNU/Linux and *BSD binaries, so if you want a more recent version than GNU/Linux and *BSD binaries, so if you want a more recent version than
your distribution provides you'll have to build from source. your distribution provides you'll have to build from source.
@ -319,7 +289,8 @@ Before you start developing GnuCash, you should do the following:
1. Read http://wiki.gnucash.org/wiki/Development 1. Read http://wiki.gnucash.org/wiki/Development
2. Look over the doxygen-generated documentation at 2. Look over the doxygen-generated documentation at
http://code.gnucash.org/docs/MASTER/ http://code.gnucash.org/docs/MASTER/ or
http://code.gnucash.org/docs/MAINT/
3. Go to the GnuCash website and skim the archives of the GnuCash 3. Go to the GnuCash website and skim the archives of the GnuCash
development mailing list. development mailing list.
@ -327,6 +298,8 @@ Before you start developing GnuCash, you should do the following:
4. Join the GnuCash development mailing list. See the GnuCash website 4. Join the GnuCash development mailing list. See the GnuCash website
for details on how to do this. for details on how to do this.
5. Build the branch you want from a git clone of our repository and make
sure that your build passes all of the tests and runs correctly.
Submitting a Patch: Submitting a Patch: