@XYZ  V 3.4 f version franaise (c) Jacques GAUDIN 1995-96
Votre formulaire mathmatique pour Series 3a

Jacques GAUDIN
11 rue Lacretelle    
77340 Pontault-Combault FRANCE

e-mails:
	100745.1005@compuserve.com      
	jgaudin@ellis.fdn.org




                        +----------------------------+
                        |                            |
                        |                            |
                        |       @   X   Y   Z        |
                        |                            |
                        |    M   A   N   U  A  L     |
                        |                            |
                        |                            |
                        +----------------------------+

Sommaire
--------
    1  Introduction
    2  Shareware
    3  Distribution
    4  fichiers
    5  Installation
    6  Historique
    7  Base de donnes
    8  Interface
    9  Entre des formules
    10 Affichage des formules
    11 Fonctions algbriques
    12 Fonctions trigonomtriques
    13 Listes de nombres
    14 Fonctions spciales
    15 Entree des valeurs
    16 Rsultats
    17 Mmoires de la calculatrice
    18 Mmoire systme
    19 Fichiers d'exemples
    20 Personnaliser le fichier d'aide
    21 Emulateur PC Serie 3a
    21 Protection
    22 Limite de garantie
    23 Quelques problmes
    24 Autres logiciels

1 INTRODUCTION
  ============
@XYZ est un formulaire pour Series 3a permettant la saisie de formules 
mathmatiques, physiques ou financires utilisant jusqu' 7 variables.
Vous pouvez stocker ces formules dans une base de donnes  dfilement par liste,
et visualisation de chaque fiche (formule avec notes).
Vous pouvez effectuer depuis cette base  des calculs, 
avec diverses possibilits d'utilisation des rsultats, 
tel leur impression ou l'utilisation des mmoires de la calculatrice. 
Cette dernire possibilit permet un dialogue total avec cette application. 
C'est une application puissante disposant d'un outil syntaxique volu.
Attention, les fichiers des anciennes versions (rares) doivent tre convertis
avant toute utilisation sur une version rcente (voir plus bas).

2 SHAREWARE
  =========
@XYZ est un shareware. 
Le prix modeste d'un shareware n'a pas pour objet de faire de l'argent 
mais de contribuer au dveloppement de prochaines applications. 
Les dveloppeurs ont en effet besoin d'outils, de matriel, de documentation. 
Le prix d'un shareware est trs faible 
au regard des services qu'il peut vous rendre,
et au regard du temps pass pour sa cration.
Enregistrez-vous donc pour obtenir une version personnalise,
marque  votre nom et dbarasse des messages de rappel, soit :

a/ en envoyant 115 F, ou $ 25, 
frais de port inclus,  l'adresse suivante :

	Jacques GAUDIN
	11 rue Lacretelle    
	77340 Pontault-Combault
	FRANCE

Vous trouverez un formulaire d'enregistrement  la fin de ce document.
Vous recevrez la dernire version de @XYZ,  votre nom, 
dbarrasse des messages de rappel, 
par e-mail ou sur disquette 3"1/2. 
Les chques doivent tre libells en Francs Franais.

b/ on-line, en utilisant le service d'enregistrement de compuserve :

GO SWREG , le numro d'enregistrement de ce shareware est 13382.

Vous recevrez votre version par fichier joint sur votre e-mail.

3 DISTRIBUTION
  ============
Ce logiciel peut tre distribu librement dans sa version shareware,
mais uniquement  des fins non commerciales 
et avec l'ensemble de ses fichiers non modifis.

4 FICHIERS
  ========
Rpert.     Fichiers        Notes

APP\        @XYZ.OPA        l'application
APP\        @UVW.ALS        alias de l'diteur (*)
APP\@XYZ\   @XYZ.HLP        fichier d'aide (*)
APP\@XYZ\   @XYZ.ZOK        fichier image  (*)
OPO\        @XYZ1to2.OPO    fichier de conv. V 1.x V 2.x (*)
OPO\        @XYZ2to3.OPO    fichier de conv. V 2.x V 3.x (*)
XYZ\        ELECT3.XYZ      fichier d'exemples   (*)
XYZ\        FINANC3.XYZ     fichier d'exemples   (*)
XYZ\        FLUIDES3.XYZ    fichier d'exemples   (*)
XYZ\        VOLUMES3.XYZ    fichier d'exemples   (*)
XYZ\        PRESS3.XYZ      fichier d'exemples   (*)
XYZ\        SPEED3.XYZ      fichier d'exemples   (*)
WRD\        @XYZ.TXT        ce fichier  (*)

(*) optionnels

En plus des ces fichiers @XYZ cre et utilise les fichiers suivants:
	M:\OPD\@XYZ.INI qui conserve les prfrences utilisateur. 
		(En cas de destruction il se recre automatiquement)
	M:\OPD\@XYZCOPY.TMP 
	   (buffer ventuel de copie au format @XYZ.)

ATTENTION:
En cas de modification du nom de l'application (@XYZ.OPA) 
il faudra modfier le nom sous rpertoire @XYZ 
et le nom de ses fichiers de la mme faon :
	Exemple :
	Application     ABC.OPA, donnera  
	APP\ABC\ABC.HLP et  APP\ABC\ABC.ZOK


5 INSTALLATION
  ============
Connectez le S3a  votre PC, activez la liaison distante et lancez MCLINK. 
Recopiez @XYZ.OPA  et  @UVW.ALS dans le rpertoire APP 
sur n'importe quel disque.
Recopiez (optionnel) @XYZ.HLP et @XYZ.ZOK 
dans un sous rpertoire APP\@XYZ\  sur le mme disque que l'OPA.
Recopiez les exemples dans un rpertoire  \XYZ sur n'importe quel disque.
Recopiez ventuellement ce fichier dans un rpertoire \WRD 
avec l'extension .WRD.
Installez @XYZ.OPA  et  @UVW.ALS dans l'cran systme (Psion+i).
Le caractre @ permet de les avoir en tte de liste.

6 HISTORIQUE
  ==========

VERSION 2.4
Les versions 2.x proposent de saisir jusqu' 7 variables !
Si vous possdez des fichiers personnels issus d'une version 1.x 
utilisez le module OPO @XYZ1TO2.OPO pour convertir vos fichiers 
avec le nombre de champs convenable.
Le symbole de fonction est automatiquement propos comme variable 
 l'affichage des rsultats.
La variable par dfaut est xyz.
Cette nouvelle version propose galement une option "Prfrences" 
pour le choix des touches "Calcul","Edition","Affichage".
Cette version conserve les choix (touches , format rsultat , zoom ) 
dans un fichier d'init.

VERSION 3.0
La version 3.0 propose la saisie d'un champ de note en plus
ceci pour avoir une note en face du symbole et une en face des 7 variables.
Les fichiers provenant d'une version 2.x doivent tre convertis 
avec le module OPO @XYZ2TO3.OPO. 
Si vous possdez des fichiers issus d'une version 1.x 
convertissez les d'abord avec @xyz1to2.opo.
Attention aux fausses manips, conservez les anciens fichiers.
La version 3.0 propose un affichage graphique encore amlior 
avec prsentation en un seul bloc de la formule et des notes.
Cette version permet aussi des oprations directes sur la variable locale
ou sur les mmoires de la calculatrice en rutilisant ci besoin 
cette variable ou ces mmoires.

VERSION 3.0a
Cette version corrige un bug  propos du fichier d'aide. 
En cas d'absence de celui-ci le programme entrait 
dans une boucle continue lors de l'annulation d'un dialogue par la touche Esc.

VERSION 3.2
Cette version gre mieux l'interface multitches du Series 3a
et ne ralentit plus les autres applications

VERSION 3.4 f
Cette version apporte seulement une protection supplmentaire
dans le cas des erreurs de manipulations suivantes 
 l'intrieur de l'application :
    -ouverture d'un mauvais type de fichier.
    -erreur  la cration d'un fichier (ex: sur un SSD protg )
L'application n'est plus stoppe mais rouvre l'ancien fichier.

7  BASE DE DONNEES
  ===============
@XYZ est aussi une base de donnes 
et supporte donc les fonctions "Trouver","Trouver suivant",
le positionnement alphabtique sur la touche presse,
le tri alphanumrique selon le nom des formules.
Vous pouvez aussi copier une formule entire
et l'insrer  la fin du fichier en cours,
pour la modifier tout en conservant l'ancienne.
Vous pouvez aussi la copier dans un autre fichier,
mme aprs fermeture du fichier prcdent,
dans le but de regrouper des formules utiles
 un travail particulier.
@XYZ utilise pour cette fonction le fichier temporaire
"M:\OPD\@XYZCOPY.TMP" comme buffer de copy.
Ce fichier n'est pas automatiquement dtruit aprs utilisation.

8 INTERFACE
  =========
L'interface utilise est totalement standard avec le Series 3a 
avec menu droulant et raccourcis clavier:
	<Flches> dplacement dans la liste
	<Psion>+<Flches> dplacent d'un cran.
	<Ctrl>+<Psion>+<Flches> dbut et fin de fichier.
	<Psion>+<Z> et <Psion>+<Maj>+<Z> fonctions de zoom.
	<Ctrl>+<Menu> fentre d'tat.
	<Diamant> et <Maj>+<Diamant> accs aux options touche diamant.
	Gestion de la touche d'aide pour les menus et dialogues.

Plus particulirement certaines les touches    
<Tab>, <Espace> et <Entre> peuvent tre dsignes (Prfrences) pour
		- diter la formule (modifications)
		- afficher la formule.
		- saisir des valeurs pour calcul.

Utilisez [Entre] pour valider un dialogue.
Utilisez [Esc] pour l'annuler.
Utilisez <Psion+q> pour quitter.

9 SAISIE DES FORMULES
  ===================
Les formules utilisent les fonctions standards de l'OPL.
Elles doivent tre saisies sans espace. 
La longueur maximale d'une formule est de 255 caractres
mais vous devez tenir compte du rsultat des calculs intermdiaires !
En cas de dpassement des 255 caractres,
l'erreur "Nom trop long" sera retourn.
Les variables doivent avoir de 1  10 caractres.
Attention aux variables longues dans les longues formules. 
Elles peuvent contenir des chiffres (A1, B2 etc.)
et d'autres caractres.

10 AFFICHAGE DES FORMULES
   ======================
Les formules peuvent tre affiches dans une fentre avec variables et notes.
Supprimer la fentre d'tat (Ctrl+Menu) pour afficher les longues formules.
En cas d'impossibilit la formule dfilera dans la fentre.

11 FONCTIONS ALGEBRIQUES
   =====================
EXP, LN, LOG, SQR, ABS, INTF
Elvation  une puissance : x**3 , cube de x etc.
ABS(x) retourne la valeur absolue de x.
INTF(x) retourne la partie entire de x.

12 FONCTIONS TRIGONOMETRIQUES
   ==========================
PI, COS, SIN, TAN, ACOS, ASIN, ATAN
Les angles sont compts en radians. 
Utilisez RAD et DEG pour les conversions ncessaires. 
ex: DEG(ATAN(TAN(RAD(30)))) retournera 30 etc...

13 FONCTIONS D'EVALUATION SUR LISTE
   ================================
MAX, MIN        plus petite ou plus grande valeur d'une liste.
SUM(a,b,c..)    somme d'une liste
STD(a,b,c..)    cart type
VAR(a,b,c..)    variance
MEAN(a,b,c..)   moyenne

14 FONCTIONS SPECIALES
   ===================
MOD, DIV, FACT, ARR, COMB
Ces fonctions n'existent pas dans la calculatrice:
MOD(a,b)        retourne a modulo b.
DIV(a,b)        retourne la division entire de a par b.
FACT(n)         factorielle n (avec n<=69)
ARR(n,p)        arrangements de p dans n (n et p entiers >0)
COMB(n,p)       combinaisons de p dans n (n et p entiers >0)

15 SAISIE DES VALEURS
   ==================
Les valeurs sont saisies en mode texte puis values. 
SIN(RAD(45)) est une entre licite. 
Les variables peuvent faire rfrence  d'autres variables 
comme "long = larg*1.33" puis "larg=1.20" . 
Le programme dtectera ces rfrences et excutera autant de passes 
que ncessaire pour saisir ces valeurs. 
ATTENTION : le programme ne dtecte pas les rfrences circulaires, 
ce qui reste  la charge de l'utilisateur. 
La formule "Surface=long*larg" avec "long=larg/2" et "larg=long*2", 
retournera zro mais aucune erreur.

16 RESULTATS
   =========
Les rsultats peuvent s'afficher en format gnral, scientifique ou fixe. 
Les rsultats sont imprimables comme liste droulante 
	dans un fichier texte, pour une utilisation diffre, 
	ou directement sur l'imprimante via un port parallle. 
Dans le cas d'une impression dans un fichier, il faut naturellement le clore 
en slectionnant "Terminer impression" , avant de l'ouvrir. 
Un alias de l'diteur @uvw.als, paramtr pour travailler 
dans le rpertoire \XYZ, est fourni pour l'dition. 
L'application peut dialoguer totalement avec la calculatrice via ses mmoires.
Si un rsultat est nomm son nom devient une entre valide 
comme valeur pour une variable !

17 MEMOIRES DE LA CALCULATRICE
   ===========================
Utilisez "Mmoriser sur"  l'affichage des rsultats pour crire 
sur les mmoires de la calculatrice. 
ATTENTION: celles-ci seront donc modifies!
Les symboles de M0  M9 sont ensuite autoriss comme entres de valeur 
et si ces mmoires sont nommes (dans la calculatrice) 
leur nom est une entre licite !
Un calcul direct peut-tre effectu sur chacune des mmoires 
(Option menu "Editer mmoires").
Les entres utilisant toutes les fonctions prcdemments dcrites 
avec les noms des mmoires ou la variables locales, sont licites.

18 OPTIMISATION DE LA MEMOIRE SYSTEME
   ==================================
Toute application consomme de la mmoire et du temps systme.
Il est recommand de fermer toute application inutile 
pour augmenter la vitesse de calcul,
particulirement les applications crites en OPL. 
Utiliser l'option Copier et Coller pour importer des formules 
d'un autre fichier, que vous fermerez ensuite, 
plutt que de laisser inutilement plusieurs fichiers ouverts.

19 FICHIERS D'EXEMPLE
   ==================
Ces fichiers sont livrs  titre d'exemple sans aucune garantie
sur l'exactitude des formules qu'ils renferment.

20 PERSONNALISATION DU FICHIER D'AIDE
   ==================================
Le fichier d'aide APP\@XYZ\@XYZ.HLP est un fichier DBF ditable avec "FICHE".
Vous pouvez ainsi vous crer une aide personnalise. 
Remettez les fiches dans le bon ordre ( en les updatant dans l'ordre dsir ).

21 EMULATEUR PC SERIES 3A
   ======================
Si vous utilisez sur PC l'mulateur Psion Series 3 a, 
@XYZ s'adaptera  la taille de la fentre principale.
Rappelons que pour lancer l'mulateur en mode plein cran ( celui du PC )
il faut modifier la ligne  SERVER_PARAMS -X480 -Y160 -D 
en  SERVER_PARAMS -X640 -Y480 -D  dans les fichier  HHSERVER.PAR.
Vous disposez ainsi de 30  50 lignes de texte  l'cran.

22 PROTECTION CONTRE LA DECOMPILATION
   ==================================
La dcompilation de ce logiciel est rigoureusement interdite.
@XYZ possde plusieurs protections contre la dcompilation 
par des logiciels tels que REVTRAN. 
En l'occurrence toute tentative de dcompilation 
peut entraner des rsultats imprvisibles !

23 LIMITATION DE GARANTIE
   ======================
Le logiciel @XYZ est livr en l'tat sans aucune garantie autre 
que la fourniture d'une nouvelle version en cas de bogue manifeste,
et seulement pour les utilisateurs enrgistrs.
Les fichiers joints ne sont livrs qu' titre d'exemples 
et doivent faire l'objet de toutes les vrifications ncessaires 
avant leur utilisation. 
Jacques Gaudin dcline par avance toute responsabilit dans les consquences, 
dommages et prjudices commerciaux, moraux ou physiques 
provenant de l'utilisation de ces fichiers et du logiciel.
En particulier vous devez vrifier soigneusement 
la rigueur de vos calculs lors d'un croisement de variables.

24 PROBLEMES
   =========
Erreur [zone non trouve]  l'ouverture d'un fichier :
    Vous utilisez un fichier d'une ancienne version.
    Voir plus haut pour les conversions.
Erreur [nom trop long] lors des calculs :
    Lors des calculs la formule dpasse 255 caractres
    aprs remplacement des variables par leurs valeurs.
    Rduisez la taille du nom des variables et les parenthses inutiles.
    Effectuez au besoin vos calculs en deux temps en utilisant les mmoires.
Cos_phi comme facteur
    Dans le cas de l'utilisation d'une expression comme cos_phi
    en tant que facteur, comme P=U*I*cos_phi
    le programme ne peut pas deviner qu'il s'agit d'un cosinus 
    et vous pouvez, videmment, entrer une valeur > 1.
    Ecrire P=U*I*k aurait exactement le mme effet !
SVP signalez tout bug ventuel.

25 DU MEME AUTEUR
   ==============
    -@XYZ   en version anglaise
    -TRAC3A traceur de courbes
    -IKO3A  diteur d'icnes
Vous pouvez trouver ces logiciels sur :
    -Compuserve
        go Palmtop A 
           Psion files
    -Internet, dans la page d'accueil du club Psion Series 3
        http://alex.union-fin.fr/usr/dcabuzel/psion/clubpsion.html
    -Sur le serveur franais Ellis ( Club Psion Series 3 )
        33 (1) 43 33 15 47

==============================================================================
Jacques GAUDIN
11 rue Lacretelle    
77340 Pontault-Combault 
FRANCE

e-mails:
	100745.1005@compuserve.com      
	jgaudin@ellis.fdn.org


ENREGISTREMENT
==============================================================================
	Veuillez me faire parvenir un exemplaire enregistr de @xyz  mon nom 
	en change de 110 F ou de 20 $ joints 
	par mandat ou chque bancaire franais
	ou Euro Chques libells en francs.

	(Ou, ventellement, monaie en $ si aucun autre transfert possible 
	le cot des chques internationaux tant malheureusement prohibitifs)

	NOM        : .............................................................
	SOCIETE    : .............................................................
	Adresse    : .............................................................
	Ville      : .............................................................
	Pays       : .............................................................
	e-mail     : .............................................................
	Je prfre recevoir  une disquette  PC             [ ]
	Je prfre recevoir mon application sur mon e-mail.
	   Sur Compuserve ou le serveur franais Ellis :
	        -e-mail fichier-joint .ZIP                 [ ]
	   Sur Internet :
	        -e-mail fichier UUENCODED  (.ZIP)          [ ]

	Je tiens  vous faire part des remarques suivantes :
	..........................................................................
	..........................................................................
	..........................................................................
	..........................................................................
	..........................................................................
	..........................................................................
	..........................................................................
	..........................................................................
	..........................................................................
	..........................................................................
	..........................................................................
	..........................................................................
==============================================================================
