home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 4 / CDPD_IV.bin / fish / 931-950 / ff942 / acalc / acalc.doc < prev    next >
Text File  |  1993-12-22  |  9KB  |  231 lines
  1.  
  2.  
  3.               ACalc - Manuel de référence
  4.  
  5.  
  6.  
  7.  
  8.  
  9. AboutThisDoc
  10.  
  11.       Ce manuel décrit la version 1.21 de l'utilitaire ACalc. Ce programme
  12.   est (c)1993 par Denis GOUNELLE, toute utilisation commerciale ou vente  sans
  13.   autorisation    écrite    est  strictement  interdite.  Vous  pouvez  copier  et
  14.   diffuser ce programme aux conditions suivantes :
  15.  
  16.     - l'ensemble des fichiers doit être fourni
  17.     - aucun fichier ne doit avoir été modifié
  18.     - vous ne devez pas demander plus de 40FF pour cela
  19.  
  20.       Malgré de nombreux tests, je ne peux garantir que ACalc ne  contient
  21.   aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS RISQUES  ET  PERILS.    Je  ne
  22.   pourrai en aucun cas être tenu pour responsable de tout dommage,  direct  ou
  23.   indirect, résultant de l'utilisation de ACalc.
  24.  
  25. Introduction
  26.  
  27.       ACalc est une calculatrice fonctionnant en  mode  virgule  flottante
  28.   (IEEE double précision) et en mode basé (décimal  ou  hexadécimal),  capable
  29.   d'apparaitre sur n'importe quel écran. Sous système 2.04  ou  supérieur,  le
  30.   programme s'installe automatiquement en  tant  que  "commodité",  mais  peut
  31.   également être utilisé autrement.
  32.  
  33.       Vos critiques et suggestions sur ce programme  seront  toujours  les
  34.   bienvenues. N'hésitez pas à m'écrire, à l'adresse suivante :
  35.  
  36.                    M. GOUNELLE Denis
  37.                     Boite 71
  38.                   6, rue des cailloux
  39.                  92110 CLICHY - FRANCE
  40.  
  41.       Vous pouvez également m'adresser un  message  à  l'adresse  Internet
  42.   "gounelle@alphanet.ch". Notez qu'il s'agit d'une boite à lettre  mise  à  ma
  43.   disposition par un ami, aussi veuillez n'envoyer que de courts messages.  De
  44.   plus, n'ayant pas accès directement à mes messages, n'espérez pas avoir  une
  45.   réponse avant une dizaine de jours.
  46.  
  47. Installation
  48.  
  49.       ACalc a besoin de la bibliothèque "mathieeedoubbas.library", qui est
  50.   fournie par Commodore sur les disquettes système. Sous système  1.3,    copiez
  51.   simplement le programme dans    un  répertoire    situé  dans  votre  chemin  de
  52.   recherche (par exemple "C:"). Sous système 2.04 et plus, vous  voudrez  sans
  53.   doute installer ACalc en "commodité", et donc le copier dans  le  répertoire
  54.   "SYS:WBStartup" pour qu'il soit actif dès le démarrage.
  55.  
  56. Appel_depuis_le_CLI
  57.  
  58.       ACalc se détache automatiquement du CLI. Les arguments acceptés sont
  59.   les suivants :
  60.  
  61.       CX_PRIORITY n (ignoré sous système 1.3)
  62.       Fixe la priorité pour l'installation en "commodité".
  63.  
  64.       CX_HOTKEY touche (ignoré sous système 1.3)
  65.       Indique la combinaison de touches  permettant  d'appeler  ACalc,
  66.       quand il est installé en "commodité". La combinaison par  défaut
  67.       est "ctrl esc".
  68.  
  69.       NOCOMM (ignoré sous système 1.3)
  70.       Demande à ACalc de ne pas s'installer en  "commodité",  mais  de
  71.       fonctionner comme un programme normal. Le programme se terminera
  72.       donc dès que vous cliquerez sur le gadget de fermeture.
  73.  
  74.       SAVEVAR
  75.       Demande à ACalc de sauvegarder le résultat  dans  une  variable,
  76.       plutôt que d'utiliser le Clipboard.  La  variable  utilisée  est
  77.       "ACalcResult".
  78.  
  79. Appel_depuis_le_Workbench
  80.  
  81.       Vous pouvez indiquer les arguments suivants,    dans  le  champ  "TOOL
  82.   TYPES" de l'icône de ACalc :
  83.  
  84.       CX_PRIORITY=n (ignoré sous système 1.3)
  85.       Fixe la priorité pour l'installation en "commodité".
  86.  
  87.       CX_HOTKEY=touche (ignoré sous système 1.3)
  88.       Indique la combinaison de touches  permettant  d'appeler  ACalc,
  89.       quand il est installé en "commodité". La combinaison par  défaut
  90.       est "ctrl esc".
  91.  
  92.       NOCOMM (ignoré sous système 1.3)
  93.       Demande à ACalc de ne pas s'installer en  "commodité",  mais  de
  94.       fonctionner comme un programme normal. Le programme se terminera
  95.       donc dès que vous cliquerez sur le gadget de fermeture.
  96.  
  97.       SAVEVAR
  98.       Demande à ACalc de sauvegarder le résultat  dans  une  variable,
  99.       plutôt que d'utiliser le Clipboard.  La  variable  utilisée  est
  100.       "ACalcResult".
  101.  
  102. Utilisation_du_programme
  103.  
  104.       Au démarrage, ACalc ouvre sa fenêtre sur l'écran  au  premier  plan.
  105.   Cette fenêtre présente une zone d'affichage et un clavier de 36 touches.  La
  106.   plupart de ces touches sont évidentes d'emploi, aussi ce chapitre ne  décrit
  107.   que celles qui en ont besoin.
  108.  
  109.       Touche de mode (FLT,DEC,HEX)
  110.       ACalc possède trois modes de calculs : le mode virgule flottante
  111.       (FLT), le mode basé décimal (DEC) et le  mode  basé  hexadécimal
  112.       (HEX). Dans ces deux derniers modes, les calculs  se  font  avec
  113.       des entiers non signés de 32 bits. Suivant le mode  sélectionné,
  114.       certaines touches seront désactivées.
  115.  
  116.       d
  117.       En mode HEX, permet d'indiquer que le nombre  qui  suit  est  un
  118.       nombre décimal.
  119.  
  120.       h
  121.       En mode DEC, permet d'indiquer que le nombre  qui  suit  est  un
  122.       nombre hexadécimal.
  123.  
  124.       STO
  125.       Cette  touche  n'est  utilisable  que  lorsqu'un  résultat   est
  126.       affiché. Elle permet de stocker ce  résultat    dans  une  des    10
  127.       mémoires disponibles.  Après    avoir  cliqué  sur  cette  touche,
  128.       cliquez sur un des chiffres  de  0  à  9  pour  sélectionner    la
  129.       mémoire à utiliser.
  130.       Les mémoires sont initialisées à zéro au démarrage du programme.
  131.       Si ACalc est installé en "commodité", leur contenu est  conservé
  132.       entre deux appels du programme.
  133.  
  134.       RCL
  135.       Rappelle le contenu d'une mémoire. Après avoir cliqué sur  cette
  136.       touche, cliquez sur un des chiffres de 0 à 9    pour  sélectionner
  137.       la mémoire à utiliser.
  138.  
  139.       BS
  140.       Efface le dernier  caractère    de  l'expression  ou  du  résultat
  141.       affiché.
  142.  
  143.       =
  144.       Cette touche    lance  le  calcul  de  l'expression  affichée,  et
  145.       affiche son résultat ou un message d'erreur. Dans les deux  cas,
  146.       vous pouvez rappeler l'expression  en  appuyant  sur  le  bouton
  147.       droit de la souris.
  148.       Le résultat  peut  être  ré-utilisé  immédiatemment  :  si  vous
  149.       cliquez sur un opérateur, ACalc supposera que le résultat est la
  150.       première opérande. Sinon, le    résultat  sera    effacé    car  ACalc
  151.       supposera que vous voulez calculer une nouvelle expression.
  152.  
  153.       ACalc sauvegarde automatiquement le dernier résultat calculé dans le
  154.   Clipboard. Ceci vous permet de récupérer ce  résultat  dans  n'importe  quel
  155.   programme qui utilise également le Clipboard (par exemple  votre  traitement
  156.   de texte ou, sous système 2.0, la fenêtre Shell si  le  programme  "conclip"
  157.   est actif). Le fichier "clipboard.device" doit se trouver dans le répertoire
  158.   "DEVS:" pour que cette possibilité fonctionne.
  159.       Si  vous  préférez  sauvegarder  ce  résultat  dans    une   variable
  160.   d'environnement, plutôt que dans le Clipboard, il vous suffit  d'appeler  le
  161.   programme avec l'argument SAVEVAR  (voir  chapitres  Appel_depuis_le_CLI  et
  162.   Appel_depuis_le_Workbench).
  163.  
  164. Utilisation_avec_le_clavier
  165.  
  166.       ACalc peut être également utilisé avec le clavier de votre Amiga, et
  167.   cela de deux façons. La première consiste à cliquer sur la zone d'affichage,
  168.   et à éditer l'expression comme dans n'importe  quel  gadget  de  chaine.  La
  169.   seconde consiste simplement à appuyer sur les touches du  clavier  de  votre
  170.   Amiga, sans avoir au préalable activé le gadget de chaine. Dans ce cas, vous
  171.   disposez d'une possibilité supplémentaire : fermer la  fenêtre  en  appuyant
  172.   sur la touche ESCAPE.
  173.       Notez   cependant   que   certains   opérateurs   sont    transcrits
  174.   différemments par rapport au libellé des touches : ainsi l'opérateur NOT est
  175.   transcrit '~' (tilde). Si vous utilisez ACalc depuis  le  clavier,  il  vous
  176.   faudra donc taper '~' et non 'N', 'O' puis 'T'. Cette dernière forme ne sera
  177.   pas reconnue. Voici les caractères correspondant aux opérateurs :
  178.  
  179.       mode          touche TAB
  180.       NOT          ~
  181.       AND          &
  182.       OR          |
  183.       SHL          <
  184.       SHR          >
  185.       RCL          M (suivit du numéro de mémoire)
  186.       BS          touche BACKSPACE
  187.  
  188.   Les touches STO et CLR n'ont pas d'équivalent clavier.
  189.  
  190. Historique
  191.  
  192.       ACalc a été écrit principalement en langage C,  sur  un  Amiga  3000
  193.   UNIX-1 (10 Mo de mémoire, lecteur de disquettes interne HD,  disque  interne
  194.   de 100 Mo, lecteur SyQuest externe de 88 Mo, lecteur de disquettes  externe,
  195.   moniteur 1960 et imprimante Star LC24-10) connecté par un cable null-modem à
  196.   un A500 avec 1 Mo de mémoire.
  197.  
  198.   v1.00   15-Avr-93, 19904 octets
  199.       o Première version diffusée.
  200.  
  201.   v1.01   26-May-93, 20140 octets
  202.       o Erreur corrigée: l'affichage n'était pas correct si la  police  de
  203.         l'écran était proportionnelle (force désormais la topaz 8 dans  ce
  204.         cas).
  205.  
  206.   v1.02   29-May-93, 20148 octets
  207.       o Réagit à la commande "Montrer" du  programme  "Exchange"  (gestion
  208.         des commodités)
  209.  
  210.   v1.10   07-Jun-93, 21012 octets
  211.       o Essaye d'ouvrir la fenêtre sous le pointeur souris.
  212.       o Gestion des  polices  de  caractères  améliorée  :    est  désormais
  213.         capable de récupérer la police texte par défaut, et s'adapte à  la
  214.         police de l'écran par défaut pour le titre de  la  fenêtre  et  le
  215.         gadget de chaine.
  216.       o Si ACalc est installé en commodité, le  lancer  une  seconde  fois
  217.         fait apparaitre la fenêtre au lieu de terminer le programme.
  218.  
  219.   v1.20   29-Jun-93, 20924 octets
  220.       o Gestion des gadgets modifiés pour  que  l'activation/désactivation
  221.         en fonction du mode soit plus rapide (était beaucoup trop lent sur
  222.         un A500/A2000)
  223.  
  224.   v1.21   12-Sep-93, 20864 octets
  225.       o Utilise la nouvelle version de la fonction GetDefaultTextFont()
  226.  
  227.  
  228.  
  229.  
  230.  
  231.