<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kcalc "<application>kcalc</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
]>
<book lang="fr">
<bookinfo>
<title>Le manuel de KCalc</title>
<authorgroup>
<author>
<firstname>Bernd Johannes</firstname>
<surname>Wuebben</surname>
<affiliation><address><email><ulink url="mailto:wuebben@kde.org">wuebben@kde.org</ulink></email></address></affiliation>
</author>
</authorgroup>
<date>Version 0.4, 20 septembre 1997</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<abstract>
<para>Ce manuel décrit KCalc Version 0.4</para>
<para>Le manuel de KCalc</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>KCalc</keyword>
<keyword>calculatrice</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>Ceci est la version 0.4 de KCalc. KCalc est une calculatrice scientifique pour le projet KDE simple mais
espérons-le utile. </para>

<para>KCalc offre bien plus de fonctions mathématiques qu'il n'y paraît à première vue. Veuillez étudier la
section sur les accélérateurs clavier et sur les modes dans ce manuel pour en apprendre plus en ce qui
concerne les nombreuses fonctions disponibles.</para>

<para>En plus des fonctionnalités habituelles offertes par la plupart des calculatrices scientifiques, KCalc offre
un grand nombre de possibilités qui sont d'après moi dignes d'être soulignées 
: </para>

<para><itemizedlist>
<listitem>
<para>KCalc dispose d'un mode trigonométrique et d'un mode statistique ;</para>
</listitem>
<listitem>
<para>KCalc permet de couper-coller des nombres depuis et vers son affichage ;</para>
</listitem>
<listitem>
<para>KCalc possède une 'pile de résultats' qui vous permet de rappeler 
commodément des résultats antérieurs ;</para>
</listitem>
<listitem>
<para>Vous pouvez régler la couleur et la police de l'affichage de KCalc ;</para>
</listitem>
<listitem>
<para>Vous pouvez régler la précision et le nombre de chiffres après la 
virgule de KCalc ; </para>
</listitem>
<listitem>
<para>KCalc offre un grand nombre de raccourcis clavier qui 
rendent facile son usage sans périphérique de pointage. </para>
</listitem>
</itemizedlist>
</para>

<para>Nous vous souhaitons de profiter de KCalc !</para>

<para><literal remap="tt">Bernd Johannes Wuebben</literal></para>

<para><ulink url="mailto:wuebben@math.cornell.edu">wuebben@math.cornell.edu</ulink></para>
</chapter>

<chapter id="installation">
<title>Installation</title>

<sect1 id="comment-obtenir-kcalc">
<title>Comment obtenir KCalc</title>

<para>KCalc fait partie du projet KDE <ulink url="http://www.kde.org">http://www.kde.org</ulink>.
KCalc peut être trouvé sur <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, le site ftp principal du projet KDE.
Sa page web est <ulink url="http://math.cornell.edu/~wuebben/kde.html">http://math.cornell.edu/~wuebben/kde.html</ulink></para>
</sect1>

<sect1 id="configuration-ncessaire">
<title>Configuration nécessaire</title>

<para>Pour compiler avec succès KCalc, vous avez besoin des versions les plus récentes de <literal remap="tt">libkdecore</literal>
et de <literal remap="tt">libkdeui</literal>. Toutes les librairies nécessaires aussi bien que KCalc lui-même peuvent être trouvés
sur <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>. </para>
</sect1>

<sect1 id="compilation-et-installation">
<title>Compilation et installation</title>

<para>La séquence habituelle :</para>

<para><screen>% ./configure
% make
% make install
</screen>
</para>

<para><emphasis remap="bf">IMPORTANT :</emphasis> </para>

<para><emphasis remap="bf">Comment permettre la précision 'long double' pour KCalc :</emphasis></para>

<para>Si votre machine supporte le type de données C 'long double' et si vous avez une librairie libc en état de
marche vous pouvez mettre en place la précision 'long double' pour KCalc.</para>

<para>(Les utilisateurs de RedHat 5.0 sont malchanceux. Je suggère que vous vous 
trouviez une distribution   ouverte sur KDE qui ait une libc fonctionnelle)</para>

<para>Voici la marche à suivre :</para>

<para><orderedlist><listitem>
<para>Vérifiez ../config.h et vérifiez si HAVE&lowbar;LONG&lowbar;DOUBLE est défini, c'est-à-dire que vous devriez trouver
une ligne disant :

<screen>#define HAVE_LONG_DOUBLE 1
</screen>


Si cette ligne n'existe pas c'est que votre système ne supporte pas la précision IEEE long
double.
</para>
</listitem>
<listitem>
<para>Editez les fichiers KCalctype.h configdlg.cpp KCalc.cpp et 
KCalc&lowbar;core.cpp supprimez les lignes.

<screen>#ifdef HAVE_LONG_DOUBLE
#undef HAVE_LONG_DOUBLE
#endif
</screen>

</para>
</listitem>
<listitem>
<para>Recompilez KCalc.
</para>
</listitem>
</orderedlist>
</para>
</sect1>
</chapter>

<chapter id="utilisation">
<title>Utilisation</title>

<para>L'utilisation générale est habituelle et semblable, si ce n'est identique, à la façon d'utiliser la plupart
des calculatrices scientifiques de poche. Appuyez sur le bouton KCalc pour 
affficher le dialogue de configuration.</para>

<sect1 id="la-pile-de-rsultats">
<title>La pile de résultats</title>

<para>Chaque fois que vous cliquez sur le bouton '=' ou que vous appuyez sur l'une des touches 'égal', 'retour
chariot' ou 'entrée', l'affichage des résultats est rangé dans la pile de résultats de KCalc. Vous pouvez
parcourir cette pile en appuyant sur les flèches vers le haut et vers le bas.</para>
</sect1>

<sect1 id="la-fonction-pourcentage">
<title>La fonction pourcentage</title>

<para>La fonction pourcentage fonctionne légèrement différemment par rapport à la majorité des calculatrices.
Toutefois, une fois comprise, son fonctionnement amélioré se révèle assez 
utile. Reportez-vous à la section concernant la fonction pourcentage dans la 
section "Commentaires sur les fonctions spécifiques" pour une explication 
détaillée sur la fonction pourcentage. </para>
</sect1>

<sect1 id="la-virgule-fixe">
<title>La virgule fixe</title>

<para>Cliquez sur la case à cocher de la virgule fixe du dialogue de configuration si vous désirez fixer le nombre
de chiffres affichés après la virgule.</para>
</sect1>

<sect1 id="copier-coller">
<title>Copier-coller</title>

<para><itemizedlist>
<listitem>
<para>En appuyant avec le bouton gauche de la souris sur l'affichage de KCalc le nombre affiché est placé
dans le presse-papiers.</para>
</listitem>
<listitem>
<para>En appuyant avec le bouton de droite ou du milieu de la souris sur l'affichage de KCalc le contenu du
presse-papiers est collé dans l'affichage si du moins il s'agit d'une nombre 
en virgule flottante valide. </para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="modes">
<title>Modes</title>

<sect1 id="le-mode-statistique">
<title>Le mode statistique</title>

<para>Appuyez sur F4 pour basculer du mode trigonométrique vers le mode statistique. Ou alors
affichez le dialogue de configuration en appuyant sur le bouton KCalc ou en appuyant sur F2 puis choisissez
le mode statistique.</para>

<para><variablelist>
<varlistentry>
<term>N</term>
<listitem>
<para>Rappelle le nombre de données entrées.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV N </term>
<listitem>
<para>Affiche la somme des données entrées.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Mea </term>
<listitem>
<para>Affiche la moyenne des données entrées.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Mea </term>
<listitem>
<para>Affiche la somme des carrés des données entrées.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Std </term>
<listitem>
<para>Affiche l'écart-type (n).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Std </term>
<listitem>
<para>Affiche l'écart-type de population (n-1).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Med </term>
<listitem>
<para>Affiche la donnée médiane.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Dat </term>
<listitem>
<para>Permet d'entrer une donnée.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Dat </term>
<listitem>
<para>Efface la dernière donnée entrée.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Cst </term>
<listitem>
<para>Efface toutes les données entrées.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="mode-trigonometrique">
<title>Mode trigonometrique</title>

<para>Appuyez sur F3 pour basculer du mode statistique vers le mode trigonométrique. Ou alors affichez le
dialogue de configuration en appuyant sur le bouton KCalc ou en appuyant sur F2 puis choisissez le mode
trigonométrique.</para>

<para><variablelist>
<varlistentry>
<term>Hyp</term>
<listitem>
<para>Entre dans le sous-mode hyperbolique. HYP SIN par exemple est le 
sinus hyperbolique : sinh(x).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Sin</term>
<listitem>
<para>Calcule the sinus.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Sin</term>
<listitem>
<para>Calcule l'arc sinus.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Cos</term>
<listitem>
<para>Calcule le cosinus.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Cos</term>
<listitem>
<para>Calcule l'arc cosinus.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Tan</term>
<listitem>
<para>Calcule la tangente.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Tan</term>
<listitem>
<para>Calcule l'arc tangente.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Log</term>
<listitem>
<para>Calcule le logarithme décimal.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Log</term>
<listitem>
<para>Calcule 10 à la puissance x.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Ln</term>
<listitem>
<para>Calcule le logarithme naturel. Celui de base e.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>INV Ln</term>
<listitem>
<para>Calcule l'exponentielle de x (e à la puissance x).</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
</chapter>

<chapter id="acclrateurs">
<title>Accélérateurs</title>

<para>(A FAIRE) : Cette liste est probablement incomplète. Vérifier!</para>

<para><screen>
F1          Aide
F2          Dialogue de configuration
F3          Entrer dans le mode trigonometrique
F4          Entrer dans le mode statistique

Flèche haut afficher l'élément précédent de la pile de résultats
Flèche bas  afficher l'élément suivant de la pile de résultats
Page haut   C (effacer)
Précédent   C (effacer)
Page bas    AC (effacer tout)
Suivant     AC (effacer tout)

ALT + d     unité angulaire = degrés
ALT + r     unité angulaire = radians
ALT + g     unité angulaire = grades
ALT + e     base dix (decimal)
ALT + o     base huit (octal)
ALT + b     base deux (binaire)

s           sin
c           cos
t           tan
n           ln  = log base e
l           log = log base 10
i           Inv fonction inverse, par exemple si vous voulez arcsin(x) tapez 'i' 's'
\           +/- 
[           ^2 
^           x^y 
=           = 
!           factorielle
&lt;           décalage gauche
&gt;           décalage droite
&           ET
*           multiplication
/           division

d           entrer une donnée statistique (en mode statistique)

o           OU
INV o       OU exclusif
r           1/x nombre inverse (r comme "réciproque")
Entrée      = 
Retour      = 
Correction  AC (tout effacer) 
Del         AC (tout effacer)
Esc         C (effacer)
h           Hyp (Hyperbolique) comme par exemple le sinus hyperbolique, sinh(x) 
</screen>
</para>
</chapter>

<chapter id="commentaires-sur-les-fonctions-spcifiques">
<title>Commentaires sur les fonctions spécifiques</title>

<sect1 id="mod">
<title>Mod</title>

<para>Modulo : donne le reste de la division euclidienne du nombre affiché par le prochain 
nombre entré. </para>
</sect1>

<sect1 id="inv-mod">
<title>Inv Mod</title>

<para>Quotient : donne le quotient de la division euclidienne du nombre affiché par le prochain 
nombre entré. </para>
</sect1>

<sect1 id="index-0">
<title>&percnt;</title>

<para>Interprète l'opération finale à l'issue du calcul en cours comme suit : </para>

<para><itemizedlist>
<listitem>
<para>La fonction de la touche &percnt; est semblable à celle de certaines calculatrices CASIO :
</para>
</listitem>
<listitem>
<para>Si l'opérateur final est +, elle donne le pourcentage d'augmentation du résultat
par rapport au second opérande.
</para>
</listitem>
<listitem>
<para>Si l'opérateur final est -, elle donne le pourcentage de diminution du résultat 
par rapport au second opérande.
</para>
</listitem>
<listitem>
<para>Si l'opérateur final est *, elle donne l'opérande de droite comme un pourcentage de 
l'opérande de gauche. </para>
</listitem>
<listitem>
<para>Si l'opérateur final est /, ou Mod elle donne l'opérande de gauche comme un 
pourcentage de l'opérande de droite.
</para>
</listitem>
<listitem>
<para>Si l'opérateur final est x**y elle donne l'opérande de gauche élevé à la puissance de (l'opérande de
droite / 100).
</para>
</listitem>
<listitem>
<para>Dans tous les autres cas la touche &percnt; donne des résultats identiques à la touche =.
</para>
</listitem>
</itemizedlist>
                              </para>

<sect2 id="exemples">
<title>Exemples</title>

<para><programlisting>
Tapez :            45 / 55 %
Réponse affichée : 81.8181...
Explication :      45 est 81.81 pourcent de 55.

Tapez :            11 + 89 %
Réponse affichée : 112.35.. 
Expliquation :     89 + 11 = 100 et 100 est 112.35 pourcent de 89. </programlisting>
</para>
</sect2>
</sect1>

<sect1 id="lsh-rsh">
<title>Lsh (Rsh)</title>

<para>Décalage vers la gauche (vers la droite) de n positions où n est le prochain nombre entré.
Vous obtenez Rsh (right shift) en appuyant sur INV Lsh (left shift).</para>
</sect1>
</chapter>

<chapter id="trucs-et-astuces">
<title>Trucs et astuces</title>

<sect1 id="polices">
<title>Polices</title>

<para>J'ai remarqué que plusieurs distributions ne savent pas comment régler FontPath correctement
et quelles polices installer afin d'obtenir de superbes polices sous X11. Je ne peux pas vous aider à
rassembler de telles polices mais je peux vous montrer à quoi ressemble mon FontPath dans
/etc/XF86Config. Ceci vous aidera à obtenir de meilleurs résultats pour xemacs aussi 
bien que pour KCalc : 
<screen>Section "Files"
   RgbPath    "/usr/X11R6/lib/X11/rgb"
   FontPath   "/usr/X11R6/lib/X11/fonts/misc:unscaled"
   FontPath   "/usr/X11R6/lib/X11/fonts/75dpi:unscaled"
   FontPath   "/usr/X11R6/lib/X11/fonts/100dpi:unscaled"
   FontPath   "/usr/X11R6/lib/X11/fonts/Type1"
   FontPath   "/usr/X11R6/lib/X11/fonts/Speedo"
   FontPath   "/usr/X11R6/lib/X11/fonts/misc"
   FontPath   "/usr/X11R6/lib/X11/fonts/75dpi"
   FontPath   "/usr/X11R6/lib/X11/fonts/100dpi"
   FontPath   "/usr/X11R6/lib/X11/fonts/cyrillic"
EndSection
</screen>
</para>
</sect1>
</chapter>

<chapter id="questions-et-rponses">
<title>Questions et réponses</title>

<sect1 id="comment-puis-je-obtenir-pi3.1415926...-">
<title>Comment puis-je obtenir pi=3.1415926... ?</title>

<para>Tapez simplement INV EE.</para>
</sect1>

<sect1 id="comment-puis-je-obtenir-e-le-nombre-deuler-">
<title>Comment puis-je obtenir e, le nombre d'Euler ?</title>

<para>Tapez 1 INV ln.</para>
</sect1>

<sect1 id="comment-puis-je-obtenir-deux-chiffres-fixes-">
<title>Comment puis-je obtenir deux chiffres fixes après la virgule ?</title>

<para>Cliquez sur le bouton KCalc pour afficher le boîte de dialogue de configuration de KCalc. 
Cliquez sur "Régler la virgule fixe" et ajustez le compteur tournant jusqu'à ce qu'il 
affiche 2.</para>
</sect1>

<sect1 id="quen-est-il-de-la-prcision-">
<title>Qu'en est-il de la précision ?</title>

<para>Le facteur principal déterminant la précision de KCalc est le support par libc et libmath du type de données
C 'long double'. Si ce type est disponible, KCalc le détectera au moment de la 
compilation et l'utilisera comme type fondamental pour représenter des nombres. Allez dans 
le dialogue 'à propos' de KCalc pour savoir quel est le type de données de base de votre 
exemplaire de KCalc.</para>

<para> 
A moins d'avoir une librairie libc et une librairie libmath de qualité exceptionnellement haute, vous serez
capable d'observer quelques résultats "intéressants" en essayant d'effectuer des calculs 
comme : 123.22 - 123.21; 2.01 - 2; 123.88 - 123.87 et ainsi de suite. Si toutefois vous 
pensez que c'est mauvais je vous invite à effectuer le même calcul sur la calculatrice de 
poche de Windows.</para>

<para> 
Ajustez la précision sur le dialogue de configuration de KCalc de manière à ce que les calculs ci-dessus
s'effectuent correctement. Je recommende une précision de 14 si le type de base pour votre exemplaire de
KCalc est 'long double', sinon 8 ou 10.</para>

<para>Note : Une plus grande précision ne mène pas forcément à de meilleurs résultats. Jouez 
avec la précision et vous verrez ce que je veux dire.</para>
</sect1>
</chapter>

<chapter id="copyright">
<title>Copyright</title>

<para><screen>
KCalc Copyright 1996,1997 Bernd Johannes Wuebben 
                          wuebben@math.cornell.edu

KCalc a été inspiré par xfrmcalc de Martin Bartlett, dont le moteur de résultats est toujours une partie de
KCalc.

Ce programme est un freeware (graticiel) ; vous pouvez le redistribuer et/ou le modifier
selon les termes de la Licence Publique GNU (GPL) telle que publiée par la Free Software 
Foundation ; soit la version 2 de la Licence, ou (à votre choix) toute version ultérieure.

Ce programme est distribué dans l'espoir qu'il sera utile, mais SANS AUCUNE GARANTIE;
même sans la garantie implicite de MERCANTIBILITE ou de CONVENANCE POUR UN BUT PARTICULIER. Reportez-vous à
la Licence Générale Publique GNU pour plus de détails.

Vous devriez avoir reçu une copie de la Licence Générale Publique GNU avec ce programme; si ce n'est pas le
cas, écrivez à la Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

</screen>
</para>

<para>(Traduction française de la documentation :
<ulink url="mailto:e.bischoff@noos.fr">Eric Bischoff</ulink>)</para>
</chapter>
<![ %addindex; [ &docindex; ]]>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->
