.\" Copyright (c) 1991-98 Lectra-Systemes
.\" $Id: xtel.man,v 1.10 1998/10/02 15:09:58 pierre Exp $
.TH XTEL 1 "Lectra-Systemes" "10/98"
.UC 5
.SH NOM
xtel \- Emulateur MINITEL 
.SH SYNOPSIS
xtel [-petit] [-ng] [-br] [-low] [-e] [-serveur serveur_xtel] [-service service_xtel] [options_standards Xt] [fichier_videotex]
.SH DESCRIPTION
.I xtel
est un mulateur de Minitel 1B/2 ou TVR (Tltel Vitesse Rapide destin  
X11R4/R5/R6 . Il permet de plus la sauvegarde et le dcodage hors-ligne de 
pages vidotex. Ce client fonctionne sur cran couleur, niveaux de gris ou 
bien monochrome.
.SH OPTIONS
.TP
.B "\-ng"
 Niveaux de gris : dans le cas d'un cran couleur, on utilise des niveaux de gris
et non pas des couleurs (comme sur le vrai Minitel).
.TP
.B "\-petit"
 Petit ecran : la taille de l'cran d'mulation est de 320 x 250 pixels. Cela tient
moins de place mais c'est peu lisible dans le cas d'un cran monochrome de taille
courante (15" ou 16").
.TP
.B "\-serveur"
 Nom de la machine serveur (supportant xteld). On peut galement spcifier 
le nom du serveur par la ressource \fBserveur\fP .
.TP
.B "\-service"
 Nom du service de \fI/etc/services\fP a utiliser. On peut galement spcifier le
nom du service par la ressource \fBnomService\fP .
.TP
.B "\-br"
 Permet de spcifier la prsence du bouton \fIRaccrocher\fP dans le popup-menu du
clavier Minitel (utilise si le modem ne gre pas le signal DCD).
.TP
.B "\-low"
 Supprime l'affichage des jolis boutons (et limite la consommation mmoire). 
.TP
.B "\-e, --exec-procedure"
 Nom de la procdure a dmarrer au lancement de XTel. Cette procdure doit
tre dfinie dans le fichier \fI$HOME/.xtel/procedures\fP 
(ou \fI$HOME/.xtelproc\fP par compatibilit).
.TP
.B "\-private"
 Force l'utilisation d'une colormap prive ( utiliser dans le cas d'un nombre
insuffisant de couleurs disponible dans la colormap par dfaut).
.SH UTILISATION
.LP
Aprs lancement du programme, on peut slectionner 3, 4, 5 ou 6 menus droulants 
en haut de la fentre. 
.LP
Le menu 
.B Fichier
contient les entres :
.sp
.I "Charge l'enregistrement"
 Charge un enregistrement en mmoire (il sera exploit grce  la fonction \fIlecteur\fP
du menu suivant) .
.sp
.I "Sauve l'enregistrement"
 Sauve ce qui a t enregistr sur un fichier.
.sp
.I "Imprime"
 Imprime la page courante.
.sp
.I "Quitte"
 Quitte le programme.
.LP 2
Le menu 
.B Enregistrement
Permet de controler l'enregistrement des pages Vidotex. Il contient les entres :
.sp
.I "Nouvel enregistrement"
 Initialise la zone d'enregistrement (ce qui tait enregistr est perdu).
.sp
.I "Demarre"
 Valide l'enregistrement, tout ce qui est affich sur l'cran est sauv en memoire.
.sp
.I "Arrte"
 Stoppe l'enregistrement
.sp
.I "Lecteur"
 Appele le lecteur d'enregistrement (fonction magntoscope). Les fonctions du 
lecteur sont :
.LP
.in +7
.nf
|<<        Dbut de page
<<         Page prcdente
[]         Stop
>          Lecture
>>         Page suivante	
.fi
.in -7
.sp
.PP
Le lecteur permet de suspendre la lecture sur le caractres \fIForm Feed\fP 
(qui reprsente un changement de page en Vidotex) ou bien la commande 
\fISUITE\fP souvent utilise pour afficher les informations suivantes. Les
deux conditions peuvent tre combines (SUITE ou FF). La valeur par dfaut 
est \fI"Pas d'arrt"\fP, il faut cliquer sur cette chaine pour dfinir une
condition d'arrt.
.LP 2
Le menu 
.B Services
est cr au dbut en interrogeant le dmon \fIxteld\fP . Dans le cas ou le modem est
un Minitel 1/1B, ce menu n'est pas affich (l'utilisateur compose a la main). Pour
tablir la connexion avec le service, il faut OBLIGATOIREMENT utiliser le bouton
CONNEXION/FIN de XTEL (et non celui du Minitel). Par contre, on peut librer la ligne
en utilisant le bouton CX/FIN du Minitel.
.LP 2
Le menu 
.B Procdures
est cr si le fichier \fI$HOME/.xtel/procedures\fP (ou 
\fI$HOME/.xtelproc\fP)
existe. Il permet de definir des procedures
d'interrogation de serveurs Tltel (composition puis envoi automatique de chaines
ou de touches Minitel sur reconnaissance d'un texte particulier). 
.sp
Dans le cas ou le modem est un M1/M1B, l'utilisateur devra composer  la main le
numro du service et slectionner la procdure pour tablir la connexion (au lieu 
d'utiliser le CONNEXION/FIN).
.LP
La syntaxe du fichier \fIprocedures\fP est la suivante :
.sp
.in +7
.nf

procedure nom_de_procdure
service numro_de_service
liste_de_commandes

.fi
.in -7
.LP
Les commandes disponibles sont les suivantes avec les raccourcis (une lettre)
entre parenthses. Les raccourcis choisis font en sorte que les fichiers
dja ecrits avec une version antrieure soient compatibles.
.sp
.in +7
.nf
	waitfor	chaine_de_caractres	(A)
	transmit chaine_de_caractres	(E)
	record on/off			(R)
	write nom_de_fichier		(W)
	hangup				(H)
	exit				(X)
.fi
.in -7
.PP
Pour mettre des commandes Minitel (ENVOI, RETOUR, etc), on utilise la syntaxe
suivante dans la chaine  mettre :
.sp
.in +7
.nf
	ENVOI                 \\A
	RETOUR                \\B
	REPETITION            \\C
	GUIDE                 \\D
	ANNULATION            \\E
	SOMMAIRE              \\F
	CORRECTION            \\G
	SUITE                 \\H
	CONNEXION_FIN         \\I
.fi
.in -7
.LP
Par exemple :
.sp
.in +7
.nf

P Ficheux
S 3611
waitfor reste
record on
transmit FICHEUX\\H\\HBORDEAUX\\A
waitfor Suite
write /tmp/f.vdt
record off
exit

.fi
.in -7
.LP
.PP
Par exemple, la procdure \fIFicheux\fP recherche le numro de l'abonne FICHEUX
sur l'annuaire lectronique, enregistre le rsultat dans le fichier 
\fI/tmp/f.vdt\fP et sort de \fIXTel\fP.

.sp

.LP 2
Le menu 
.B Protocoles
permet d'utiliser des protocoles pour tlcharger des fichiers  travers XTel.
Ce menu existe si le fichier \fI$HOME/.xtel/protocols\fP
(ou \fI$HOME/.xtelproto\fP)
existe. 
.LP
La syntaxe du fichier \fIprotocoles\fP est la suivante :
.sp
.in +7
.nf

Nom_de_protocole,Nom_de_la_commande

.fi
.in -7
.LP
La commande correspond  un excutable permettant de grer le protocole 
spcifi, par exemple:
.sp
.in +7
.nf

Z-Modem,/usr/bin/rz

.fi
.in -7
.LP
La commande doit utiliser \fBstdin/stdout\fP pour ses entres/sorties et 
afficher les messages eventuels sur \fBstderr\fP.
.LP 2
Le menu 
.B Xtel
permet d'obtenir des informations sur la version et la configuration du programme.
.LP 2
L'emulation des touches du Minitel (Envoi, Retour, etc...) est realise par un 
popup-menu accessible par \fBBouton 2\fP. Les raccourcis clavier sont indiqus dans
le menu. Ce meme menu permet de selectionner le mode d'mulation (Vidotex,
Tl-informatique ASCII, Tl-informatique franais). A partir de la version
3.1, les touches sont galement accessible directement en dessous de l'ecran
Minitel (sauf si l'option \fBlowMemory\fP est active).
.sp
XTEL fait de la reconnaissance de chaine de caractres dans la page Minitel, c'est 
dire que l'on peut cliquer
.B directement
dans la page les chaines correspondant aux touches Minitel (Envoi, Retour, etc...) ou 
par dfaut aux valeurs a saisir (\fBBouton 1\fP).
.sp
On peut obtenir une approximation ASCII de la page courante sur la sortie standard en 
cliquant sur \fBBouton 3\fP.
.SH RESSOURCES
XTEL utilise les ressources spcifiques suivantes :
.PP
.TP 8
.B petiteFonte 
 Spcifie la petite fonte (void option -petit)
.TP 8
.B serveur 
 Spcifie le serveur XTEL (void option -serveur)
.TP 8
.B commandeImpression 
 Spcifie la commande pour imprimer la page courante
.TP 8
.B nomService
 Spcifie le nom du service TCP (xtel, par defaut)
.TP 8
.B boutonRaccrocher
 Spcifie la presence du bouton "Raccrocher"
.TP 8
.B lowMemory
 Pas de jolis boutons
.TP 8
.B privateColormap
 Force une colormap prive
.SH "VOIR AUSSI"
X(1) xteld
.SH BUGS
.LP
Le dcodage des pages photographiques (TVR) est certainement incomplet. De plus
l'allocation des couleurs sur un ecran 256 couleurs peut poser des problmes
en cas d'images JPEG affiches sur une mme page.
.SH FICHIERS
.in +7
.nf
/usr/X11R6/lib/X11/app-defaults/XTel
/usr/X11R6/lib/X11/app-defaults/XTelm
$HOME/.xtel/procedures
$HOME/.xtel/protocols
.fi
.in -7
.SH COPYRIGHT
Copyright 1991-98, LECTRA-SYSTEMES et Pierre FICHEUX
.SH AUTEUR
Pierre FICHEUX  R&D  LECTRA-SYSTEMES ZI Marticot 33610 Cestas FRANCE