.TH DIALOG 1 "1994. Június 10." "Dialog Verzió 0.4"
.SH NÉV
dialog \- párbeszéddobozokat jelenít meg shell-scriptekben
.SH ÁTTEKINTÉS
.B dialog --clear
.br
.BI "dialog --create-rc " fájl
.br
.B dialog
[
.B \-\-title
.I cím
]
[
.B \-\-backtitle
.I háttércím
]
[
.B \-\-clear
]
[
.B \-\-separate\-output
]
.B doboz-opciók
.SH LEÍRÁS
A
.B dialog
olyan program, aminek segítségével sokféle kérdést vagy képernyőüzenetet
lehet megjeleníteni, párbeszéddobozok segítségével, egy shell-scriptből.
Jelenleg a következő típusú párbeszéddobozok alkalmazhatók:
.LP
.BR igen/nem " doboz," " menü" " doboz," " bevitel" " doboz,"
.BR üzenet " doboz," " szöveg" " doboz," " infó" " doboz,"
.BR választólista " doboz," " rádiólista" " doboz és" " mérték" " doboz."
.SH OPCIÓK
.TP
.B \-\-clear
A képernyő a 
.BR képernyő-attribútumnak 
megfelelően  törlődik kilépéskor.
.TP
.BI \-\-create-rc " fájl"
.RB "Mivel a " dialog " lehetővé teszi a futás közbeni konfigurálást,"
ezt felhasználhatjuk egy minta konfigurációs fájl létrehozására, ennek neve
.IR fájl "."
.TP
.BI \-\-separate\-output
A választólista-képernyőelemeknél a kimenet csak egy sort szolgáltat egyszerre,
idézőjelek nélkül. Ez megkönnyíti más programok számára a továbbfeldolgozást.
.TP
.BI \-\-title " cím"
Beállítja a
.I cím
szövegét, ami a párbeszéddoboz tetején jelenik meg.
.TP
.BI \-\-backtitle " háttércím"
Beállítja a
.I háttércím
szövegét, ami a képernyő tetején, a háttérben fog megjelenni.
.TP
.B Doboz-opciók
.TP
.BI \-\-yesno " szöveg magasság szélesség"
.RB Egy " igen/nem" " párbeszéddobozt jelenít meg, a "
.I magasság
által megadott sor- és a
.I szélesség
által megadott oszlopszámmal. A
.I szöveg
a párbeszéddoboz belsejében fog megjelenni. Ha a szöveg túl hosszú ahhoz, hogy
egy sorban elférjen, akkor automatikusan feldarabolódik a megfelelő helyeken.
A
.I szöveg
karakterlánc ezen kívül tartalmazhat egy
.I
"\en"
vagy 
.I `\en\'
újsor al-karakterláncot is a sortörés pontos vezérlésére. Ez a típusú doboz
jól használható olyan kérdések feltételére, amelyek a felhasználótól egy egyszerű
igen vagy nem választ várnak.
.RB "A párbeszéddoboz tartalmaz egy" " Yes" " és egy " No
(Igen / Nem) gombot, melyek között a felhasználó a
.IR TAB " billentyű lenyomásával válthat."
.TP
.BI \-\-msgbox " szöveg magasság szélesség"
.RB Az " üzenet" " doboz nagyon hasonlít az " " igen/nem" " dobozhoz."
Az egyetlen eltérés az
.B üzenet
doboz és az
.B igen/nem
doboz között az, hogy az 
.B üzenet
doboznak csak egyetlen 
.B OK
gombja van. Ez a doboz felhasználható bármilyen üzenet kiíratására.
Miután elolvasta az üzenetet, a felhasználó lenyomhatja az
.I ENTER
billentyűt, ezáltal a
.B dialog
kilép és a hívó shell folytathatja a működését.
.TP
.BI \-\-infobox " szöveg magasság szélesség"
.RB Egy " infó" " doboz alapvetően egy " " üzenet" " doboz."
Ebben az esetben azonban a
.B dialog
az üzenet megjelenítése után azonnal kilép. A képernyőt nem törli le a
.B dialog
kilépéskor, így az üzenet addig ott marad, amíg a hívó shell le nem törli
azt később. Ez akkor hasznos, ha informálni akarjuk a felhasználót arról, 
hogy bizonyos még folyó műveletek igényelhetnek kis időt a befejeződésükhöz.
.TP
.BI \-\-inputbox " szöveg magasság szélesség [alapszöveg]"
.RB "Az " input " doboz akkor hasznos, ha olyan kérdéseket akarunk feltenni,"
amire a felhasználónak egy szöveggel kell válaszolnia. Ha az alapszöveg is meg
van adva, akkor ez lesz az alapértelmezett válasz-karakterlánc.  
A szöveg bevitelekor a
.I BACKSPACE
gombot használhatjuk a gépelési hibák javítására. Ha a beírt szöveg hosszabb
annál, hogy beleférjen a beviteli mezőbe, akkor az elgördül. Kilépéskor a bevitt
szöveg a 
.IR stderr " hibacsatornára íródik ki."
.TP
.BI \-\-textbox " fájl magasság szélesség"
.RB A " szövegdoboz" " segítségével egy szövegfájl tartalmát jeleníthetjük meg"
egy ablakban. Ez olyan, mint egy egyszerű szövegnézőke. A felhasználó mozoghat
a fájlban a
.IR FEL/LE ", " PGUP/PGDN 
.RI és " HOME/END" " billentyűkkel, amelyek a legtöbb billentyűzeten megtalálhatók."
Ha a sorok túl hosszúak ahhoz , hogy kiférjenek az ablakban, akkor a
.I BAL/JOBB
gombok használhatók a szövegterület vízszintes elmozgatására. A további kényelem
szempontjából az előre- és hátrairányú keresési funkciókat is megvalósították.
.IP "\fB\-\-menu \fIszöveg magasság szélesség menü-magasság \fR[ \fIcímke tétel \fR] \fI..."
Ahogy a neve is mondja, a
.B menü
doboz egy olyan párbeszéddoboz, amely megjelenít egy választási listát, amelyből
a felhasználó választhat. Minden menüpont egy
.IR címke " karakterláncból és egy " tétel " karakterláncból áll. A"
.I címke
egy nevet ad a menüpontnak, ami megkülönbözteti a többi bejegyzéstől.
A
.I tétel
egy rövid leírása annak az opciónak, amit a menüpont jelent. A felhasználó
mozoghat a menüpontok között a
.I FEL/LE
nyilak lenyomásával, a
.I címke
első betűjének mint forróbillentyűnek a lenyomásával, vagy az
.IR 1-9 " számbillentyűkkel. Létezik"
.I menü-magasság
bejegyzés is, ami megadja, hány menüpont legyen egyszerre kiírva, de a menü
elgördül, ha ennél több bejegyzés van. Amikor a
.B dialog
kilép, a
.I címke
a kiválasztott menüpontból kiíródik a 
.IR stderr " hibacsatornára."
.IP "\fB\-\-checklist \fIszöveg magasság szélesség lista-magasság \fR[ \fIcímke tétel állapot \fR] \fI..."
.RB "A " választólista " hasonlít a " menü " dobozhoz abban, hogy "
több lehetőség közül választhatunk egy menü formájában. Ahelyett azonban, hogy
választanánk egyet a menüpontok közül, minden bejegyzést ki- vagy bekapcsolhat
a felhasználó. Az eredeti ki/be állapotot az
.IR állapot " szabályozza."
Kilépéskor azok a
.I címke
karakterláncok lesznek kiírva a
.IR stderr
hibacsatornára, amelyeknek állapota bekapcsolt.
.IP "\fB\-\-rádiólista \fIszöveg magasság szélesség lista-magasság \fR [ \fIcímke tétel állapot \fR] \fI..."
.RB "A " rádiólista " doboz hasonló a " menü " dobozhoz. Az egyetlen eltérés az,
hogy beállítható, melyik menüpont van jelenleg kiválasztva, az
.IR állapot " átváltásával " on "-ra."

.IP "\fB\-\-gauge \fIszöveg magasság szélesség százalék\fR"
.RB "A " mérték " doboz egy mértéksávot jelenít meg a doboz alján.
A sáv jelzi a százalékértéket. Új értékeket a szabványos bemenetről lehet 
beolvasni, egy egész számot soronként. A sáv frissítődik, hogy jelezze az
új százalékértéket. Ha a bemenet XXX, a következő sorokat egészen a következő
XXX-ig egy új prompt-hoz használja fel a program. A bemeneten érkező EOF jelre 
fejeződik be a sáv működése.

.SH FUTÁS KÖZBENI KONFIGURÁCIÓ
.TP 4
1.
Készítsünk egy példa konfigurációs fájlt a következők begépelésével:
.LP
.in +1i
"dialog --create-rc <fájl>"
.TP 4
2.
Induláskor a
.B dialog
a következőképpen határozza meg a beállításokat:
.RS
.TP 4
a)
ha a
.B DIALOGRC
környezeti változó be van állítva, ennek értéke adja meg a konfigurációs fájl
nevét.
.TP 4
b)
ha az (a) alatti fájl nem található, a
.I $HOME/.dialogrc
fájl-t használja fel mint konfigurációs fájlt.
.TP 4
c)
ha a (b) alatti fájl sem található, akkor a fordításkori alapértékeket használja.
.RE
.TP 4
3.
Szerkesszük a minta konfigurációs fájlt és másoljuk olyan helyre, amit a
.B dialog
megtalál, a 2. lépésben leírtak szerint.
.SH KÖRNYEZET
.TP 15
.B DIALOGRC
Állítsuk be ezt a változót, ha meg kívánjuk adni a használandó konfigurációs fájl 
helyét.
.SH FÁJLOK
.TP 20
.I $HOME/.dialogrc
alapértelmezett konfigurációs fájl
.SH DIAGNOSZTIKA
A kilépési kód 0, ha a 
.BR dialog " a " Yes "-el vagy az " OK
gomb lenyomásával ért véget, és 1, ha a
.BR No " vagy a " Cancel
gomb volt lenyomva. Egyébként, ha hiba fordul elő a
.B dialog
-on belül vagy a
.B dialog
az
.I ESC
billentyű lenyomására lépett ki, a kilépési kód -1.
.SH HIBÁK
A
.I tab
karaktereket tartalmazó szövegfájl-ok problémát okozhatnak a 
.B szöveg
dobozban. A
.I tab
karaktereket előzőleg szóközzé kell alakítani, ha meg akarjuk
.RB "jeleníteni egy " szöveg " dobozban."
.TP
A képernyőfrissítés túl lassú.
.SH SZERZŐ
Savio Lam (lam836@cs.cuhk.hk) - 0.3 verzió
.LP
Stuart Herbert (S.Herbert@sheffield.ac.uk) - patch a 0.4 verzióhoz
.SH MAGYAR FORDÍTÁS
Szijjártó László <laca@janus.gimsz.sulinet.hu>