gnucash/README.german

GnuCash
-------

GnuCash ist ein Programm zur Verwaltung pers<72>nlicher Finanzen.
Eine Scheck-Buch aehnliche Oberflaeche erlaubt die Eingabe und
das Verfolgen von Bankkonten, Aktien und sogar Waehrungshandel.
Die Oberflaeche ist einfach und leicht zu bedienen, aber wird
von einem Doppel-Buchungs Prinzip unterstuetzt, um 
ausgeglichene Konten zu ermoeglichen.
 
Funktionen von GnuCash sind :

  - F<>r jedes Konto wird sowohl der aktuelle Stand als
    auch der Stand nicht best<73>tigter Buchungen gehalten.
  - Ein einfaches Benutzerinterface: wer einen Kontoauszug
    versteht, kann GnuCash verwenden.
  - QuickFill: wenn ein Beschreibungstext f<>r eine Buchung
    mit einem vorangehenden Text identisch ist, kann er
    mit <TAB> automatisch komplettiert werden (z.B. f<>r
    regelm<6C><6D>ige Buchungen wie das Gehalt).
  - Handhabung von Aktien- und Fondsportfolios: der 
    aktuelle Stand kann einzeln (eine Aktie = ein Konto)
    oder als Portfolio (alle Aktien = ein Konto)
    verwaltet werden.
  - Verschiedene Waehrungen und Waehrungshandel :
    Mehrere Waehrungen werden unterstuetzt und koennen
    ge- und verkauft werden. Waehrungsbewegungen auf
    den Konten werden ausgeglichen.(Einige Teile von 
    Waehrungshandel sind aber noch nicht vollstaendig 
    implementiert)
  - Import von Dateien im Quicken Interchange Format 
    (QIF).
  - Berichte : Anzeigen von Gewinn&Verlust oder Portfolios
    , auch in HTML
  - Hierarchie von Konten : Ein Haupt-Konto kann eine Hierarchie
    von Unter-Konten haben. Das macht es moeglich, aehnliche 
    Konten (Bargeld,Spar-,Aktien-Konten)in einem Hauptkonto
    zusammenzufassen.
  - Split-Buchungen : Eine einzelne Buchung kann in mehrere Teile
    zerlegt werden, wie z.B. Steuern, Gebuehren, usw.
  - Doppelte Eintraege : Wenn aktiviert, muss jede Transaktion
    ein Konto be- und ein anderes um den gleichen Betrag entlasten.
  - Eingaben- / Ausgaben- Konten-Typen : Zusammen mit dem Doppel-
    Eintrag genutzt , fuehren sie zu sauberen Gewinn- & Verlust-
    Rechnungen, aber natuerlich dienen sie auch der einfachen 
    Kategorisierung ihrer Einnahmen und Ausgaben.  
  - Hauptbuch : Mehrere Konten koennen in einem Register darge-
    stellt werden um Tipp- oder Eingabefehler zu finden.Genauso 
    koennen Portfolios aus mehreren Aktien betrachtet werden, indem
    man alle Transaktionen in diesem Portfolio anzeigt.
  - Geschrieben in "C" mit eingebetteter Unterstuetzung von Scheme 
    durch "guile".
  - "Perl"-Unterstuetzung ist optinal moeglich fuer Skripting via SWIG.
  - Der Datei-Zugriff ist Netzwerk-sicher, das Beschaedigen von Dateien
    durch Zugriff mehrerer User auch ueber ein Netzwerk wird verhindert, 
    auch bei Zugriff ueber NFS.
  - Bietet ein Byte-Stream-Format, das den Transport von Konten
    und -gruppen an andere Prozesse via Sockets oder Pipes erlaubt.
  - Erlaubt das Aktualisieren von Aktien- und Fonds-Kursen ueber das
    Internet, auch automatisch.
  - Europaesiches Datum moeglich (xx.xx.xx), deutsche und franzoesische 
    Versionen moeglich.  

Home Page:
----------
http://gnucash.org


Ausf<EFBFBD>hren von GnuCash:
----------------------

Nur die Motif-Version von GnuCash funktioniert zur Zeit. Die Gnome Version
gibt einen Ueberblick ueber die Funktionen, aber die meisten funktionieren
nicht. Die qt-Version kann zur Zeit nicht uebersetzt werden, die meisten 
Funktionen fehlen. Weiter unten sind Hinweise fuer andere Betriebssysteme
als Linux/*BSD .

Um einige der Funktionen wie Berichte und Herunterladen von Aktienkursen 
nutzen zu koennen, muessen die folgenden Pakete installiert sein :
(Natuerlich zusaetzlich zu den Paketen, die benoetigt werden ,um GnuCash
kompilieren/uebersetzen zu koennen)
Hinweise zu "Uebersetzen und Installieren" weiter unten !
RPM's sind teilweise hier erhaeltlich :
http://rufus.w3.org/linux/

slib    -- scheme libraries fuerr guile.  Version slib2c0 oder hoeher .
perl    -- Fast jede Version von perl5 sollte funktionieren.  Ich habe perl-5.004 
eperl   -- Fast jede Version von eperl sollte funktionieren.  Ich habe eperl-2.2.14
  
Zusaetzlich werden zum Installieren einige Perl-Module benoetigt :

perl-LWP/libwww-perl-5.36
perl-HTML/HTML-0.6
perl-HTML/HTML-Parser-2.20
        -- Diese Perl Module werden benutzt um Aktien- und Fondskurse aus dem
           Internet zu laden.
           RPMS bei :
           ftp://ftp.gnucash.org/pub/gnucash/binaries/RPMS
           http://rufus.w3.org/linux/RPM/PByName.html
           http://linas.org/linux/xacc (last resort)
           oder Quelldateien bei :
           http://www.cpan.org/CPAN.html


Die Bin<69>rdistribution beinhaltet zwei Dateien: 'gnucash.bin' und
'gnucash-static.bin'. Erstere ben<65>tigt eine (kommerziell erh<72>ltliche)
Laufzeitbibliothek f<>r Motif; die zweite ist statisch mit Motif
gelinkt. Wenn Sie Motif installiert haben, starten sie einfach xacc;
wenn nicht m<>ssen sie erst 'gnucash-static.bin' auf 'gnucash.bin' kopieren.


Von der Kommandozeile wird das Programm mit 'gnucash' oder 'gnucash
<dateiname>' gestartet, wobei '<dateiname>' eine gnucash-Kontodatei
ist. Beispieldateien befinden sich im Unterverzeichnis 'data'. Dateien
mit der Endung '.dat' k<>nnen mit dem Men<65>eintrag 'Datei <20>ffnen'
geladen werden, Dateien mit der Endug '.qif' sind im Quicken Import
Format und werden mit dem Men<65>eintrag 'QIF Importieren' geladen.


<EFBFBD>bersetzung und Installation
----------------------------

Diese Schritte sind nur f<>r die Sourcedistribution erforderlich, nicht
f<EFBFBD>r die Bin<69>rdistribution.

Normalerweise wird GnuCash wie folgt <20>bersetzt und installiert:

  # ./configure
  # make
  # make install

Um deutsche oder franzoesische Versionen zu uebersetzen, oder das
europaeische Datumsformat zu aktivieren, muessen sie den Inhalt des
/include -Verzeichnis untersuchen und modifizieren.

"make install" fuehrt zu einer normalen FSSTND /usr/ oder /usr/local/
Installation bei der alles andere sich in /foo/gnucash/*-Verzeichnissen
verteilt. Alternativ koennen sie "make install-opt" nehmen, bei dem alles
in /opt/gnucash/bin, /opt/gnucash/doc ,usw. landet.

Die meistgebraeuchlichen Versionen waeren also :
Fuer eine normale System-Installation:
	
    ./configure --prefix=/usr --sysconfdir=/etc
    make motif
    make install

 Fuer eine /opt Installation :

    ./configure --prefix=/usr/local/opt/gnucash
    make motif
    make install-opt


Beispiele einiger weiterer Konfigurations-Optionen:
    configure --with-motif=/usr/local/opt/mootif \
              --prefix=/usr/local/opt/gnucash \
              --with-xmhtml-includes=/home/rlb/XmHTML-1.1.5/include\
              --with-xmhtml-libraries=/home/rlb/XmHTML-1.1.5/src


Runtime und Installations-Orte sind verschieden . Der --prefix
, den sie angeben legt fest, wo das lauffaehige Programm waehrend
der Laufzeit nach anderen Dingen sucht. Der prefix, den sie bei
make install angeben(z.B. make prefix=foo install) legt nur fest
wo die Dateien angelegt werden.Wenn das vom Konfigurations --prefix
abweicht, wird GnuCash nicht funktionieren, bis es zu diesem 
Verzeichnis verschoben wurde. Dieses Features ist fuer Leute von
Bedeutung , die daraus gleich fertige RPM's oder .deb-Pakete daraus
bauen wollen.

Nur der Ort von startup.scm ist fest in der ausfuehrbaren Datei drin,
und sogar das kann mit --startup-file in der Kommandozeile uebergangen
werden.Die anderen Einstellungen sind jetzt in startup.scm, path-defaults.h
gibt es nicht mehr. Das startup-file-Setting ist in gnucash.h, generiert 
von gnucash.h.in .


Quick translation table for financial terms:

English				German
account				Konto
reconcile an account		Konto ausgleichen
stock				Aktien
mutual funds			Aktienfonds 
assets				Haben/Aktiva 
debits				Verbindlichkeiten/Soll/Passiva
double entry			doppelte Buchf<68>hrung
general ledger			Hauptbuch


Unterstuetzte Betriebssysteme :
-------------------------------
GnuCash Version 1.2.x arbeitet unter folgenden Systemen :

Linux 2.x.x           -- Intel  
FreeBSD               -- Intel
OpenBSD               -- Intel



Download Sites:
---------------

ftp://ftp.gnucash.org/pub/

Weitere Download Sites:
-----------------------

IBM AIX 4.1.5 
      -- SMIT-installable images 
      http://www.bull.de/pub/
      see also http://www-frec.bull.com/

SCO OpenServer 5.0.4 
      http://www.sco.com/skunkware/osr5/x11/apps/xacc/VOLS.tar

Unixware 7
      -- nehmen sie pkgadd zum Installieren
      http://www.sco.com/skunkware/uw7/x11/apps/xacc/xacc.pkg.gz

SGI Irix
      -- im SGI install format
      -- Warnung, dies ist eine down-level Version !
      http://linas.org/linux/xacc/xacc-1.0b7-sgi-irix.inst.tar

Quellcode mit CVS:
------------------
Eine read-only (Nur-Lese) Version des CVS-Baums ist hier erhaeltlich :
Fuer den Zugriff erst wie folgt einloggen :

cvs -d :pserver:cvs@cvs.gnucash.org:/home/cvs/cvsroot login
Das Passwort ist "guest"

Um eine Kopie des Quellcodes aus dem gnucash-1.2 stable production 
Baum zu bekommen (stabile Version):

cvs -d :pserver:cvs@cvs.gnucash.org:/home/cvs/cvsroot checkout -P -rxacc-12-patch gnucash

Um eine Kopie des Quellcodes aus dem experimentellen Entwickler-Baum
zu bekommen (unstabile Version):

cvs -d :pserver:cvs@cvs.gnucash.org:/home/cvs/cvsroot checkout -P -rHEAD gnucash


Haupt-Entwickler:
-----------------

Robin Clark <rclark@hmc.edu> fuer das urspruengliche X-Accountant in
Motif , das als Schul-Pojekt begann, bis hin zur Version 0.9 im 
Oktober 1997.

Linas Vepstas <linas@lins.org> gefiel , was er sah : Die grafische Ober-
flaeche (GUI) was schlank, der Quellcode war dokumentiert und gut 
strukturiert, alles stand unter der GnuPublicLicense. Und so erweiterte er
alles und fuehrte es fort : hinzufuegen von Zellen zu XbaeMatrix, so dass die 
Combobox und die Pfeile eine noch schlankere GUI daraus machten, schrieb die
X-Accountant-"Innereien" neu, so dass Doppel-Eintraege, eine Konten-Hierarchie,
eine Mini-Transaktions-Maschine und Unterstuetzung fuer Aktien hinzukam, 
desweiteren brachte er die Help-Files auf Vordermann.
Soweit zur Version 1.0 im Januar 1998.
Seitdem wurden fuer die Version 1.1 die Maschine erweitert und verfeinert,
das Register-Fenster neu designed, und groesstenteils Motif- (und GUI-)
unabhanegig gemacht. Er hat auch OFX-Prototypen-Arbeit gemacht.

Jeremy Collins <jcollins@gnucash.org> hat das GnoMoney-Prjekt
weit und breit publiziert, und dann den Namen zu GnuCash geaendert.
Jeremy hat die gnucash.org-Webseite kreiert, die Domain registriert,
und den ersten GTK/Gnome-Code zum Laufen gebracht.

Rob Browning <rlb@cs.utexas.edu> hat jeden beschimpft, wenn er nicht
Perl benutzt hat, und dann doch guile/scheme -Unterstuetzung implementiert.   
Rob wartet die Uebersetzungs-Bereiche, und keummert sich um die ganze
guile/perl -Erweiterungssprachen-Sache, zuletzt ist die Konfiguration
und Konfigurierbarkeit auch seine Sache.

Dirk Schoenberger <schoenberger@signsoft.com> arbeitet an der Qt/KDE Version

Fixes & Patches:
----------------
Andrew Arensburger <arensb@cfar.umd.edu> for FreeBSD & other patches
Matt Armstrong <matt_armstrong@bigfoot.com> for misc fixes
Fred Baube <fred@moremagic.com> for attempted Java port/MoneyDance
Christopher B. Browne <cbbrowne@hex.net> for perl stock scripts
Graham Chapman <grahamc@zeta.org.au> for the xacc-rpts addon package
George Chen <georgec@sco.com> for MS-Money QIF's & fixes
Jeremey Collins <jcollins@gnucash.org> for GnoMoney & GTK port
Patrick Condron <pcondon@rackspace.com> for webserver and T1 connection.
Ciaran Deignan <Ciaran.Deignan@bull.net> for AIX binary version
Tyson Dowd   <tyson@tyse.net> for config/make patches & debian maint.
Koen D'Hondt <ripley@xs4all.nl> for Solaris patches to XmHTML
Bob Drzyzgula <bob@mostly.com> for budgeting design notes
Jan-Uwe Finck <ju_finck@mail.netwave.de> for German message translation    
Ron Forrester <rjf@aracnet.com> for gnome patches
Dave Freese <DFreese@osc.uscg.mil> for leap-year fix
Otto Hammersmith <otto@bug.redhat.com> for RedHat RPM version
Alexandru Harsanyi <haral@codec.ro> for misc core dumps & lockups.
Jon K}re Hellan <jk@isdn-a33.itea.ntnu.no> misc core dump fixes
Prakash Kailasa <PrakashK@bigfoot.com> for gnome build fixes
Tom Kludy <tkludy@csd.sgi.com> for SGI Irix port
Sven Kuenzler <sk@xgm.de> for SuSE README file
Ted Lemon <mellon@andare.fugue.com> for NetBSD port
Yannick Le Ny <y-le-ny@ifrance.com> pour la traduction en francais 
G. Allen Morris III  <gam3@ann.softgams.com> for QIF core dump 
Peter Norton <spacey@inch.com> for a valiant attempt at a GTK port
OmNiBuS <webmaster@obsidian.uia.net> web site graphics & content
Myroslav Opyr <mopyr@IPM.Lviv.UA> for misc patches
Alain Peyrat <Alain.Peyrat@nmu.alcatel.fr> for configure.in patches
Gavin Porter <maufk@csv.warwick.ac.uk> for euro style dates
Ron Record <rr@sco.com> for SCO Unixware & OpenServer binaries
Christopher Seawood <cls@seawood.org> for XbaeMatrix core dump
Mike Simons <msimons@fsimons01.erols.com> misc configure.in patches
Richard Skelton <rich@brake.demon.co.uk> for Solaris cleanup
Henning Spruth <spruth@bigfoot.com> for German text & euro date rework
Ken Yamaguchi <gooch@ic.EECS.Berkeley.EDU> QIF import fixes; MYM import

... and I am sure that I have missed many others ...


Stand : 29.07.99