###########################################
          GnuCash version  2.0.x
-------------------------------------------

#########
Sommaire:
---------

  - Vue d'ensemble
  - Mise � jour depuis la version 1.8.x
  - D�pendances
  - Mise en route
  - Internationalisation
  - Compilation et installation
  - plates-formes support�es
  - Sites de t�l�chargement miroirs
  - R�cup�rer les sources avec SVN
  - D�veloppement de GnuCash


##############
Vue d'ensemble
--------------

GnuCash est un gestionnaire de finances personnelles. Une interface graphique
d'enregistrement ressemblant au talon de votre ch�quier vous permet d'entrer et
de suivre vos comptes bancaires, actions, revenus et m�me vos op�rations
boursi�res. L'interface est con�ue pour �tre simple et facile � utiliser, mais
elle est adoss�e aux principes de comptabilit� de la partie double pour assurer
l'�quilibre des comptes.

Quelques une de ces caract�ristiques sont:

* Une interface facile � utiliser.  Si vous savez utiliser le talon de votre
ch�quier, vous savez utiliser GnuCash. Tapez directement dans le registre,
d�placez vous entre les champs, et utilisez quick-fill (saisie rapide) pour
compl�ter automatiquement la transaction. L'interface est personnalisable depuis
l'application elle-m�me (pas de fichiers de config � modifier :) ).
* Transactions r�currentes : GnuCash a la possibilit� de g�n�rer automatiquement
des transactions, de rappeler leur �ch�ance, de proposer de la valider ou de la
retarder et �galement de les supprimer apr�s un certain temps.
* Importation de fichiers OFX : GnuCash est le premier logiciel libre �
supporter le protocole � Open Financial Exchange � qui est de plus en plus
utilis� par les banques. Le d�veloppement du support OFX et HBCI a permis une
am�lioration du m�canisme permettant de retrouver des transactions homologues
et les doublons.
* Support de l'HBCI : GnuCash est le premier logiciel libre � supporter le
protocole allemand d'op�rations bancaires en ligne
* Importation de fichiers Quicken: Importation de fichiers au format QIF de
Quicken. Les fichiers QIF sont automatiquement fusionn�s pour �liminer les
transactions dupliqu�es.
* La fen�tre de rapprochement avec les soldes actuels rapproch�s et point�s rend
le rapprochement facile.
* Portefeuille d'actions/fonds de placements (SICAV et FCP en France): suivi
d'actions individuellement (une par compte) ou dans un portefeuille de comptes
(un groupe de comptes qui peuvent �tre affich�s ensemble).
* R�cup�ration des cours des actions et fonds communs (FCP et SICAV) depuis
diff�rents sites Web, mise � jour automatique du portefeuille.
* Rapports : affichent le bilan , les pertes et profits, �valuation du
portefeuille, rapports de transactions, ou suivi du solde du compte, ou
exportation de ceux-ci en HTML. Vous pouvez �crire votre propre rapport
personnalis� si vous connaissez un peu le langage Scheme. Les rapports peuvent
maintenant �tre r�alis�s sur une p�riode comptable.
* Monnaies/devises multiples et March� des changes : de multiple monnaies sont
support�es et peuvent �tre achet�es et vendues (faire du commerce avec elles).
Les mouvements mon�taires entre comptes sont totalement �quilibr�s quand la
partie double est activ�e. Les transferts en devises multiples sont support�s.
* Tableau de comptes : un compte ma�tre/principal peut avoir une arborescence
de comptes d�taill�s en dessous de lui. Cela permet d'avoir des types de
comptes similaires (par exemple Liquidit�s, Banque, Actions) group�s dans un
compte ma�tre (par exemple Avoirs).
* Transactions r�parties : une simple transaction peut �tre r�partie en
plusieurs morceaux pour enregistrer les imp�ts, paiements, et autres entr�es
compos�es.
* Partie double: Quand elle est activ�e, chaque transaction doit d�biter un
compte et cr�diter un autre d'un montant �quivalent. Cela permet de s'assurer
que les "livres sont �quilibr�s" : c'est � dire que la diff�rence entre les
revenus et les sorties est exactement �gale � la somme de tous les avoirs,
qu'ils soient bancaire, liquidit�s, actions ou autre.
* Types de comptes Revenus/D�penses (Cat�gories) : ils ne servent pas uniquement
� cat�goriser votre flux de liquidit�s/argent, mais quand ils sont utilis�s avec
la fonction de la partie double, ceux-ci peuvent fournir un �tat exact des
pertes et profits et donc du r�sultat de la p�riode.
* Extrait de compte/grand livre : de multiples comptes peuvent �tre affich�s
dans une fen�tre registre/d'enregistrement au m�me moment. Cela peut faciliter
l'ennui de la recherche/v�rification des erreurs de frappe/d'entr�e. Il fournit
aussi une mani�re agr�able de visualiser un portefeuille de beaucoup d'actions,
en montrant toutes les transactions dans ce portefeuille.
* �crit en C avec un support �tendu de Scheme via Guile.
* L'acc�s au fichier est verrouill� par un drapeau de s�curit� r�seau, pr�venant
des dommages accidentels si plusieurs utilisateurs essaient d'acc�der au m�me
fichier, m�me si le fichier est mont� par NFS.
* Fournit un format de flux de donn�es (byte-stream format), qui permet aux
comptes et groupes de comptes d'�tre transmis par d'autres processus via pipes
ou sockets.
* Chargement de la date au format europ�en, traductions diverses.
* Nouveau manuel utilisateur : une toute nouvelle aide en ligne a �t� �crite :
elle se focalise sur comment faire les actions en relation avec un tutoriel et
un guide des concepts.
* De nouveaux menus : les menus de GnuCash ont �t� revus pour se conformer aux
principes d'interface de Gnome.


Home Page:

https://www.gnucash.org/ (site officiel - version anglaise)

Binaires pr�compil�s / ex�cutables:
https://www.gnucash.org/pub/gnucash/

Versions de d�veloppement:
https://www.gnucash.org/en/hacking.phtml

###################################
Mise � jour depuis la version 1.8.x
-----------------------------------

Il y a beaucoup, beaucoup de changements depuis la s�rie 1.8 -
Jetez un coup d'oeil au fichier NEWS si vous voulez plus de d�tails.

- GnuCash n�cessite g-wrap version 1.3.4 ou sup�rieur. Consultez la section �
D�pendances � pour plus de d�tails.

- Les donn�es ne sont plus accessibles � partir de la version 1.6 une fois de
nouvelles fonctionnalit�s utilis�es : il n'y a pas de compatibilit�
descendante. Sauvegardez vos donn�es!!

- La documentation de GnuCash est d�sormais d�plac�e dans un package s�par�
(gnucash-docs). si vous voyez un message du type � URL non trouv�e �, en
cliquant un item du menu Aide, vous devrez installer la package gnucash-docs.

Nous esp�rons que vous vous appr�cierez toutes les nouvelles fonctionnalit�s!

############
D�pendances
------------

Les packages suivants sont requis et doivent �tre install�s pour faire
fonctionner GnuCash:

[Consultez le fichier README.dependencies]


#############
Mise en route
-------------

Pour les d�tails d'invocation/de lancement de GnuCash, regardez les pages de
man dans doc/gnucash.1.
Vous pouvez �galement taper gnucash --help sur la ligne de commande.

Vous pouvez d�marrer GnuCash en ligne de commande, avec � gnucash � ou � gnucash
<nom du fichier> �, o� <nom du fichier> est un fichier de donn�es de GnuCash.

Des exemples de comptes peuvent �tre trouv�s dans le sous-r�pertoire "data".
Les fichiers *.xac sont les comptes de GnuCash qui peuvent �tre ouverts avec
le menu � Fichier/Ouvrir �.
Les fichiers *.qif sont des fichiers au format Quicken qui peuvent �tre ouverts
par le menu � Fichier/Importer QIF �.

GnuCash r�pond aux variables d'environnement suivantes :

  GNC_BOOTSTRAP_SCM - l'emplacement du code scheme initial de bootstrapping.

  GUILE_LOAD_PATH - Pour surpasser le chemin de GnuCash utilis� pour le
  chargement de fichiers Scheme. C'est une variable de la m�me forme que les
  variables d'environnement PATH ou LIBRARY_PATH.

  GNC_MODULE_PATH - Pour surpasser le chemin de GnuCash utilis� pour le
  chargement de modules GnuCash. C'est une variable de la m�me forme que les
  variables d'environnement PATH ou LIBRARY_PATH.

  GNC_DEBUG - active la sortie de d�bogage. Cela vous permet d'activer
  le d�bogage dans le processus de d�marrageplus rapidement qu'avec l'option
  --debug.


###########################
Internationalisation (i18n)
---------------------------

Des traductions (fichiers .po) existent pour diff�rentes langues. Ceux-ci
sont activ�s avec les variables d'environnement. Par exemple,

En fran�ais, avec bash:
    export LANG=fr_FR

En fran�ais, avec tcsh:
    setenv LANG fr_FR

Pour la version allemande:
    export LANG=de_DE


###########################
Compilation et installation
---------------------------

[Pour plus de d�tails sur la compilation, lisez doc/README.build-system]

GnuCash utilise GNU Automake pour traiter le processus de compilation, donc
pour plus de d�tails, regardez les instructions g�n�rales dans INSTALL.

Ci-dessous nous d�taillons les parties sp�cifiques de GnuCash.


Avant de compiler GnuCash, vous devrez obtenir et installer les packages
suivants:

libtool : Disponible � ftp://ftp.gnu.org/gnu.
          Les RPMs et debs sont largement disponibles avec la plupart des
	     distributions.

syst�me de d�veloppement gnome: en-t�tes (headers), librairies, etc.

libxml:   disponible sur ftp.gnome.org

g-wrap  : Les RPM's, debs, et sources sont disponibles �
	     https://www.gnucash.org/pub/g-wrap.
	     vous devrez utilisez g-wrap 1.3.4 ou sup�rieur

texinfo: Si vous compilez depuis svn, vous avez besoin du package GNU texinfo,
	    version 4.0 ou ult�rieure.


Ce que vous aurez besoin de r�cup�rer et d'installer pour �tre s�r d'avoir
tous ces �l�ments correctement install�s d�pendra de votre syst�me
d'exploitation , mais ici se trouve une liste partielle de ce que vous aurez
besoin pour les syst�mes que nous connaissons:

  Debian/GNU/Linux: (cf README.dependencies)
    actuel:
      libgnome-dev
      libgtkhtml-dev
      guile1.4
      libguile9-dev
      libguile9-slib


GnuCash comprend quelques options non-standard de ./configure . Vous
devriez lancer � ./configure --help � pour la liste la plus � jour des options
support�es.

Si vous voulez seulement qu'une langue en particulier soit install�e, vous
pouvez d�finir la variable d'environnement LINGUAS avant de lancer ./configure.
Par exemple, pour installer seulement les traductions fran�aise, lancez

  $ export LINGUAS=fr
  $ ./configure

Si vous voulez �tre s�r que toutes les langues soit install�es, lancez

  $ unset LINGUAS
  $ ./configure

Bien que vous ayez besoin des librairies Gnome install�es, vous n'avez pas
besoin d'utiliser le bureau/interface Gnome.

Les chemins de lancement et d'installations sont s�par�es.  Le --prefix que vous
sp�cifiez � ./configure d�termine le chemin o� les ex�cutables chercheront des
fichiers � leur lancement. Normalement, cela d�termine o� � make install �
installera les fichiers. Cependant, automake supporte �galement des variables.
DESTDIR est utilis�e pendant le processus � make install � pour installer des
objets dans un r�pertoire tampon. Chaque objet et chemin est pr�fix� avec la
valeur de 'DESTDIR' avant d'�tre copi� dans les r�pertoires d'installation.

   make DESTDIR=/tmp/staging install

Cela place les objets d'installation dans une arborescence de r�pertoire
construit  sous `/tmp/staging'.
Si `/gnu/bin/foo' et /gnu/share/aclocal/foo.m4' doivent �tre install�s, la
commande ci-dessus installera `/tmp/staging/gnu/bin/foo' et
`/tmp/staging/gnu/share/aclocal/foo.m4'.

DESTDIR peut �tre utile quand on essaie de construire des images d'installation
et des packages.


########################
Plates-formes support�es
------------------------

La version 2.0.x de GnuCash est r�puter fonctionner sur les syst�mes
d'exploitation suivants:

GNU/Linux            -- x86, Sparc, Alpha
Solaris		      -- Sparc
FreeBSD              -- x86
OpenBSD              -- x86
MacOS X		      -- PPC

GnuCash peut probablement fonctionner avec la plupart des plateformes POSIX, si
les librairies et les outils sont disponibles.


###############################
Sites de t�l�chargement miroirs
-------------------------------

Vous pouvez aussi t�l�charger GnuCash � partir de:

  - https://download.sourceforge.net/gnucash

Vous pouvez r�cup�rer les packages Mandriva de GnuCash sur les sites Cooker de
Mandriva ou dans les derni�res versions de la distribution)


#####################################
R�cup�rer les sources avec git
-------------------------------------

Une version en lecture seule de l'arborescence git est disponible �
cette adresse :

	https://github.com/Gnucash/gnucash/


########################
D�veloppement de GnuCash
------------------------
Avant de d�marrer � d�velopper sur GnuCash, vous devriez faire les choses
suivantes:

1. lisez le fichier src/doc/coding-style.txt pour apprendre les styles
   de codage utilis�s dans le code source de GnuCash. Lisez �galement
   https://wiki.gnucash.org/wiki/Development

2. Plusieurs des r�pertoires sous src contiennent des fichiers appell�s
   design.txt qui expliquent beaucoup des aspects de la conception de GnuCash.
   Lisez les.

3. Allez sur le site web de GnuCash et survoler les archives de la liste de
   diffusion du d�veloppement de GnuCash (gnucash-devel).

   4. Rejoignez la liste de diffusion de d�veloppement de GnuCash
   (gnucash-devel). Regardez le site web de GnuCash pour des d�tails sur la
   m�thode pour y parvenir.


Soumettre un patch

Lisez SVP le fichier README sur les m�thodes utilis�es pour transmettre un
patch � l'�quipe de d�veloppement de GnuCash.

Merci,
