gnucash/doc/README.francais

#######################################################################
          Fichier README de Gnucash 1.5.x .

NOTE: C'EST UNE VERSION DE DEVELOPPEMENT!!! CETTE VERSION N'A PAS
ETE TESTEE CORRECTEMENT ET PEUT FAIRE ABSOLUMENT N'IMPORTE QUOI!  

UTILISEZ LA A VOS PROPRES RISQUES (ET FAITES *BEAUCOUP* DE SAUVEGARDES)

Si vous voulez quelque chose de plus test<73>, s'il vous pla<6C>t utilisez
les series stables 1.4.
-----------------------------------------------------------------------

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

  - Vue d'ensemble
  - Mise <20> jour depuis la version 1.2.x
  - D<>pendences
  - Mise en route
  - Internationalisation
  - Compilation et installation
  - OS support<72>s
  - Sites additionnels de t<>l<EFBFBD>chargement
  - R<>cup<75>rer les sources avec CVS
  - 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<63>quier
vous permet d'entrer et de suivre vos comptes bancaires,actions,
revenus et m<>me les march<63>s des changes.  L'interface est con<6F>u pour
<EFBFBD>tre simple et facile <20> utiliser, mais elle est adoss<73>e <20>
des principes de comptabilit<69> de la partie double pour
s'assurer que les livres sont <20>quilibr<62>s.

Quelques une de ces caract<63>ristiques sont:

  - Une interface facile <20> utiliser.  Si vous savez utiliser
    le talon de votre ch<63>quier, vous savez utiliser GnuCash.
    Tapez directement dans le registre,
    d<>placez vous entre les champs, et utilisez quick-fill
    (saisie rapide) pour compl<70>ter automatiquement la transaction.
    L'interface est personalisable depuis l'application elle-m<>me
    (pas de fichiers de config <20> modifier :) ).
  - Importation de fichiers Quicken: Importation de fichiers au format
    QIF de Quicken.
    Les fichiers QIF sont automatiquement fusionn<6E>s pour <20>liminer
    les transactions dupliqu<71>es
  - La fen<65>tre de rapprochement avec soldes actuels rapproch<63>s et
    point<6E>s rend le rapprochement facile.
  - Potefeuille 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
    <20>tre affich<63> ensemble).
  - R<>cup<75>re les cours des actions et fonds communs (FCP et SICAV) depuis
    diff<66>rents sites web, met <20> jour automatiquement le porte-feuille
    (plus de fonds <20>tant ajouter r<>guli<6C>rement).
  - Rapports: Affichent la feuille bilan , pertes et profits, <20>valuation du
    portefeuille, rapports de transactions, ou suivi du solde du compte,
    ou exportation de ceux-ci en HTML. Vous pouvez <20>crire votre propre
    rapport personalis<69> si vous connaissez un peu Scheme. Les rapports
    peuvent maintenant <20>tre r<>alis<69>s sur une p<>riode comptable!
  - Monnaies/devises multiples et March<63> des changes:
    De multiple monnaies sont support<72>es et peuvent <20>tre achet<65>es
    et vendus(faire du commerce avec elles). Les mouvements mon<6F>taires
    entre comptes sont totallement <20>quilibr<62>s quand la partie double
    est activ<69>e.
    (Quelques aspects du support de multiples monnaies ne sont pas 
    totallement impl<70>ment<6E>s.
  - Tableau de comptes: Un compte maitre/principal peut avoir une arborescence
    de comptes d<>taill<6C>s en desssous de lui. Cel<65> permet d'avoir des types de
    comptes similaires (par exemple Liquidit<69>s, Banque, Actions)
    group<75>s dans un compte maitre (par exemple Avoirs).
  - Transactions r<>parties: Une simple transaction peut <20>tre r<>partie
    en plusieurs morceaux pour enregistrer les imp<6D>ts, paiements, et
    autres entr<74>es compos<6F>es.
  - Partie double: Quand elle est activ<69>, chaque transaction
    doit d<>biter un compte et cr<63>diter un autre d'un montant <20>quivalent.
    Cel<65> permet de s'assurer que les "livres sont <20>quilibr<62>s":
    c'est <20> dire que la diff<66>rence entre les revenus et les sorties est
    exactement <20>gale <20> la somme de tous les avoirs, qu'ils soit bancaire, 
    liquidit<69>s, actions ou autre.
  - Types de comptes Revenus/D<>penses (Cat<61>gories):  
    Ils ne servent pas uniquement <20> cat<61>goriser votre flux
    de liquidit<69>s/argent, mais quand ils sont utilis<69>s avec la fonction de
    la partie double, ceux-ci peuvent fournir un <20>tat exact des pertes et
    profits et donc du r<>sultat de la p<>riode.
  - Extrait de compte/grand livre: De multiples comptes peuvent <20>tre affich<63>s
     dans une fen<65>tre registre/d'enregistrement au m<>me moment. Cel<65> peut
    faciliter l'ennui de la recherche/v<>rification des erreurs de
    frappe/d'entr<74>e.
    Il fournit aussi une mani<6E>re agr<67>able de visualiser un porte-feuille de
    beaucoup d'actions, en montrant toutes les transactions dans ce
    portefeuille.
  - Ecrit en C avec un support <20>tendu de scheme via Guile.
  - Le support de Perl est disponible en option pour les scripts fonctionnant
    via SWIG.
  - L'acc<63>s au fichier est verrouill<6C> par un drapeau de s<>curit<69> r<>seau,
    pr<70>venant des dommages accidentels si plusieurs utilisateurs essaient
    d'acc<63>der au m<>me fichier, m<>me si le fichier est mont<6E> par NFS.
  - Fournit un format de flux de donn<6E>es(byte-stream format), qui permet aux
    comptes et groupes de comptes d'<27>tre transmi par d'autres processus
    via pipes ou sockets.
  - Chargement de la date au format europ<6F>en, traductions fran<61>aise,
    anglaise, allemande et su<73>doise.


Home Page:

http://gnucash.org/ (site officiel - version anglaise)
http://www.multimania.com/yleny/gnucash (version fran<61>aise)

Binaires pr<70>compil<69>s / ex<65>cutables:
http://www.gnucash.org/pub/gnucash/

Versions de d<>veloppement:
http://www.gnucash.org/source_code.php3


###################################
Mise <20> jour depuis la version 1.2.x
-----------------------------------

Il y a beaucoup, beaucoup de changements depuis la serie 1.2 - 
donnez un coup d'oeil au fichier NEWS si vous voulez plus de d<>tails.
Toutefois, le plus important pour l'installation est que GnuCash
maintenant requiert les librairies Gnome <20> la place de Motif, et guile
est requis.  Regardez la section "d<>pendances" de ce fichier pour plus
de d<>tails. Le format de fichier n'a pas chang<6E>
(mais faites une sauvegarde de vos donn<6E>es de toute fa<66>on . . . )

Nous esp<73>rons que vous vous amuserez avec toutes les nouvelles fonctionnalit<69>s!

############
D<EFBFBD>pendences
------------

Les packages suivants sont requis et doivent <20>tre install<6C> pour faire
fonctionner gnucash: 

guile   -- Fournit l'infrastructure du langage d'extension principal.
           Il est utilis<69> intensivement par gnucash pour l'initialisation
           et le d<>marrage.
           Requiert la version 1.3 ou ult<6C>rieure/plus r<>cente.
           Le rpm guile-1.3-7 fonctionne.

slib    -- librairies scheme pour guile. A besoin de slib2c4 ou ult<6C>rieure.

libpng  -- librairie PNG(portable network graphics). N'importe quelle version.

libjpeg -- librairie de chargement d'image JPEG. N'importe quelle version.

libz    -- librairie de compression. N'importe quelle version.

xpm     -- extension Pixmap pour X. N'importe quelle version.

gnome-libs: la version 1.0.40 ou ult<6C>rieure/plus r<>cente devrait fonctionner.
            Ces librairies requi<75>rent des librairies supportant de nombreuses
	      autres, tel que gtk et glib.

gnome-print: N'importe quelle version r<>cente devrait fonctionner.

gdk-pixbuf: N'importe quelle version devrait fonctionner.

gtkhtml:   La version 0.4 ou ult<6C>rieure/plus r<>cente devrait fonctionner.
             Vous pouvez obtenir la derni<6E>re version de gtkhtml depuis
	 Helix Code. (voir site ftp Gnome: ftp.gnome.org)
	 Noter que cel<65> <20> chang<6E> depuis la 1.4, qui utilisait la vieille
	librairie gtkxmhtml.
            Pour compiler les sources de GtkHTML-0.4, il faut gdk-pixbuf 0.7.0
	(ou ult<6C>rieure), Bonobo 0.15 (ou ult<6C>rieure) et gnome-print 0.16
	(ou ult<6C>rieure).

Pour avoir la possibilit<69> d'utiliser certaines fonctionnalit<69>es de GnuCash,
tel que les rapports et les t<>l<EFBFBD>chargements de cours d'actions par le r<>seau,
vous devez avoir les packages suivant ci-dessous install<6C>s
(en plus de ceux list<73>s ci-dessus).

Les RPM pour la plupart de ceux-ci peuvent <20>tre trouv<75>s <20>
  http://rufus.w3.org/linux/

perl    -- A peu pr<70>s n'importe quelle version de perl5 devrait fonctionner.
           J'utilise perl-5.004 

En plus, quelques modules perl ont besoin d'<27>tre install<6C>s:

perl-LWP/libwww-perl-5.36
perl-HTML/HTML-0.6
perl-HTML/HTML-Parser-2.20
        -- ces modules perl sont utilis<69>s pour r<>cup<75>rer les cours des
           actions et fonds de placements <20> partir d'internet. Vous pouvez
	     r<>cup<75>rer ces RPMS <20>:
           ftp://ftp.gnucash.org/pub/gnucash/binaries/RPMS
           http://rufus.w3.org/linux/RPM/PByName.html
           http://linas.org/linux/gnucash (en dernier recours)
           ou les sources <20>
           http://www.cpan.org/CPAN.html

 Si vous souhaitez utiliser le rapport de suivi du solde et avoir de superbes
 graphiques,
 vous aurez besoin d'installer:

   gnuplot:  Un programme de dessin.
	       Les RPM et debs sont disponible depuis les distributeurs
	       Vous pouvez r<>cup<75>rer les sources depuis:
             http://www.gnuplot.vt.edu/ 

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

Pour les d<>tails d'invocation/de lancement de GnuCash, regardez les pages de
man dans doc/gnucash.1.
Bient<EFBFBD>t, nous aurons aussi la possibilit<69> de lancer gnucash --help, mais ce
n'est pas encore fini ...

Vous pouvez d<>marrer GnuCash en ligne de commande, avec "gnucash" ou "gnucash
<nom du fichier>", o<> <nom du fichier> est un fichier de compte de GnuCash.
Des exemples de comptes peuvent <20>tre trouv<75> dans le sous-r<>pertoire "data".
les fichiers *.dat sont les comptes de GnuCash qui peuvent <20>tre ouvert avec
l'entr<74>e du menu "Ouvrir fichier". Les fichiers *.qif sont des fichiers 
au format d'importation Quicken qui peuvent <20>tre ouvert avec l'entr<74>e du menu
"Importer QIF".

GnuCash r<>pond aux variables d'environnement suivantes:

  GNC_RUN_AS_SHELL - si activ<69>, permet <20> GnuCash de s'ouvrir dans un shell
  guile avec toutes les fonctions de gnucash charg<72>es. Depuis l<>, vous pouvez
  r<>cup<75>rer comportement du d<>marrage normal comme ceci:

    GNC_RUN_AS_SHELL=t ./gnucash
    guile> (primitive-load (getenv "GNC_BOOTSTRAP_SCM"))
    guile> (gnc:load "startup.scm")
    guile> (gnc:main)

  C'est la m<>me chose qui se passe si vous n'utilisez pas cette variable
  d'environnement. Cel<65> peut <20>tre utile quand vous essayez d'<27>crire et tester
  de nouveaux fichiers .scm.

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

  GNC_SCM_LOAD_PATH - une contrainte pour le chemin de chargement de scheme
  pour GnuCash.Il devrait <20>tre une chaine repr<70>sentant une liste scheme
  appropri<72>e. Chaque <20>l<EFBFBD>ment peut soit <20>tre une chaine repr<70>sentant un
  r<>pertoire, soit le symbole par d<>faut qui s'<27>tendra au chemin par d<>faut,
  ou l'actuel qui s'<27>tendra au chemin de chargement par d<>faut au moment o<>
  il rencontre le symbole.

  GNC_DEBUG - active la sortie de d<>bogage. Cel<65> vous permet d'activer
  le d<>bogage pr<70>c<EFBFBD>dent dans le processus de d<>marrage que vous pouvez faire
  avec --debug.

Comme exemple, voici un script d'encapsulation (wrapper script) que nous
utilisons pour vous permettre d'utiliser de lancer gnucash depuis le r<>pertoire
local:

  #! /bin/sh

  export G
  
  NC_BOOTSTRAP_SCM=./share/scm/bootstrap.scm
  export GNC_SCM_LOAD_PATH='("./share/scm")'
  export GNC_DEBUG=t

  # Run whichever one was built last.
  exec ./src/gnucash \
    --debug \
    --share-dir ./share \
    --config-dir ./etc \
    --doc-path '("./doc/html/C")' \
    "$@"


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

Des catalogues de messages existent pour le fran<61>ais et l'allemand. Ceux-ci
sont activ<69>s avec les variables d'environnement. Par example, 

En fran<61>ais, avec bash:
    export LANG=fr_FR
    
En fran<61>ais, avec tcsh:
    setenv LANG fr_FR
    
Pour la version allemande:
    export LANG=de_DE
    

Les autres locales qui devrait pour la plupart fonctionner, mais sont
toujours en d<>veloppement:

en_US
en_GB
fr_CH
de_CH

(Gnucash utilise gettext maintenant, alors il faut utiliser
les fichiers *.po , le traduire et le compiler par msgfmt.
exemple: msgfmt fr.po --output=./gnucash.mo en ligne de commande
dans /gnucash/po pour le fichier pour la france et copier gnucash.mo sur une
redhat 6.1 GPL dans /usr/share/locale/fr/LC_MESSAGES et vous aurez vos menus
et messages en fran<61>ais.)


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

Ces <20>tapes ne s'applique pas aux distributions de binaires; uniquement aux
distributions de sources.

Pour plus de d<>tails sur le syst<73>me de compilation, regardez
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<EFBFBD>rales dans INSTALL.
(Notez que, pour avoir un ./configure fonctionnant, vous devrez lancer 
./autogen.sh.)
Ci-dessous nous d<>taillons les parties sp<73>cifiques de Gnucash.
  

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

libtool :  Utiliser pour compiler nos versions internes de g-wrap qui charge
           nos encapsuleurs C avec guile.
           Disponible <20> ftp://ftp.gnu.org/gnu.
           Les RPMs et debs sont largement disponible avec la plupart des
	     distributions.

SWIG    : Utilis<69> pour autog<6F>n<EFBFBD>rer les encapsuleurs perl.
           Disponible <20> www.swig.org
           n<>cessite 1.1p5 ou ult<6C>rieure ...

syst<EFBFBD>me de d<>veloppement gnome: en-t<>tes (headers), librairies, etc.
ibxml: disponible sur ftp.gnome.org

g-wrap  : Les RPM's, debs, et sources sont disponibles <20>
	ftp://ftp.gnucash.org/pub/g-wrap.
	Si vous utilisez guile version 1.4 ou ult<6C>rieure, vous avez besoin de
	g-wrap 0.9.5 ou ult<6C>rieure. Si vous utilisez une pr<70>c<EFBFBD>dente version
	de guile, vous devrez utilisez g-wrap 0.9.4.

  texinfo: Si vous compilez le CVS, vous avez besoin du package GNU texinfo,
	version 4.0 ou ult<6C>rieure.

  docbook: Pour compiler le manuel en ligne, vous aurez besoin des outils
	docbook,  incluant jade et les feuillles de style (stylesheets) de docbook .

	
Ce que vous aurez besoin de r<>cup<75>rer et d'installer dans l'ordre pour <20>tre
s<EFBFBD>r que vous ayez tous ces <20>l<EFBFBD>ments corectement install<6C>s pour votre
syst<EFBFBD>me d'exploitation favorit en particulier variera, mais ici se trouve au
moins une liste partielle de ce que vous aurez besoin pour les syst<73>mes
que nous connaissons:

  Debian/GNU/Linux:
    actuel:
      libgnome-dev
      libgtkhtml-dev (vous pouvez le r<>cup<75>rer depuis Helixcode, il n'est pas  
      dans la Debian)
      guile1.3
      libguile6-dev
      libguile6-slib

  RedHat:
    ???

GnuCash comprend quelques options de ./configure non-standard. Vous
devriez lancer ./configure --help pour le r<>sum<75> le plus <20> jour des options
support<EFBFBD>es, mais ici se trouvent quelques descriptions s<>taill<6C>es de
quelques-unes d'entre elles:

  --enable-opt-style-install

    Gnucash supporte deux types d'installation, la premi<6D>re est le style normal
    /usr ou /usr/local/ , o<> les fichiers sont install<6C>s dans
    /usr/bin /usr/lib, etc.  Cel<65> se fait par d<>faut.

    Le second style est le FSSTND, l'installation de style opt. Dans ce style,
    tous les fichiers sont install<6C>s sous un sous-r<>pertoire commun,souvent
    dans /usr/local/opt, avec les ex<65>cutables allant dans
    /usr/local/opt/foo/bin, les librairies allant dans /usr/local/opt/foo/lib,
    etc.  Pour demander ce style d'installation, utilisez uniquement l'option 
    --enable-opt-style-install de ./configure.

Si seulement vous voulez q'une langue en particulier soit install<6C>e, vous
pouvez mettre la variable d'environnement LINGUAS avant de lancer configure.
Par exemple, pour installer seulement les traductions fran<61>aise, lancez

  $ export LINGUAS=fr
  $ ./configure

Si vous voulez <20>tre s<>r que toutes les langues soit install<6C>es, lancez

  $ unset LINGUAS
  $ ./configure

La derni<6E>re version 1.2 stable de GnuCash avait une interface utilisateur bas<61>e
sur Motif, et il y avait aussi un exp<78>rimental, mais jamais termin<69> interface
en QT.
L'ensemble de ceux-ci ont <20>t<EFBFBD> enlev<65> de l'arborescence des sources durant le
processus de migration vers automake, mais quelqu'un qui est int<6E>ress<73> par la
resurrection de ces parties peut facilement les retrouver dans le CVS.
Notez que  tandis que vous avez besoin des librairies Gnome install<6C>es, vous 
n'avez pas besoin d'avoir le bureau/interface Gnome.  

Les destinations de lancement et d'installations sont s<>par<61>es.  Le --prefix
que vous sp<73>cifiez <20> configure d<>termine o<> les ex<65>cutables r<>sultant seront
regard<EFBFBD> pour des choses au lancement.  Normallement cel<65> d<>termine o<> un 
"make install" mettra tous les fichiers.  Toutefois, automake aussi supporte la
variable.  DESTDIR est utilis<69> durant l'<27>tape `make install' pour relocaliser
les objets d'installation dans un endroit pr<70>dispos<6F>.  Chaque objet et chemin
est pr<70>fix<69> avec la valeur de `DESTDIR' avant d'<27>tre copi<70> dans l'endroit
d'installation.
Voici un exemple d'usage typique de DESTDIR:

     make DESTDIR=/tmp/staging install

   Cel<65> 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' sont <20> <20>tre install<6C>s,
   la commande ci-dessous devrait installer 
`/tmp/staging/gnu/bin/foo' et `/tmp/staging/gnu/share/aclocal/foo.m4'.

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


###############
Os support<72>s  :
---------------
La version 1.5.X de GnuCash est connu pour fonctionner sur les syst<73>mes
d'exploitation suivants:

GNU/Linux             -- x86, Sparc, Alpha
Solaris		      -- Sparc
FreeBSD               -- x86
OpenBSD               -- x86

Les pr<70>c<EFBFBD>dente versions sont  connu pour fonctionner sur les
plateformes suivantes, mais leurs <20>tats actuels sont inconnus:

SGI IRIX              -- MIPS 
IBM AIX 4.1.5         -- RS/6000   http://www-frec.bull.com/
Unixware 7            -- Intel
SCO OpenServer 5.0.4  -- Intel

regardez <20> ftp://ftp.gnucash.org/pub/xacc (grande-bande passante)
ou  http://linas.org/linux/gnucash (slow-www ) 
pour les binaires pr<70>compil<69>s ( mais *tr<74>s vieilles*) pour ces plateformes.

Gnucash peut probablement <20>tre fait pour fonctionner avec la plupart des
plateformes POSIX, si les les librairies fournies et les outils sont 
disponibles.

#####################################
Sites additionnels de t<>l<EFBFBD>chargement:
-------------------------------------

Vous pouvez aussi t<>l<EFBFBD>charger gnucash <20> partir de:

  - http://download.sourceforge.net/gnucash
  - ftp://ftp.krondo.com

Vous pouvez t<>l<EFBFBD>charger les packages Solaris de GnuCash <20> partir de:

  - http://www.unixrealm.com/downloads/

Vous pouvez r<>cup<75>rer les packages Mandrake de GnuCash sur les sites Cooker de 
Mandrake.

Les binaires pr<70>compil<69>s et les packages pr<70>-requis peuvent <20>tre trouv<75> sur
les sites suivants.Les versions de Gnucash ici sont toutes *extr<74>mement*
vieilles, et sont en fait de l'anc<6E>tre de gnucash : "x-accountant ou xacc".

IBM AIX 4.1.5 
      -- SMIT-installable images
      -- warning, this is from the 1.0 series of xacc
      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
      -- warning, this is from the 1.0 series of xacc


Unixware 7
      -- use pkgadd to install
      http://www.sco.com/skunkware/uw7/x11/apps/xacc/xacc.pkg.gz

SGI Irix
      -- in SGI install format
      -- warning, this is a very down-level version
      http://linas.org/linux/xacc/xacc-1.0b7-sgi-irix.inst.tar

###############################
R<EFBFBD>cup<EFBFBD>rer les sources avec CVS
-------------------------------

Une version en lecture-seule de l'arborescence de cvs tree est disponible
sur le net.
Pour y acc<63>der, premi<6D>rement, loggger vous, comme ceci:

 cvs -d :pserver:cvs@cvs.gnucash.org:/home/cvs/cvsroot login

Le mot de passe (password)est "guest"

Pour r<>cup<75>rer une copie des sources dans l'arborescence de d<>velopppement
exp<EFBFBD>rimental faites un

cvs -z3 -d :pserver:cvs@cvs.gnucash.org:/home/cvs/cvsroot checkout -r HEAD 
gnucash

Pour r<>cup<75>rer une copie des sources de l'arborescence de la version de
production stable gnucash-1.4, faites un

cvs -z3 -d :pserver:cvs@cvs.gnucash.org:/home/cvs/cvsroot checkout -r
gnucash-1-4-branch gnucash

########################
D<EFBFBD>veloppement de GnuCash
------------------------
Avant de d<>marrer <20> d<>velopper sur GnuCash, vous devriez faire les choses
suivantes:

1. lisez le fichier src/coding-style.txt pour apprendre les styles
   de codage utilis<69>s dans le code source de GnuCash.

2. Plusieurs des r<>pertoires sous src contiennent des fichiers appell<6C>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
   courriers de d<>veloppement de gnucash(development mailing list).

4. Rejoignez la liste de courriers de d<>veloppement de gnucash(development
   mailing list).
   Regardez le site web de gnucash pour des d<>tails sur comment faire cel<65>.


Soumettre un patch

D<EFBFBD>s que vous avez fait un certain travail que vous aimeriez soumettre, vous
avez besoin d'envoyer un patch. Il y a un script perl appel<65> make-gnucash-patch
fourni avec la distribution que vous pouvez utiliser pour cr<63>er le patch.
Ici, se trouve comment utiliser ce script perl.

Premi<EFBFBD>rement, configurer vos r<>pertoires de d<>veloppement comme ce qui suit:

< R<>pertoire de d<>veloppement maison (home) de GnuCash >
    |
    |---- < r<>pertoire contenant les sources originales de GnuCash >
    |
    |---- < r<>pertoire contenant vos sources modifi<66>es de GnuCash >

Un exemple concret de ces r<>pertoires devrait <20>tre:

/home/me/gnucash
    |
    |---- /home/me/gnucash/gnucash.pristine (sources originales)
    |
    |---- /home/me/gnucash/gnucash.mywork (sources originales + mes modifs)

Copier le script make-gnucash-patch vers le r<>pertoire de d<>veloppement maison
(/home/me/gnucash au-dessus). Maintenant metter les trois variables en haut
de ce fichier pour refl<66>ter les noms de vos r<>pertoires. Les noms donn<6E>s
ci-dessous, vous devriez les utiliser

  export GNC_MAKEPATCH_OLD_DIR=gnucash.pristine
  export GNC_MAKEPATCH_NEW_DIR=gnucash.mywork
  export GNC_MAKEPATCH_HOME_DIR=/home/me/gnucash

Bien s<>r avant de faire votre, soyez s<>r *qu'ensemble* votre r<>pertoire de
travail et votre r<>pertoire pristine sont synchroniser avec le cvs.
Lancez 'cvs -z3 update -dP' dans l'ensemble des r<>pertoires pour vous assurer
que c'est le cas.
La mise <20> jour depuis le cvs dans votre r<>pertoire de travail
peut causer les conflits dans un fichier.
Vous devez r<>soudre ces conflits avant de faire un patch.


Maintenant lancer le script. Notez que le script requiert les programmes
'makepatch', 'gzip', 'diff', et 'uuencode' (et, bien s<>r , 'perl')
pour fonctionner. 

Quand vous lancez le script, trois fichiers seront g<>n<EFBFBD>r<EFBFBD>s:

  gnc.diff - Ce fichier est un fichier texte ascii contenant les diff<66>rences
             entre les sources originales et vos modifications. En bas de ce
             fichier se trouve une liste de fichiers qui sont ajout<75>s,
             chang<6E>s, ou supprim<69>s.

             S'il vous plait examinez ce fichier (sp<73>ciallement la liste en 
bas)
             pour <20>tre s<>r que tous vos changements (et pas d'autres 
changements)
             sont pr<70>sent dans le fichier.

             Ne pas soumettre ce fichier!

  gnucash.diff.gz - C'est une version gzipp<70> du fichier au-dessus.

                    Ne pas soumettre ce fichier!

  gnucash.diff.gz.uue - C'est une version uuencod<6F>e (ascii-encod<6F>) 
                        du fichier au-dessus.

                        C'est le fichier <20> soumettre.

Envoyez gnucash.diff.gz.uue <20> gnucash-patches@gnucash.org

Merci par avance pour votre contribution!


Traduction faite le 12/11/00 par Yannick LE NY
Cette traduction n'est peut-etre plus <20> jour,
donc r<>f<EFBFBD>rez vous au fichier README en anglais.
Pour toutes remarques ou suggestions:
y-le-ny@ifrance.com

Local Variables:
mode: text
End: