@DATABASE PresTerm.guide
@REMARK $VER: PresTerm.guide 1.3 (5.10.93)

@NODE MAIN "Presterm: Contenu"
				@{U}@{B}            @{UB}@{UU}

				  @{B}PRESTERM@{UB}
				@{U}@{B}            @{UB}@{UU}

			     TERMINAL  PRESTEL
		  par Joël Jespers, associé à Marc Girboux
	      Copyright ©1993 Relie-Art, Tous Droits Réservés

	       @{" Historique        " LINK HISTORY}	 @{" AREXX             " LINK AREXX}
	       @{" Introduction      " LINK INTRO}
	       @{" Installation      " LINK INSTALL}	 @{" A propos de bugs  " LINK BUGS}
					 @{" Problèmes usuels  " LINK PROBLEMS}
	       @{" Menus             " LINK MENUS}	 @{" Retour de courrier" LINK FEEDBACK}
	       @{" Gadgets           " LINK GADGETS}	 @{" Remerciements     " LINK THANKS}
	       @{" Touches spéciales " LINK KEYS}
	       @{" Outils de l'icône " LINK TOOLS}	 @{" Copyrights        " LINK COPYRIGHTS}
@ENDNODE

@NODE HISTORY "PresTerm: Historique"
@{U}@{B}V1.3:@{UB}@{UU}

	* Première version commerciale.  Supporte TOUS les attributs d'un
	  terminal Prestel et est nettement plus fiable!


@{U}@{B}V1.0, V1.1, V1.2 & V1.2a:@{UU}@{UB}

	* Versions domaine publique.
@ENDNODE

@NODE INTRO "PresTerm: Introduction"
	Ce programme est un terminal Prestel.  Prestel est le protocole
utilisé dans certains pays comme la Belgique (où je suis) pour le Videotex.
Il est également implémenté sur d'autres serveurs tel que celui de ma
compagnie bancaire.  C'est pourquoi j'ai décidé de réaliser ce software.

	Voici une liste sommaire des standards de visualisation utilisés
sur Videotex:

	@{U}PAYS@{UU}			@{U}STANDARD DE VISUALISATION@{UU}
	Belgique		Prestel
	France			Teletel
	Allemagne		BTX
	Grande Bretagne		Prestel
	Luxembourg		BTX
	Portugal		BTX
	Espagne			BTX
	Hollande		Prestel
@ENDNODE

@NODE INSTALL "PresTerm: Installation"
	Notez d'abord que ce programme requière l'OS 2.0 ou plus (V36+).

	Pour installer le programme, cliquez sur l'icône d'installation et
suivez les instructions.  Le script d'installation copie les fichiers
suivants :
	- Copier les fontes dans le répertoire FONTS:.
	- Copier les catalogues dans le répertoire LOCALE:Catalogs/<langue>.
	- Copier les aides dans le répertoire LOCALE:Help/<langue>.
	- Copier le programme dans le répertoire que vous spécifiez.
	- Copier les fichiers AmigaGuide dans leurs répertoires respectifs
	  si vous ne les possédez pas ou que la version est plus ancienne.

	Assurez-vous que les préférences série du Workbench sont correctes,
en concordance avec votre modem.  Principalement le débit en baud et le
protocole.  Allumez votre modem et cliquez sur l'icône PresTerm.  Si tout
va bien, vous devriez recevoir le mot 'AT' suivi juste en dessous du mot
'OK' dans le coin supérieur gauche de l'écran PresTerm.  Si vous ne recevez
pas le mot 'OK' c'est qu'il y a un problème de communication entre votre
Amiga et le modem.  Vérifiez les préférences.
@ENDNODE

@NODE MENUS "PresTerm: Menus"
@{U}Menu 'Projet':@{UU}
   @{B}Iconifier@{UB}	Ferme l'écran, libère toute la mémoire associée ainsi que
		le port série alors disponible pour d'autres applications.
		Si vous actionnez ce menu durant une connection, la
		communication sera perdue.
		Pour rappeler le programme, double-cliquez simplement sur
		l'icône 'PresTerm Recall' qui est apparue dans le WorkBench.

   @{B}A propos de@{UB}	Simple information de copyright.
		Note: Afin d'obtenir la version et la date du programme,
		      tapez 'VERSION PresTerm FULL' dans un shell.

   @{B}Aide@{UB}		Appel le fichier d'aide au format AmigaGuide à l'index
		principal.

   @{B}Quitter@{UB}	Peut-être bien que c'est la commande du menu pour quitter
		le programme, non?


@{U}Menu 'Emulation':@{UU}
   @{B}TTY@{UB}		Emulation simple avec 80 caractères/ligne et un scrolling.
		Permet un accès aisé pour configurer votre modem.  Les
		seules séquences de contrôle spécial qu'il reconnait sont
		celles pour passer dans une autre émulation.  C'est
		l'émulation par défaut.

   @{B}Prestel@{UB}	Le but de ce programme.  Vous pouvez la sélectionner à
		partir de ce menu avant de vous connecter sur un serveur
		qui n'envoie pas les séquences de basculement.
@ENDNODE

@NODE GADGETS "PresTerm: Gadgets"
De gauche à droite en bas de l'écran:

    @{B}Appel@{UB}	Forme le numéro de téléphone inscrit dans le gadget juste à
		sa droite (décrit ci-dessous) et établit la connection.

    @{B}Tél.@{UB}	Le numéro de téléphone qui est formé lors de l'appel.  Bien
		qu'il s'agit normalement uniquement de chiffres, les autres
		caractères sont également permis.
		Par example:  Le service Videotex belge n'accepte pas les
		              protocoles de compression et de contrôle
		              d'erreurs.  J'utilise donc cette séquence de
		              caractères pour former le numéro et les
		              désactiver sur mon modem USRobotics:
		              1338&K0&M0

    @{B}Raccroch.@{UB}	Termine la connection et raccroche le téléphone.

    @{B}Effacement@{UB}	Efface tous les caractères à l'écran et place le curseur en
		haut à gauche.

    @{B}Capture@{UB}	Capture ce qui est affiché à l'écran et le sauve au format
		spécifié par le gadget suivant.  Si vous voulez imprimer
		l'écran au lieu de le sauver dans un fichier, entrez "PRT:"
		dans le requester de fichier.

    @{B}Format@{UB}	Format du fichier lors de la capture.  ASCII est le format
		texte et IFF le format image 16 couleurs.
@ENDNODE

@NODE KEYS "PresTerm: Touches spéciales"
	@{B}HELP@{UB}	Vous aide à vous remémorer la signification des autres
		touches de fonction.  Leur utilisation est ou peut être
		différente pour chaque émulation activée.  Dans la mesure
		du possible, la signification restera identique, même si
		la séquence de caractères envoyée est différente.


@{U}Emulation TTY:@{UU}
	Aucune.


@{U}Emulation Prestel:@{UU}
	@{B}F1@{UB}	'ESC J'	Confirme la transaction de données collectées.

	@{B}F2@{UB}	'DEL'	Efface le dernier caractère tapé.

	@{B}F3@{UB}	'#'	Page ou champ suivant.

	@{B}F4@{UB}	'*#'	Page précédente.

	@{B}F5@{UB}	'*0#'	Retour à l'écran de début.

	@{B}F6@{UB}	'*00'	Ré-afficher la page courante.

	@{B}F7@{UB}	'**'	Efface le champ.

	@{B}F8@{UB}	'*09'	Répéter.

	@{B}F9@{UB}	'*90#'	Déconnecte la ligne ou coupe la communication avec
			le serveur.

	@{B}F10@{UB}		Montre/cache le texte invisible.

	@{B}HOME@{UB}	'ESC K'	Début d'édition.
	@{B}SHIFT UP@{UB}

	@{B}END@{UB}	'ESC J'	Fin d'édition.
	@{B}SHIFT DOWN@{UB}

	Egalement, la petite touche 'ENTER' sur le pavé numérique est
remplacée par '#' en mode Prestel.  C'est pratique parce-que tous les
caractères de base (qui sont '*', '#' et les chiffres) sont ainsi rassem-
blés en un seul endroit du clavier.
@ENDNODE

@NODE TOOLS "PresTerm: Types d'outils de l'icône"
	Par défaut, le programme utilise les préférences du Workbench pour
communiquer avec le modem, mais celles-ci peuvent être remplacées par des
préférences spécifiques à PresTerm sans toucher au Workbench.  Ceci est
réalisé en définissant des types d'outils dans l'icône.

  Note:	Les trois types d'outils qui suivent sont déja définis et ne
	devraient pas être changé car ils font partie de la définition de
	la norme Prestel.
	> BITSPERBYTE=7
	> PARITY=EVEN
	> STOPBITS=1


@{U}Liste des types d'outils:@{UU}
	DEVICE=<nom du device>
		Signification: Nom du device à utiliser pour accéder au port
		               série.
		Par défaut: serial.device

	UNIT=<numéro d'unité>
		Signification: Unité du device d'accès au port série.
		Par défaut: 0

	BAUDRATE=<vitesse en baud>
		Signification: Vitesse de transfert entre l'ordinateur et
		               le modem.  Indiquez le maximum que votre
		               modem supporte (si votre Amiga peut le
		               suivre).
		Par défaut: ce qui est défini dans les préférences du
		            Workbench.

	BUFFER=<taille du buffer>
		Signification: Taille du buffer de lecture, en octets.
		Par défaut: ce qui est défini dans les préférences du
		            Workbench.

	HANDSHAKING=<RTSCTS | XONXOFF | NONE>
		Signification: Protocole entre l'ordinateur et le modem
		               Utilisez le RTSCTS si votre modem le possède!
		Par défaut: ce qui est défini dans les préférences du
		            Workbench.

	BITSPERBYTE=<longueur d'un octet>
		Signification: 7 ou 8 bits par octet.
		               Utilisez 7 comme défini par Prestel.
		Par défaut: ce qui est défini dans les préférences du
		            Workbench.

	PARITY=<EVEN | ODD | NONE>
		Signification: test de parité.
		               Utilisez EVEN comme défini par Prestel.
		Par défaut: ce qui est défini dans les préférences du
		            Workbench.

	STOPBITS=<nombre de bits de stop>
		Signification: 0 ou 1 bit de stop.
		               Utilisez 1 comme défini par Prestel.
		Par défaut: ce qui est défini dans les préférences du
		            Workbench.

	PHONE=<numéro de téléphone>
		Signification: numéro de téléphone utilisé par défaut lors
		               de l'utilisation du gadget d'appel.
		Par défaut: NULL

	DIAL=<TONE | PULSE>
		Signification: Type de tonalité.  Utilisez TONE si vous
		               êtes relié à une centrale digitale.  Sinon,
		               si votre centrale téléphonique est encore
		               d'un type ancien, utilisez PULSE.
		Par défaut: TONE
@ENDNODE

@NODE AREXX "PresTerm: AREXX"
	Le nom du port AREXX est "PRESTERM".  Toute commande envoyée alors
que le port est fermé est retournée avec une erreur de niveau 100 et le
message "Port closed" dans la variable "PRESTERM.LASTERROR".  Toute commande
inconnue est retournée avec une erreur de niveau 20 et également un message
dans la variable "PRESTERM.LASTERROR".

  Note:	un nombre très restreint de commandes restent activent lorsque le
	soft est icônifié dans le Workbench !!  Elles sont indiquées par un
	(I) à droite du nom de la commande ci-dessous.  De même, (S) signi-
	fie une commande active lorsque l'écran est ouvert normalement.
	Ainsi donc, (S+I) représente une commande toujours accessible.
	Une commande appelée alors qu'elle n'est plus active est considérée
	comme inconnue !!

	Ci-dessous se trouve la liste des commandes AREXX implémentées et
leur signification.  La plupart font la même chôse que leur équivalent sous
forme d'icône ou de menu.


	@{U}CAPTURE@{UU} (S)
		Capture l'écran dans un fichier.
		Si erreur d'écriture du fichier :
			RC = 30.
			PRESTERM.LASTERROR = <message>.

		Résumé     : CAPTURE ASCII <méthode> <nom du fichier>
		              ou
		             CAPTURE IFF <nom du fichier>

		Paramètres : méthode = une des deux méthodes de sauvegarde
		                       (APPEND ou REPLACE).
		             nom du fichier = nom du fichier de destination.

		Résultat   : aucun.


	@{U}CLEARSCR@{UU} (S)
		Efface l'écran et positionne le curseur dans le coin
		supérieur gauche.

		Résumé     : CLEARSCR

		Paramètres : aucun.

		Résultat   : aucun.


	@{U}DELAY@{UU} (S+I)
		Attend le nombre de secondes spécifiées avant de retourner.
		Utilisez cette fonction uniquement pour un nombre très
		limité de secondes car elle bloque le programme qui ne fait
		rien d'autre pendant cette période.  Lors de longues
		périodes d'attente, utilisez WAITSTRING !!

		Résumé     : DELAY <secondes>

		Paramètres : secondes = nombre de secondes d'attente.

		Résultat   : aucun.


	@{U}DIAL@{UU} (S)
		Forme le numéro de téléphone inscrit dans la gadget prévu
		à cet effet.

		Résumé     : DIAL

		Paramètres : aucun.

		Résultat   : aucun.


	@{U}EMULATION@{UU} (S)
		Active une nouvelle émulation.  Notez que changer
		d'émulation efface également l'écran.

		Résumé     : EMULATION <type>

		Paramètres : type = une des émulations disponibles (TTY ou
		                    PRESTEL).

		Résultat   : aucun.


	@{U}GETSCRSTR@{UU} (S)
		Retourne la chaîne de caractères à la position indiquée de
		l'écran et sur une longueur également spécifiée.  La lon-
		gueur est tronquée au bord droit de l'écran.  Il est tout à
		fait permis de spécifier une ligne en dehors de l'écran, le
		résultat est alors une chaîne vide.

		Résumé     : GETSCRSTR <x> <y> <longueur>

		Paramètres : x = colonne de début (1 à 80).
		             y = ligne (1 à 24[Prestel] ou 27[TTY]).
		             longueur = nombre de caractères (1 à 80).

		Résultat   : chaîne de caractères spécifiée de l'écran.


	@{U}HANGUP@{UU} (S)
		Raccroche le téléphone.

		Résumé     : HANGUP

		Paramètres : aucun.

		Résultat   : aucun.


	@{U}ICONIFY@{UU} (S+I)
		Ferme l'écran et le port série et passe en mode icône.
		Si erreur survenue : RC = 30.
		                     PRESTERM.LASTERROR = <message>.

		Résumé     : ICONIFY

		Paramètres : aucun.

		Résultat   : aucun.


	@{U}SENDSTRING@{UU} (S)
		Envoie la chaîne de caractères spécifiée au port série.

		Résumé     : SENDSTRING <chaîne>

		Paramètres : chaîne = la chaîne de caractères à envoyer.
		             Vous pouvez envoyer n'importe quel caractère
		             spécial comme ceci:
		             SENDSTRING 'Hello world !'||'0D'X

		Résultat   : aucun.


	@{U}SETNUMBER@{UU} (S)
		Active un nouveau numéro de téléphone comme si vous
		l'aviez tapé dans le gadget prévu à cet effet.

		Résumé     : SETNUMBER <chaîne>

		Paramètres : chaîne = nouveau numéro de téléphone.

		Résultat   : aucun.


	@{U}TIMEOUT@{UU} (S+I)
		Spécifie le nombre maximum de secondes d'attente d'une
		chaîne de caractères.  La valeur par défaut est de 30
		secondes.  Cfr la commande WAITSTRING pour plus de détails.

		Résumé     : TIMEOUT <secondes>

		Paramètres : secondes = temps en secondes.
		                        0 pour infini.

		Résultat   : aucun.


	@{U}UNICONIFY@{UU} (S+I)
		Ouvre l'écran et le port série et retourne en mode normal.
		Si erreur survenue : RC = 30.
		                     PRESTERM.LASTERROR = <message>.

		Résumé     : UNICONIFY

		Paramètres : aucun.

		Résultat   : aucun.


	@{U}WAITSTRING@{UU} (S)
		Attend qu'une chaîne de caractères spécifiée arrive du port
		série.  Le temps maximum d'attente est établi par la
		commande TIMEOUT.  Si la chaîne n'est pas arrivée dans les
		temps, la commande se termine avec "TIMEOUT" comme résultat.
		Notez que si vous icônifiez le programme alors qu'une chaîne
		est également attendue, la commande se termine avec
		"ICONIFY" comme résultat (parce-que le port série sera
		fermé).

		Résumé     : WAITSTRING <chaîne>

		Paramètres : chaîne = chaîne de caractères à attendre.

		Résultat   : "OK"      = chaîne reçue.
		             "TIMEOUT" = temps d'attente maximum écoulé.
		             "ICONIFY" = l'utilisateur à icônifié le
		                         programme.
@ENDNODE

@NODE BUGS "PresTerm: A propos de bugs"
	Aucun (connu).

	Ce modeste soft à été testé sur:
		A500, A3000, A1200, A4000

	Avec:
		OS2.1, OS3.0, OS3.1
@ENDNODE

@NODE PROBLEMS "PresTerm: Problèmes usuels"
	Le problème principal qui survint lors de mes tests est que le modem
ne répondait plus quand je tapais sur le clavier.  De même le deuxième ou
les deux mots initiaux qui apparaissent normalement à l'écran au démarrage
du soft étaient absents.  Ces deux mots sont la commande du modem 'AT' et sa
réponse 'OK'.  Grâce à ces deux mots, vous savez directement si la communi-
cation avec le modem s'exécute correctement.  Deux causes d'erreur sont
possible:

	1. La vitesse en baud spécifiée dans les préférences du Workbench ou
	   dans les types d'outils de l'icône PresTerm n'est pas suportée
	   par votre modem.  Vérifiez la vitesse DTE/DCE maximum du modem.
	   Vérifiez également les vitesses intermédiaires reconnues.  Une
	   vitesse de 31250 est, par example, prévue dans les préférences du
	   Workbench mais je ne connais aucun modem qui supporte une valeur
	   aussi étrange.

	2. Le protocole RTS/CTS (ou autre) est spécifié mais non reconnu
	   par votre modem (ou désactivé dans sa configuration).  Mettez-le
	   à NONE et ré-essayez.

	N'oubliez pas de relancer le programme afin d'activer les nouvelles
préférences.
@ENDNODE

@NODE FEEDBACK "PresTerm: Retour de courrier"
	N'hésitez pas à me faire parvenir toute remarque, suggestion,
rapport de bugs, améliorations ou autres.

			@{U}                          @{UU}

			  Relie-Art s.c.
			  Rue Stephenson 108-110
			  1210 Bruxelles
			       Belgique

			  Tel+Fax:
			  +32 (0)2 245 3853
			@{U}                          @{UU}
@ENDNODE

@NODE THANKS "PresTerm: Remerciements"
	                        @{B}Merci à...@{UB}



		Belgacom pour la documentation & les tests
	                       @{U}@{B}             @{UB}@{UU}

		      Pascal pour les tests sur A4000
	                       @{U}@{B}             @{UB}@{UU}

	                Carlo pour le test sur A1200
	                       @{U}@{B}             @{UB}@{UU}

	                  Commodore pour l'Amiga
@ENDNODE

@NODE COPYRIGHTS "PresTerm: Copyrights"
    AmigaGuide, AmigaGuide.info, amigaguide.library,
    WDisplay, WDisplay.info, Installer et l'icône projet Installer
    (c) Copyright 1991-93 Commodore-Amiga, Inc.  Tous Droits Réservés.
    Reproduit et distribué sous licence de Commodore.

    LE SOFTWARE AMIGAGUIDE ET INSTALLER EST FOURNI "TEL-QUE" ET SUJET A
    MODIFICATION; AUCUNE GARANTIE EST FOURNIE.  TOUTE UTILISATION EST A
    VOS PROPRES RISQUES.  AUCUN ENGAGEMENT NI RESPONSABILITE EST ASSURE.
@ENDNODE
