path: root/support/xlatex/xlatex.man

.TH XLATEX 1 "24 aout 1994"  "Xlatex Version 3.3c"
.\" so /usr/lib/ms/s.acc

.\" @(#)ms.acc 1.1 86/07/08 SMI; from UCB 4.2
.	\" AM - accent mark definitions
.\" modif accent aigu troff CICB, E. Picheral
.\" modif cedille et trema CICB, E. Picheral
.\" modif ^ et .. , accents majuscules, distinction italique CICB, E. Picheral
.bd S B 3
.	\" fudge factors for nroff and troff
.if n \{\
.	ds #H 0
.	ds #V .8m
.	ds #F .3m
.	ds #[ \f1
.	ds #] \fP
.\}
.if t \{\
.	ds #H (-(1u-(\\\\n(.fu%2u))*.13m)
.	ds #J 0
.	ds #K (-(1u-(\\\\n(.fu%2u))*.08m)
.	ds #L (-(1u-(\\\\n(.fu%2u))*.04m)
.	ds #V .6m
.	ds #W (-(1u-(\\\\n(.fu%2u))*.05m)
.	ds #X (-(1u-(\\\\n(.fu%2u))*.03m)
.	ds #Y -.25m
.	ds #F 0
.	ds #[ \&
.	ds #] \&
.\}
.	\" simple accents for nroff and troff
.if n \{\
.	ds ' "
.	ds ` "
.	ds ^ "
.	ds , "
.	ds ~ "
.	ds ? ?
.	ds ! !
.	ds / "
.	ds : "
.\}
.if t \{\
.	ds ' \\k:\h'-(\\n(.wu*9/10-\*(#J)'\'\h"|\\n:u"
.	ds ` \\k:\h'-(\\n(.wu*8/10-\*(#K)'\v'\*(#W'\`\v'-\*(#W'\h'|\\n:u'
.	ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#L)'^\h'|\\n:u'
.	ds , \\k:\h'-(\\n(.wu*8/10)'\(cd\h'|\\n:u'
.	ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'\v'-.03m'~\v'.03m'\h'|\\n:u'
.	ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
.	ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
.	ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.	ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
.	ds : \\k:\h'-(\\n(.wu*9/10-\*(#K)'\(..\h'|\\n:u'
.	ds G' \\k:\h'-(\\n(.wu*8/10-\*(#J)'\v'\*(#Y'\'\v'-\*(#Y'\h'|\\n:u'
.	ds G` \\k:\h'-(\\n(.wu*7/10-\*(#K)'\v'\*(#Y'\`\v'-\*(#Y'\h'|\\n:u'
.	ds G^ \\k:\h'-(\\n(.wu*8/10-\*(#J)'\v'\*(#Y'^\v'-\*(#Y'\h'|\\n:u'
.	ds G: \\k:\h'-(\\n(.wu*8/10-\*(#J)'\v'\*(#Y'\(..\v'-\*(#Y'\h'|\\n:u'
.\}
.	\" troff and (daisy-wheel) nroff accents
.	\" .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.ds oe o\h'-(\w'o'u*4/10)'e
.ds Oe O\h'-(\w'O'u*4/10)'E
.	\" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.	\" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.	ds : "
.	ds 8 B
.	ds v "
.	ds _ \h'-1'^
.	ds . \h'-1'.
.	ds 3 3
.	ds o a
.	ds d- d\h'-1'\(ga
.	ds D- D\h'-1'\(hy
.	ds th \o'bp'
.	ds Th \o'LP'
.	ds ae ae
.	ds Ae AE
.	ds oe oe
.	ds Oe OE
.\}
.rm #[ #] #H #V #F C

.SH SYNTAXE D'APPEL
.B xlatex 
[\fIarguments\ \ Toolkit\fP]\ \ [\fIarguments\ de\ contro\*^le\fP]\ \ [\fBdocument\fP]

.SH DESCRIPTION
.PP

\fIXlatex\fP est une application X destine\*'e a\*` simplifier le fac\*,onnage
de documents TeX ou LaTeX, a\*` savoir l'exe\*'cution d'une session
d'e\*'dition de texte, la soumission d'un document \fI.tex\fP a\*` un
processeur de \fIfac\*,onnage\fP, l'e\*'preuvage sur e\*'cran par un
\fIvisionneur\fP, l'impression du \fI.dvi\fP par le pilote d'impression
Postscript \fBdvips\fP. La constitution du document \fI.tex\fP est de
l'entie\*`re responsabilite\*' de l'utilisateur.

.SH ARGUMENT
.sp 1
.TP 1c
\fBdocument\fP
chemin d'acce\*`s absolu ou relatif du document LaTeX. Si le suffixe \fI.tex\fP
est spe\*'cifie\*', il est automatiquement enleve\*'. Par de\*'faut, le 
fichier \fBdocument.tex\fP est pris dans le re\*'pertoire courant.
.PP

.SH ARGUMENTS DE CONTROLE
.sp 1
.TP 1c
\fB-gfont\fP\ \ \fIfont\fP
police ge\*'ne\*'rique utilise\*'e dans la pre\*'sentation de l'application
\fIxlatex\fP. Se reporter a\*` la description de la ressource
\fBgenericFont\fP.
.PP


.SH ENVIRONNEMENT DE TRAVAIL PAR DEFAUT
.sp 1
La plupart de ces valeurs peuvent e\*^tre change\*'es par les \fBressources\fP. 

.ta 3c
.sp 1
re\*'pertoire	re\*'pertoire de travail
.sp 0
document	\fBdocument.tex\fP
.sp 0
fac\*,onneur	\fBlatex\fP
.sp 0
visionneur	\fBxdvi\fP
.sp 0
pilote		\fBdvips\fP
.sp 0
dessin		\fBxfig\fP
.sp 0
impression	\fBlpr\fP
.sp 0
imprimante	de\*'finie par la variable d'environnement \fBPRINTER\fP
.sp 0
e\*'diteur	de\*'finie par la variable d'environnement \fBEDITOR\fP
.DT

.SH LA FENETRE XLATEX

La fene\*^tre \fIXlatex\fP est divise\*'e en trois parties :
.RS 1c
- les boutons de commande
.sp 0
- les champs de\*'finissant l'environnement de travail
.sp 0
- une fene\*^tre d'interaction
.RE

.sp 1
.B Les boutons de commande
.sp 1

.TP 2.5c
\fBFACONNER\fP
soumet le document courant au processeur de fac\*,onnage\ ;
.TP 2.5c
\fBDESSINER\fP
active un outil de dessin\ ;
.TP 2.5c
\fBVISIONNER\fP
e\*'preuve le document sur e\*'cran avec le visionneur courant\ ;
.TP 2.5c
\fBDVIPS\fP
ge\*'ne\*'ration du document PostScript\ ;
.TP 2.5c
\fBIMPRIMER\fP
fait apparai\*^tre un formulaire permettant de se\*'lectionner les pages
a\*` imprimer, le nombre de copies, la commande d'impression et ses arguments
optionnels ainsi que l'imprimante.
L'impression doit e\*^tre confirme\*'e en  cliquant dans le
bouton de commande \fIOk\fP ou abandonne\*'e en cliquant dans
\fIAnnuler\fP\ ;
.TP 2.5c
\fBSTATUT IMPR\fP
e\*'tat de la file d'attente de l'imprimante se\*'lectionne\*'e\ ;
.TP 2.5c
\fBE\*'DITEUR\fP
session \fIxterm\fP exe\*'cutant un e\*'diteur de texte sur le document
courant\ ;
.TP 2.5c
\fBQUITTER\fP
sortie de l'application \fIxlatex\fP.
.PP

.sp 2
.B 
Les champs de de\*'finition de l'environnement de travail
.sp 0

Les champs pouvant e\*^tre interactivement modifie\*'s sont :
.RS 1c
.TP 2.5c
\fBre\*'pertoire\fP
re\*'pertoire courant ou\*` se trouvent le ou les documents \fI.tex\fP
.TP 2.5c
\fBdocument\fP
nom du fichier TeX ou LaTeX de re\*'fe\*'rence (sans le suffixe \fI.tex\fP)
.TP 2.5c
\fBdessin\fP
outil de dessin
.TP 2.5c
\fBvisionneur\fP
commande d'e\*'preuvage sur e\*'cran du document. En cliquant dedans on fait
apparai\*^tre une double liste de visionneurs, la premie\*`re liste e\*'tant
relative aux visionneurs \fIDVI\fP a\*` partir du document \fB.dvi\fP 
(ressource \fBvisionneurs\fP), la seconde
aux visionneurs \fIPostScript\fP a\*` partir du document \fB.ps\fP
(ressource \fBvisionneursPS\fP).
.TP 2.5c
\fBfac\*,onneur\fP
commande de fac\*,onnage du document \fI.tex\fP
.TP 2.5c
\fBe\*'diteur\fP
e\*'diteur de texte
.TP 2.5c
\fBpilote\fP
commande d'appel du pilote PostScript (boutons \fBDVIPS\fP et \fBIMPRIMER\fP)
.RE

Le passage d'un champ a\*` l'autre est aussi possible par tabulation 
ou par la touche retour a\*` la ligne.

.PP

.sp 2
.B 
La fene\*^tre d'interaction
.sp 0

La fene\*^tre d'interaction rec\*,oit tous les messages produits par
l'exe\*'cution des commandes telles ques \fIlatex, dvips, xdvi\fP et \fIlpq\fP.
Au besoin, l'utilisateur peut introduire du texte dans cette fene\*^tre pour
s'acquitter de certaines interventions.

Les se\*'quences \fB^C\fP et \fP^D\fP ge\*'ne\*`rent le signal
\fPSIGINT\fP et \fPSIGTERM\fP au processus de \fIfac\*,onnage\fP.


.SH NOTES
.PP
Les commandes associe\*'es aux boutons sont directement exe\*'cute\*'es par
\fIexecv\fP (3) ou \fIexecl\fP (3). En conse\*'quence, ces commandes ne
peuvent e\*^tre des shell-scripts.


.SH ACCELERATEURS
.PP
Utilisables n'importe ou\*` dans la fene\*^tre \fIxlatex\fP, les
acce\*'le\*'rateurs re\*'alisent les me\*^mes actions que les boutons de
commande\ : 
.sp 1
.RS 1c
Meta-f	fac\*,onner
.sp 0
Meta-d	dessiner
.sp 0
Meta-i	imprimer
.sp 0
Meta-v	visionner
.sp 0
Meta-p	postscript
.sp 0
Meta-s	statut d'impression
.sp 0
Meta-e	session d'e\*'dition de texte
.sp 0
Meta-q	quitter l'application
.RE

.SH RESSOURCES
.PP
Les ressources peuvent figurer dans le fichier \fB~/.Xdefaults\fP sous la
forme\ :
.sp 1
	\fBXlatex.<ressource>:	valeur\fP
.sp 1
Les diffe\*'rentes \fB<ressources>\fP sont\ :
.TP 2.5c
\fBrepertoireInitial\fP
re\*'pertoire de travail
.TP 2.5c
\fBfaconneur\fP
commande de fac\*,onnage des documents (\fBlatex\fP par de\*'faut)
.TP 2.5c
\fBvisionneurs\fP
liste des visionneurs (se\*'pare\*'s par un espace ou une virgule)
travaillant a\*` partir du fichier \fB.dvi\fP. Un aste\*'risque pre\*'ce\*'dant
une entre\*'e de\*'signe le visionneur par de\*'faut.
.TP 2.5c
\fBediteur\fP
e\*'diteur de texte (celui de\*'fini dans la variable d'environnement
\fBEDITOR\fP par de\*'faut). Voir la ressource associe\*'e
\fBediteurAvecXterm\fP
.TP 2.5c
\fBpilote\fP
commande d'appel du pilote PostScript (\fBdvips\fP) par de\*'faut)
.TP 2.5c
\fBimpression\fP
commande d'impression du document PostScript (\fBlpr\fP par de\*'faut)
.TP 2.5c
\fBdessin\fP
commande de dessin (\fBxfig\fP par de\*'faut)
.TP 2.5c
\fBediteurAvecXterm\fP
indique s'il faut appeler l'e\*'diteur de texte sous le contro\*^le d'une
session \fBxterm\fP ou pas (\fBtrue\fP par de\*'faut, il en est ainsi pour tous
les e\*'diteurs qui ne sont pas une application X)

.PP
.SH EXEMPLES DE RESSOURCES
.sp 1
Xlatex.visionneurs:	xdvi, texx
.sp 1
Xlatex.visionneurPS:	ghostview, *gs
.sp 1
.DT

Les ressources standard \fBbitmap\fP des boutons de commande peuvent e\*^tre
positionne\*'es\ :
.sp 1
Xlatex*faconner.bitmap:	xlatex.faconner
.sp 0
Xlatex*visionner.bitmap:	xlatex.visionner
.sp 0
Xlatex*imprimer.bitmap: xlatex.imprimer
.sp 0
Xlatex*dessiner.bitmap:	xlatex.dessiner
.sp 0
Xlatex*editer.bitmap:	xlatex.editer
.sp 0
Xlatex*statut.bitmap:	xlatex.statut
.sp 0
Xlatex*quitter.bitmap:	xlatex.quitter
.sp 1

.PP
.SH HIERARCHIE DES WIDGETS
.sp 1
.ta 2c 3c 4c 5c 6c 7c 8c 9c
.sp 0
Xlatex  xlatex
.sp 0
	Form  form
.sp 0
		Command  editer
.sp 0
		Command  dessiner
.sp 0
		Command  faconner
.sp 0
		Command  visionner
.sp 0
		Command  postscript
.sp 0
		Command  imprimer
.sp 0
		Command  statut
.sp 0
		Command  quitter
.sp 0
		Label  repertoireLab
.sp 0
		Text  repertoire
.sp 0
		Label  dessinLab
.sp 0
		Text  dessin
.sp 0
		Label  documentLab
.sp 0
		Text  document
.sp 0
		Label  visionneursLab
.sp 0
		MenuButton  visionneurs
.sp 0
			SimpleMenu  menuVisionneurs
.sp 0
				SmeBSB  xdvi
.sp 0
				SmeBSB  texx
.sp 0
				SmeLine  separateur
.sp 0
				SmeBSB  ghostview
.sp 0
				SmeBSB  gs
.sp 0
		Label  faconneurLab
.sp 0
		Text  faconneur
.sp 0
		Label  editeurLab
.sp 0
		Text  editeur
.sp 0
		Label  piloteLab
.sp 0
		Text  pilote
.sp 0
		Text  interaction
.sp 0
		TransientShell  popup
.sp 0
			Form  form
.sp 0
				Label  impressionLab
.sp 0
				Text  impression
.sp 0
				Label  imprimanteLab
.sp 0
				Text  imprimante
.sp 0
				Toggle  toutesTog
.sp 0
				Label  toutesLab
.sp 0
				Toggle  deTog
.sp 0
				Label  deLab
.sp 0
				Text  de
.sp 0
				Label  aLab
.sp 0
				Text  a
.sp 0
				Command  ok
.sp 0
				Command  annuler
.sp 0
				Label  copiesLab
.sp 0
				Text  copies
.sp 0
.PP
.SH FICHIERS
.sp 0
/usr/lib/X11/app-defaults/Xlatex
.sp 0
~/.Xdefaults


.SH PROBLEMES RECENCES
.sp 1
Lorsque \fBXlatex\fP se termine, il envoie le signal de terminaison \fBSIGTERM\fP 
au groupe de processus qu'il domine. Cependant si certains d'entre eux ont cre\*'e 
un nouveau groupe ou une session, ce signal ne sera pas effectif.

.SH AUTEUR
.PP
Mario Dragone
.br
IUP Vannes (France)
.br

Envoyer commentaires et rapports d'anomalies a\*`\ :
.sp 1
	dragone@iu-vannes.fr