.TH DIALOG 1 "1994. Jnius 10." "Dialog Verzi 0.4"
.SH NV
dialog \- prbeszddobozokat jelent meg shell-scriptekben
.SH TTEKINTS
.B dialog --clear
.br
.BI "dialog --create-rc " fjl
.br
.B dialog
[
.B \-\-title
.I cm
]
[
.B \-\-backtitle
.I httrcm
]
[
.B \-\-clear
]
[
.B \-\-separate\-output
]
.B doboz-opcik
.SH LERS
A
.B dialog
olyan program, aminek segtsgvel sokfle krdst vagy kpernyzenetet
lehet megjelenteni, prbeszddobozok segtsgvel, egy shell-scriptbl.
Jelenleg a kvetkez tpus prbeszddobozok alkalmazhatk:
.LP
.BR igen/nem " doboz," " men" " doboz," " bevitel" " doboz,"
.BR zenet " doboz," " szveg" " doboz," " inf" " doboz,"
.BR vlasztlista " doboz," " rdilista" " doboz s" " mrtk" " doboz."
.SH OPCIK
.TP
.B \-\-clear
A kperny a 
.BR kperny-attribtumnak 
megfelelen  trldik kilpskor.
.TP
.BI \-\-create-rc " fjl"
.RB "Mivel a " dialog " lehetv teszi a futs kzbeni konfigurlst,"
ezt felhasznlhatjuk egy minta konfigurcis fjl ltrehozsra, ennek neve
.IR fjl "."
.TP
.BI \-\-separate\-output
A vlasztlista-kpernyelemeknl a kimenet csak egy sort szolgltat egyszerre,
idzjelek nlkl. Ez megknnyti ms programok szmra a tovbbfeldolgozst.
.TP
.BI \-\-title " cm"
Belltja a
.I cm
szvegt, ami a prbeszddoboz tetejn jelenik meg.
.TP
.BI \-\-backtitle " httrcm"
Belltja a
.I httrcm
szvegt, ami a kperny tetejn, a httrben fog megjelenni.
.TP
.B Doboz-opcik
.TP
.BI \-\-yesno " szveg magassg szlessg"
.RB Egy " igen/nem" " prbeszddobozt jelent meg, a "
.I magassg
ltal megadott sor- s a
.I szlessg
ltal megadott oszlopszmmal. A
.I szveg
a prbeszddoboz belsejben fog megjelenni. Ha a szveg tl hossz ahhoz, hogy
egy sorban elfrjen, akkor automatikusan feldaraboldik a megfelel helyeken.
A
.I szveg
karakterlnc ezen kvl tartalmazhat egy
.I
"\en"
vagy 
.I `\en\'
jsor al-karakterlncot is a sortrs pontos vezrlsre. Ez a tpus doboz
jl hasznlhat olyan krdsek felttelre, amelyek a felhasznltl egy egyszer
igen vagy nem vlaszt vrnak.
.RB "A prbeszddoboz tartalmaz egy" " Yes" " s egy " No
(Igen / Nem) gombot, melyek kztt a felhasznl a
.IR TAB " billenty lenyomsval vlthat."
.TP
.BI \-\-msgbox " szveg magassg szlessg"
.RB Az " zenet" " doboz nagyon hasonlt az " " igen/nem" " dobozhoz."
Az egyetlen eltrs az
.B zenet
doboz s az
.B igen/nem
doboz kztt az, hogy az 
.B zenet
doboznak csak egyetlen 
.B OK
gombja van. Ez a doboz felhasznlhat brmilyen zenet kiratsra.
Miutn elolvasta az zenetet, a felhasznl lenyomhatja az
.I ENTER
billentyt, ezltal a
.B dialog
kilp s a hv shell folytathatja a mkdst.
.TP
.BI \-\-infobox " szveg magassg szlessg"
.RB Egy " inf" " doboz alapveten egy " " zenet" " doboz."
Ebben az esetben azonban a
.B dialog
az zenet megjelentse utn azonnal kilp. A kpernyt nem trli le a
.B dialog
kilpskor, gy az zenet addig ott marad, amg a hv shell le nem trli
azt ksbb. Ez akkor hasznos, ha informlni akarjuk a felhasznlt arrl, 
hogy bizonyos mg foly mveletek ignyelhetnek kis idt a befejezdskhz.
.TP
.BI \-\-inputbox " szveg magassg szlessg [alapszveg]"
.RB "Az " input " doboz akkor hasznos, ha olyan krdseket akarunk feltenni,"
amire a felhasznlnak egy szveggel kell vlaszolnia. Ha az alapszveg is meg
van adva, akkor ez lesz az alaprtelmezett vlasz-karakterlnc.  
A szveg bevitelekor a
.I BACKSPACE
gombot hasznlhatjuk a gpelsi hibk javtsra. Ha a bert szveg hosszabb
annl, hogy belefrjen a beviteli mezbe, akkor az elgrdl. Kilpskor a bevitt
szveg a 
.IR stderr " hibacsatornra rdik ki."
.TP
.BI \-\-textbox " fjl magassg szlessg"
.RB A " szvegdoboz" " segtsgvel egy szvegfjl tartalmt jelenthetjk meg"
egy ablakban. Ez olyan, mint egy egyszer szvegnzke. A felhasznl mozoghat
a fjlban a
.IR FEL/LE ", " PGUP/PGDN 
.RI s " HOME/END" " billentykkel, amelyek a legtbb billentyzeten megtallhatk."
Ha a sorok tl hosszak ahhoz , hogy kifrjenek az ablakban, akkor a
.I BAL/JOBB
gombok hasznlhatk a szvegterlet vzszintes elmozgatsra. A tovbbi knyelem
szempontjbl az elre- s htrairny keressi funkcikat is megvalstottk.
.IP "\fB\-\-menu \fIszveg magassg szlessg men-magassg \fR[ \fIcmke ttel \fR] \fI..."
Ahogy a neve is mondja, a
.B men
doboz egy olyan prbeszddoboz, amely megjelent egy vlasztsi listt, amelybl
a felhasznl vlaszthat. Minden menpont egy
.IR cmke " karakterlncbl s egy " ttel " karakterlncbl ll. A"
.I cmke
egy nevet ad a menpontnak, ami megklnbzteti a tbbi bejegyzstl.
A
.I ttel
egy rvid lersa annak az opcinak, amit a menpont jelent. A felhasznl
mozoghat a menpontok kztt a
.I FEL/LE
nyilak lenyomsval, a
.I cmke
els betjnek mint forrbillentynek a lenyomsval, vagy az
.IR 1-9 " szmbillentykkel. Ltezik"
.I men-magassg
bejegyzs is, ami megadja, hny menpont legyen egyszerre kirva, de a men
elgrdl, ha ennl tbb bejegyzs van. Amikor a
.B dialog
kilp, a
.I cmke
a kivlasztott menpontbl kirdik a 
.IR stderr " hibacsatornra."
.IP "\fB\-\-checklist \fIszveg magassg szlessg lista-magassg \fR[ \fIcmke ttel llapot \fR] \fI..."
.RB "A " vlasztlista " hasonlt a " men " dobozhoz abban, hogy "
tbb lehetsg kzl vlaszthatunk egy men formjban. Ahelyett azonban, hogy
vlasztannk egyet a menpontok kzl, minden bejegyzst ki- vagy bekapcsolhat
a felhasznl. Az eredeti ki/be llapotot az
.IR llapot " szablyozza."
Kilpskor azok a
.I cmke
karakterlncok lesznek kirva a
.IR stderr
hibacsatornra, amelyeknek llapota bekapcsolt.
.IP "\fB\-\-rdilista \fIszveg magassg szlessg lista-magassg \fR [ \fIcmke ttel llapot \fR] \fI..."
.RB "A " rdilista " doboz hasonl a " men " dobozhoz. Az egyetlen eltrs az,
hogy bellthat, melyik menpont van jelenleg kivlasztva, az
.IR llapot " tvltsval " on "-ra."

.IP "\fB\-\-gauge \fIszveg magassg szlessg szzalk\fR"
.RB "A " mrtk " doboz egy mrtksvot jelent meg a doboz aljn.
A sv jelzi a szzalkrtket. j rtkeket a szabvnyos bemenetrl lehet 
beolvasni, egy egsz szmot soronknt. A sv frisstdik, hogy jelezze az
j szzalkrtket. Ha a bemenet XXX, a kvetkez sorokat egszen a kvetkez
XXX-ig egy j prompt-hoz hasznlja fel a program. A bemeneten rkez EOF jelre 
fejezdik be a sv mkdse.

.SH FUTS KZBENI KONFIGURCI
.TP 4
1.
Ksztsnk egy plda konfigurcis fjlt a kvetkezk begpelsvel:
.LP
.in +1i
"dialog --create-rc <fjl>"
.TP 4
2.
Indulskor a
.B dialog
a kvetkezkppen hatrozza meg a belltsokat:
.RS
.TP 4
a)
ha a
.B DIALOGRC
krnyezeti vltoz be van lltva, ennek rtke adja meg a konfigurcis fjl
nevt.
.TP 4
b)
ha az (a) alatti fjl nem tallhat, a
.I $HOME/.dialogrc
fjl-t hasznlja fel mint konfigurcis fjlt.
.TP 4
c)
ha a (b) alatti fjl sem tallhat, akkor a fordtskori alaprtkeket hasznlja.
.RE
.TP 4
3.
Szerkesszk a minta konfigurcis fjlt s msoljuk olyan helyre, amit a
.B dialog
megtall, a 2. lpsben lertak szerint.
.SH KRNYEZET
.TP 15
.B DIALOGRC
lltsuk be ezt a vltozt, ha meg kvnjuk adni a hasznland konfigurcis fjl 
helyt.
.SH FJLOK
.TP 20
.I $HOME/.dialogrc
alaprtelmezett konfigurcis fjl
.SH DIAGNOSZTIKA
A kilpsi kd 0, ha a 
.BR dialog " a " Yes "-el vagy az " OK
gomb lenyomsval rt vget, s 1, ha a
.BR No " vagy a " Cancel
gomb volt lenyomva. Egybknt, ha hiba fordul el a
.B dialog
-on bell vagy a
.B dialog
az
.I ESC
billenty lenyomsra lpett ki, a kilpsi kd -1.
.SH HIBK
A
.I tab
karaktereket tartalmaz szvegfjl-ok problmt okozhatnak a 
.B szveg
dobozban. A
.I tab
karaktereket elzleg szkzz kell alaktani, ha meg akarjuk
.RB "jelenteni egy " szveg " dobozban."
.TP
A kpernyfrissts tl lass.
.SH SZERZ
Savio Lam (lam836@cs.cuhk.hk) - 0.3 verzi
.LP
Stuart Herbert (S.Herbert@sheffield.ac.uk) - patch a 0.4 verzihoz
.SH MAGYAR FORDTS
Szijjrt Lszl <laca@janus.gimsz.sulinet.hu>