<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY author1 "Sun">
<!ENTITY author2 "Java Desktop System Documentation Team">
<!ENTITY publisher "Sun Microsystems, Inc.">
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY appversion "2.6.0">
<!ENTITY app "<application>MateDialog</application>">
<!ENTITY appname "MateDialog">
<!ENTITY date "August 2004">
<!ENTITY manrevision "2.0">
]>
<!-- ================ Document Header ================= -->
<article id="index" lang="eu">

  <articleinfo>
    <title>MateDialog-ren eskuliburua</title>
    <subtitle>MateDialog mahaigaineko aplikazioaren eskuliburuaren 2.0 bertsioa</subtitle>
    <copyright lang="en">
	    <year>2003</year>
	    <year>2004</year>
	    <holder>Sun Microsystems, Inc.</holder>
    </copyright>

    <!-- Translators: uncomment this
    <copyright>
	    <year>2004</year>
	    <holder>ME_THE_TRANSLATOR</holder>
    </copyright>
    -->

    <publisher>
	    <publishername>Sun Microsystems Inc.</publishername>
    </publisher>

      <legalnotice id="legalnotice">
	<para>Baimena ematen da dokumentu hau kopiatu, banatu eta/edo aldatzeko Free Software Foundation-ek argitaratutako GNU Dokumentazio Librearen Lizentziaren 1.1. bertsioan edo berriago batean ezarritako baldintzetan, atal aldaezinik gabe, aurreko azaleko testurik gabe eta atzeko azaleko testurik gabe. GFDL lizentziaren kopia <ulink type="help" url="help:fdl">esteka honetan</ulink> edo eskuliburu honekin batera ematen den COPYING-DOCS fitxategian aurkituko duzu.</para>
         <para>Eskuliburu hau GFDL lizentziarekin banatzen diren MATE eskuliburuen bildumakoa da. Eskuliburu hau bildumatik bereizita banatu nahi baduzu, banatu dezakezu, baina eskuliburuari lizentziaren kopia bat gehitu beharko diozu, lizentzian bertan 6. atalean azaltzen den bezala.</para>

	<para>Enpresek beren produktuak eta zerbitzuak bereizteko erabiltzen dituzten izen asko marka erregistratu gisa hartu behar dira. Izen horiek MATEren edozein agiritan agertzen direnean, eta MATEren Dokumentazio Proiektuko kideak marka komertzialak direla konturatzen direnean, izen horiek osorik maiuskulaz edo hasierako letra maiuskulaz idatzi dituzte.</para>

	<para lang="en">
	  DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
	  UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
	  WITH THE FURTHER UNDERSTANDING THAT:

	  <orderedlist>
		<listitem>
		  <para lang="en">DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
                    WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
                    IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
                    THAT THE DOCUMENT OR MODIFIED VERSION OF THE
                    DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
                    A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
                    RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
                    OF THE DOCUMENT OR MODIFIED VERSION OF THE
                    DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
                    MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
                    YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
                    CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
                    SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
                    OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
                    LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
                    VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
                    EXCEPT UNDER THIS DISCLAIMER; AND
		  </para>
		</listitem>
		<listitem>
		  <para lang="en">UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
                       THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
                       CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
                       INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
                       DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
                       OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
                       PARTIES, BE LIABLE TO ANY PERSON FOR ANY
                       DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
                       CONSEQUENTIAL DAMAGES OF ANY CHARACTER
                       INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
                       OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
                       MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
                       LOSSES ARISING OUT OF OR RELATING TO USE OF THE
                       DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
                       EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
                       THE POSSIBILITY OF SUCH DAMAGES.
		  </para>
		</listitem>
	  </orderedlist>
	</para>
  </legalnotice>



    <authorgroup>
      <author lang="en">
        <firstname>Sun</firstname>
        <surname>Java Desktop System Documentation Team</surname>
        <affiliation><orgname>Sun Microsystems, Inc.</orgname></affiliation>
      </author>
      <author role="maintainer" lang="en">
        <firstname>Glynn</firstname>
        <surname>Foster</surname>
        <affiliation>
          <orgname>MATE Documentation Project</orgname>
        </affiliation>
      </author>
      <editor lang="en">
        <firstname>Nicholas</firstname>
        <surname>Curran</surname>
        <affiliation>
          <orgname>MATE Documentation Project</orgname>
        </affiliation>
      </editor>
    </authorgroup>

    <revhistory>
      <revision lang="en">
        <revnumber>MateDialog Desktop Application Manual V2.0</revnumber>
        <date>August 2004</date>
        <revdescription>
          <para role="author" lang="en">Sun Java Desktop System Documentation Team</para>
          <para role="publisher" lang="en">Sun Microsystems, Inc.</para>
        </revdescription>
      </revision>

      <revision lang="en">
        <revnumber>MateDialog Manual V1.0</revnumber>
        <date>January 2003</date>
        <revdescription>
          <para role="author" lang="en">Glynn Foster</para>
          <para role="publisher" lang="en"> MATE Documentation Project </para>
        </revdescription>
      </revision>
    </revhistory>

    <releaseinfo>Eskuliburu honetan MateDialog-ren 2.6.0 bertsioa azaltzen da.</releaseinfo>

    <legalnotice>
	    <title>Ohar-bidaltzea</title>
	    <para>Oharrak bidaltzeko, <ulink url="help:mate-feedback" type="help"> oharrak bidaltzeko orria</ulink>n aurkituko dituzu argibideak.</para>
<!-- Translators may also add here feedback address for translations -->

    </legalnotice>
    <abstract role="description">
            <para>Gdialog-en berridazketa da MateDialog, hau da, MATEren dialog-en bertsioa; komando-lerrotik eta shell script-etik elkarrizketa-koadroak bistaratzeko aukera ematen dizu.</para>
    </abstract>
  </articleinfo>
  
  <indexterm lang="en">
    <primary>matedialog command</primary>
  </indexterm>
  <indexterm lang="en">
    <primary>dialog creator</primary>
  </indexterm>
<!-- ================ Document Body ================= -->

<!-- ==== Introduction ====== -->

  <sect1 id="matedialog-introduction">
    <title>Sarrera</title>

    <para><application>MateDialog</application> aplikazioak elkarrizketa-koadro sinple hauek sortzeko aukera ematen dizu:</para>

    <itemizedlist>
        <listitem><para>Egutegia</para></listitem>
	<listitem><para>Fitxategi-hautapena</para></listitem>
	<listitem><para>Zerrenda</para></listitem>
	<listitem><para>Jakinarazpenaren ikonoa</para></listitem>
        <listitem><para>Mezua</para>
            <itemizedlist>
	        <listitem><para>Errorea</para></listitem>
		<listitem><para>Informazioa</para></listitem>
		<listitem><para>Galdera</para></listitem>
		<listitem><para>Abisua</para></listitem>
	    </itemizedlist>
	</listitem>
	<listitem><para>Progresio-Barra</para></listitem>
        <listitem><para>Testu-sarrera</para></listitem>
	<listitem><para>Testu-informazioa</para></listitem>
    </itemizedlist>

  </sect1>

<!-- ==== Usage ====== -->

  <sect1 id="matedialog-usage">
    <title>Erabilera</title>

    <para>Script-ak idazterakoan, <application>MateDialog</application> erabil dezakezu erabiltzaileari grafikoki eragiten dioten elkarrizketa-koadro sinpleak sortzeko.</para>
    <itemizedlist>
      <listitem>
        <para>Erabiltzaileagandik informazioa lortzeko, elkarrizketa-koadro bat sor dezakezu. Esaterako, erabiltzaileari eska diezaiokezu elkarrizketa-koadroko egutegitik data bat aukeratu dezan, edo elkarrizketa-koadroko fitxategi-hautapenetik fitxategi bat hauta dezan.</para>
      </listitem>
      <listitem>
        <para>Erabiltzaileari informazioa emateko, elkarrizketa-koadro bat sor dezakezu. Esaterako, eragiketa baten egoera adierazteko, elkarrizketa-koadroko progresio-barra erabil dezakezu, edo, erabiltzailea ohartarazteko, elkarrizketa-koadroko abisu bat.</para>
      </listitem>
    </itemizedlist>
    <para lang="en">
	When the user closes the dialog, <application>MateDialog</application> prints the text produced by the dialog to standard output.
    </para>

    <note>
      <para><application>MateDialog</application>ren komandoak idaztean, segurtatu argumentu bakoitza komatxo artean jartzen duzula.</para>
      <para lang="en">
        For example, use: <screen lang="en"><userinput><command>matedialog --calendar --title="Holiday Planner"</command></userinput></screen> Do not use: <screen lang="en"><userinput><command>matedialog --calendar --title=Holiday Planner</command></userinput></screen>
      </para>
      <para>Komatxo artean jartzen ez baduzu, ustekabeko emaitzak lortuko dituzu.</para>
    </note>

    <sect2 id="matedialog-usage-mnemonics">
      <title>Tekla bizkortzaileak</title>
	<para>Teklatua erabiliz menu bateko edo elkarrizketa-koadro bateko komando bat sagua erabili gabe aukeratzeko modua eskaintzen dizu tekla bizkortzaileak. Menu edo elkarrizketa-koadroetako aukera bakoitzean azpimarratuta dagoen letra da bizkortzailea.</para>
	<para><application>MateDialog</application> elkarrizketa-koadroek tekla bizkortzaileen erabilera onartzen dute. Tekla bizkortzaile moduan erabiliko den karakterea zehazteko, jarri azpimarra karakterearen aurretik elkarrizketa-koadroko testuan. Adibide hauetan ikusten da nola zehaztu behar den 'C' letra tekla bizkortzaile gisa:</para>
	<screen lang="en"><userinput>"_Choose a name".</userinput></screen>
    </sect2>

    <sect2 id="matedialog-usage-exitcodes">
      <title>Irteera-kodeak</title>
    <para><application>MateDialog</application> aplikazioak irteera-kode hauek itzultzen ditu:</para>

    <informaltable frame="all">
      <tgroup cols="2" colsep="1" rowsep="1">
        <colspec colname="COLSPEC0" colwidth="50*"/>
        <colspec colname="COLSPEC1" colwidth="50*"/>
        <thead>
          <row valign="top">
            <entry colname="COLSPEC0">
              <para>Irteera-kodea</para></entry>
            <entry colname="COLSPEC1">
              <para>Azalpena</para></entry>
          </row>
        </thead>
        <tbody>
          <row valign="top">
            <entry>
              <para lang="en"><varname>0</varname></para>
            </entry>
            <entry>
              <para>Erabiltzaileak <guibutton>Ados</guibutton> edo <guibutton>Itxi</guibutton> sakatu du.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>1</varname></para>
            </entry>
            <entry>
              <para>Erabiltzaileak <guibutton>Utzi</guibutton> sakatu du edo leihoen funtzioak erabili ditu elkarrizketa-koadroa ixteko.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>-1</varname></para>
            </entry>
            <entry>
              <para>Ustekabeko errorea gertatu da.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>5</varname></para>
            </entry>
            <entry>
              <para lang="en">The dialog has been closed because the timeout has been reached.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>

    </sect2>


  <!-- ==== General Options ====== -->

  <sect2 id="matedialog-usage-general-options">
    <title>Aukera orokorrak</title>

    <para><application>MateDialog</application> aplikazioaren elkarrizketa-koadro guztiek aukera orokor hauek onartzen dituzte:</para>

    <variablelist>

      <varlistentry>
        <term><option>--title</option>=<replaceable>titulua</replaceable></term>
	<listitem>
	  <para>Elkarrizketa-koadroaren titulua zehazten du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--window-icon</option>=<replaceable>ikonoaren bide-izena</replaceable></term>
	<listitem>
	  <para>Elkarrizketa-koadroaren leiho-markoetan bistaratu den ikonoa zehazten du. 4 ikono daude erabilgarri gako-hitz hauek sartuz gero - 'info', 'warning', 'question' eta 'error'.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--width</option>=<replaceable>zabalera</replaceable></term>
	<listitem>
	  <para>Elkarrizketa-koadroaren zabalera zehazten du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--height</option>=<replaceable>altuera</replaceable></term>
	<listitem>
	  <para>Elkarrizketa-koadroaren altuera zehazten du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--timeout</option>=<replaceable>timeout</replaceable></term>
	<listitem>
	  <para lang="en">Specifies the timeout in seconds after which the dialog is closed.</para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

<!-- ==== Miscellaneous Options ====== -->

  <sect2 id="matedialog-help-options">
    <title>Laguntza-aukerak</title>

    <para><application>MateDialog</application> aplikazioak laguntza-aukera hauek ematen ditu:</para>

    <variablelist>

      <varlistentry>
        <term lang="en"><option>--help</option></term>
	<listitem>
	  <para>Laguntza-testu murriztua ematen du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--help-all</option></term>
	<listitem>
	  <para>Elkarrizketa-koadro guztietarako laguntza-testu osoa bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-general</option></term>
	<listitem>
	  <para>Elkarrizketa-koadroen aukera orokorretarako laguntza-testua bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-calendar</option></term>
	<listitem>
	  <para>Egutegiaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-entry</option></term>
	<listitem>
	  <para>Hasierako testuaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-error</option></term>
	<listitem>
	  <para>Erroreen elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-info</option></term>
	<listitem>
	  <para>Informazioaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-file-selection</option></term>
	<listitem>
	  <para>Fitxategi-hautapenaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-list</option></term>
	<listitem>
	  <para>Zerrendaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-notification</option></term>
	<listitem>
	  <para>Jakinarazpen-ikonoaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-progress</option></term>
	<listitem>
	  <para>Progresio-barraren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-question</option></term>
	<listitem>
	  <para>Galderen elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-warning</option></term>
	<listitem>
	  <para>Abisuen elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-text-info</option></term>
	<listitem>
	  <para>Testu-informazioaren elkarrizketa-koadroko aukeretarako laguntza-testua bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-misc</option></term>
	<listitem>
	  <para>Aukera askotarako laguntza bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-gtk</option></term>
	<listitem>
	  <para>GTK aukeretarako laguntza bistaratzen du.</para>
	</listitem>
      </varlistentry>
 
    </variablelist>

  </sect2>

<!-- ==== Miscellaneous Options ====== -->

  <sect2 id="matedialog-miscellaneous-options">
    <title>Askotariko aukerak</title>

    <para><application>MateDialog</application> aplikazioak askotariko laguntza-aukera hauek ere eskaintzen ditu:</para>

    <variablelist>

      <varlistentry>
        <term lang="en"><option>--about</option></term>
	<listitem>
	  <para><guilabel>MateDialog-ri buruz</guilabel> elkarrizketa-koadroa bistaratzen da eta hau aurkitu dezakezu: <application>MateDialog</application> bertsioari buruzko informazioa, copyrightaren informazioa eta garatzaileen informazioa.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--version</option></term>
	<listitem>
	  <para><application>MateDialog</application>ren bertsioaren zenbakia bistaratzen du.</para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

<!-- ==== GTK+ Options ====== -->

  <sect2 id="matedialog-gtk-options">
    <title>GTK+ aukerak</title>

    <para><application>MateDialog</application> aplikazioak GTKren aukera estandarrak onartzen ditu. GTKren aukerei buruzko informazio gehiago nahi izanez gero, exekutatu <command>matedialog -?</command> komandoa.</para>

  </sect2>

<!-- ==== Environment variables ==== -->

  <sect2 id="matedialog-environment-variables">
    <title lang="en">Environment Variables</title>

    <para lang="en">
      Normally, <application>MateDialog</application> detects the terminal window from which it was launched
      and keeps itself above that window.  This behavior can be disabled by
      unsetting the <envar>WINDOWID</envar> environment variable.
    </para>

  </sect2>

  </sect1>
<!-- ==== Calendar Options ====== -->

  <sect1 id="matedialog-calendar-options">
    <title>Egutegiaren elkarrizketa-koadroa</title>

    <para lang="en">
        Use the <option>--calendar</option> option to create a calendar dialog. <application>MateDialog</application> returns the selected date to standard output. If no date is specified on the command line, the dialog uses the current date.
    </para>
    <para>Egutegiaren elkarrizketa-koadroak aukera hauek onartzen ditu:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>testua</replaceable></term>
	<listitem>
	  <para>Egutegiaren elkarrizketa-koadroan bistaratu den testua zehazten du.</para>
	</listitem>
      </varlistentry>
     	
      <varlistentry>
        <term><option>--day</option>=<replaceable>eguna</replaceable></term>
	<listitem>
	  <para>Egutegiaren elkarrizketa-koadroan hautatu den eguna zehazten du. <replaceable>eguna</replaceable>k 1 eta 31 arteko zenbaki bat izan behar du (bi horiek barne).</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--month</option>=<replaceable>hilabetea</replaceable></term>
	<listitem>
	  <para>Egutegiaren elkarrizketa-koadroan hautatu den hilabetea zehazten du. <replaceable>hilabetea</replaceable>k 1 eta 12 arteko zenbaki bat izan behar du (bi horiek barne).</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--year</option>=<replaceable>urtea</replaceable></term>
	<listitem>
	  <para>Egutegiaren elkarrizketa-koadroan hautatu den urtea zehazten du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--date-format</option>=<replaceable>formatua</replaceable></term>
	<listitem>
	  <para>Data hautatu ondoren egutegiaren elkarrizketa-koadroak itzuli duen formatua zehazten du. Formatu lehenetsia ezarpen lokalen araberakoa da. <command>strftime</command> funtzioak <replaceable>formatua</replaceable> onartu behar du, <literal>%A %d/%m/%y</literal> esate baterako.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a calendar dialog:

      <programlisting lang="en">
        #!/bin/sh


        if matedialog --calendar \
        --title="Select a Date" \
        --text="Click on a date to select that date." \
        --day=10 --month=8 --year=2004
          then echo $?
          else echo "No date selected"
        fi
      </programlisting>

    </para>

    <figure id="matedialog-calendar-screenshot">
      <title>Egutegiaren elkarrizketa-koadroaren adibidea</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
              <imagedata fileref="figures/matedialog-calendar-screenshot.png" format="PNG"/>
          </imageobject>
          <textobject>
              <phrase><application>MateDialog</application> calendar dialog example</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
   </figure>
													  
  </sect1>


<!-- ==== File Selection Options ====== -->

  <sect1 id="matedialog-file-selection-options">
    <title>Fitxategi-hautapenaren elkarrizketa-koadroa</title>

    <para lang="en">
	Use the <option>--file-selection</option> option to create a file selection dialog. <application>MateDialog</application> returns the selected files or directories to standard 
        output. The default mode of the file selection dialog is open.
    </para>
    <para>Fitxategi-hautapenaren elkarrizketa-koadroak aukera hauek onartzen ditu:</para>

    <variablelist>

      <varlistentry>
        <term><option>--filename</option>=<replaceable>fitxategi-izena</replaceable></term>
	<listitem>
	  <para>Elkarrizketa-koadroa lehenengoz erakusten denean, fitxategi-hautapenaren elkarrizketa-koadroan hautatutako fitxategia edo direktorioa zehazten du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--multiple</option></term>
	<listitem>
	  <para>Fitxategi-hautapenaren elkarrizketa-koadroan era askotako fitxategi-izenak hautatzeko aukera ematen du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--directory</option></term>
	<listitem>
	  <para>Fitxategi-hautapenaren elkarrizketa-koadroan dauden direktorioak hautatzea soilik baimentzen du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--save</option></term>
	<listitem>
	  <para>Fitxategi-hautapenaren elkarrizketa-koadroa gorde moduan jartzen du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--separator</option>=<replaceable>bereizlea</replaceable></term>
	<listitem>
	  <para>Itzulitako fitxategi-izenen zerrenda zatitzeko erabiltzen den katea zehazten du.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a file selection dialog:

      <programlisting lang="en">
        #!/bin/sh

        FILE=`matedialog --file-selection --title="Select a File"`

        case $? in
                 0)
                        echo "\"$FILE\" selected.";;
                 1)
                        echo "No file selected.";;
                -1)
                        echo "No file selected.";;
        esac
      </programlisting>
    </para>

    <figure id="matedialog-fileselection-screenshot">
      <title>Fitxategi-hautapenaren elkarrizketa-koadroaren adibidea</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-fileselection-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> file selection dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

<!-- ==== Notification Options ====== -->
  <sect1 id="matedialog-notification-options">
    <title>Jakinarazpen-ikonoa</title>

    <para>
    </para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>testua</replaceable></term>
	<listitem>
	  <para>Jakinarazpen-arean bistaratu den testua zehazten du.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a notification icon:
      <programlisting lang="en">
        #!/bin/sh

        matedialog --notification\
          --window-icon="info" \
          --text="There are system updates necessary!"
      </programlisting>

    </para>

    <figure id="matedialog-notification-screenshot">
      <title>Jakinarazpen-ikonoaren adibidea</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
              <imagedata fileref="figures/matedialog-notification-screenshot.png" format="PNG"/>
          </imageobject>
          <textobject>
              <phrase><application>MateDialog</application> notification icon example</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
   </figure>
													  
  </sect1>

<!-- ==== List Options ====== -->

  <sect1 id="matedialog-list-options">
    <title>Zerrendaren elkarrizketa-koadroa</title>

    <para lang="en">
	Use the <option>--list</option> option to create a list dialog. <application>MateDialog</application> returns the entries in the first column of text of selected rows to standard output.
    </para>

    <para>Elkarrizketa-koadroaren datuak zutabez zutabe eta errenkadaz errenkada zehaztu behar dira. Elkarrizketa-koadroak sarrera estandarraren bidez jaso ditzake datuak. Sarrera bakoitza lerro berriko karaktere batekin bereizi behar da.</para>

    <para><option>--checklist</option> edo <option>--radiolist</option> aukerak erabiltzen badituzu, errenkada bakoitza 'TRUE' edo 'FALSE'-rekin hasi beharko da.</para>

    <para>Zerrendaren elkarrizketa-koadroak aukera hauek onartzen ditu:</para>

    <variablelist>

      <varlistentry>
        <term><option>--column</option>=<replaceable>zutabea</replaceable></term>
	<listitem>
	  <para>Elkarrizketa-koadroan bistaratzen diren zutabe-goiburuak zehazten ditu. <option>--column</option> aukera zehaztu behar duzu elkarrizketa-koadroan bistaratzea nahi duzun zutabe bakoitzarentzat.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--checklist</option></term>
	<listitem>
	  <para>Zerrendaren elkarrizketa-koadroko lehen zutabeak kontrol-laukiak dituela adierazten du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--radiolist</option></term>
	<listitem>
	  <para>Zerrendaren elkarrizketa-koadroko lehen zutabeak aukera-laukiak dituela zehazten du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--editable</option></term>
	<listitem>
	  <para>Bistaratutako elementuak editatzeko aukera ematen du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--separator</option>=<replaceable>bereizlea</replaceable></term>
	<listitem>
	  <para>Zerrendaren elkarrizketa-koadroak hautatutako sarrerak itzultzen dituenean zer kate erabiltzen den zehazten da.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--print-column</option>=<replaceable>zutabea</replaceable></term>
	<listitem>
	  <para>Zer zutabe inprimatu behar den zehazten du, hautapenaren arabera. Zutabe lehenetsia '1' da. Zerrendako zutabe guztiak inprimatzeko 'ALL' erabil daiteke.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a list dialog:
      <programlisting lang="en">
        #!/bin/sh

        matedialog --list \
          --title="Choose the Bugs You Wish to View" \
          --column="Bug Number" --column="Severity" --column="Description" \
            992383 Normal "GtkTreeView crashes on multiple selections" \
            293823 High "MATE Dictionary does not handle proxy" \
            393823 Critical "Menu editing does not work in MATE 2.0"
      </programlisting>

    </para>

    <figure id="matedialog-list-screenshot">
      <title>Zerrendaren elkarrizketa-koadroaren adibidea</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-list-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> list dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

<!-- ==== Message Options ====== -->

  <sect1 id="matedialog-message-options">
    <title>Mezuaren elkarrizketa-koadroak</title>

    <para><application>MateDialog</application> aplikazioak mezuaren lau elkarrizketa-koadro mota sor ditzake.</para>
    <itemizedlist>
      <listitem>
        <para>Errorea</para>
      </listitem>
      <listitem>
        <para>Informazioa</para>
      </listitem>
      <listitem>
        <para>Galdera</para>
      </listitem>
      <listitem>
        <para>Abisua</para>
      </listitem>
    </itemizedlist>

    <para>Mota bakoitzean, erabili <option>--text</option> aukera, elkarrizketa-koadroan bistaratutako testua zehazteko.</para>

    <sect2 id="matedialog-error-dialog">
      <title>Erroreen elkarrizketa-koadroa</title>

      <para>Erabili <option>--error</option> aukera, erroreen elkarrizketa-koadroa sortzeko.</para>

      <para lang="en">
        The following example script shows how to create an error dialog:

        <programlisting lang="en">
          #!/bin/bash

          matedialog --error \
          --text="Could not find /var/log/syslog."
        </programlisting>

      </para>

      <figure id="matedialog-error-screenshot">
        <title>Erroreen elkarrizketa-koadroaren adibidea</title>
        <screenshot>
          <mediaobject lang="en">
            <imageobject>
              <imagedata fileref="figures/matedialog-error-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase><application>MateDialog</application> error dialog example</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="matedialog-info-dialog">
      <title>Informazioaren elkarrizketa-koadroa</title>

      <para>Erabili <option>--info</option> aukera, informazioaren elkarrizketa-koadroa sortzeko.</para>

      <para lang="en">
        The following example script shows how to create an information dialog:

        <programlisting lang="en">
          #!/bin/bash

          matedialog --info \
          --text="Merge complete. Updated 3 of 10 files."
        </programlisting>

      </para>

      <figure id="matedialog-information-screenshot">
        <title>Informazioaren elkarrizketa-koadroaren adibidea</title>
        <screenshot>
          <mediaobject lang="en">
            <imageobject>
              <imagedata fileref="figures/matedialog-information-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase><application>MateDialog</application> information dialog example</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="matedialog-question-dialog">
      <title>Galderen elkarrizketa-koadroa</title>

      <para>Erabili <option>--galdera</option> aukera, galderen elkarrizketa-koadroa sortzeko.</para>

      <para lang="en">
        The following example script shows how to create a question dialog:

        <programlisting lang="en">
          #!/bin/bash

          matedialog --question \
          --text="Are you sure you wish to proceed?"
        </programlisting>

      </para>

      <figure id="matedialog-question-screenshot">
        <title>Galderen elkarrizketa-koadroaren adibidea</title>
        <screenshot>
          <mediaobject lang="en">
            <imageobject>
              <imagedata fileref="figures/matedialog-question-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase><application>MateDialog</application> question dialog example</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="matedialog-warning-dialog">
      <title>Abisuen elkarrizketa-koadroa</title>

      <para>Erabili <option>--warning</option> aukera, abisuen elkarrizketa-koadroa sortzeko.</para>

      <para lang="en">
        The following example script shows how to create a warning dialog:

        <programlisting lang="en">
          #!/bin/bash
        
          matedialog --warning \
          --text="Disconnect the power cable to avoid electrical shock."
        </programlisting>

      </para>

      <figure id="matedialog-warning-screenshot">
        <title>Abisuen elkarrizketa-koadroa</title>
        <screenshot>
          <mediaobject lang="en">
            <imageobject>
              <imagedata fileref="figures/matedialog-warning-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase><application>MateDialog</application> warning dialog example</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

  </sect1>

<!-- ==== Progress Options ====== -->

  <sect1 id="matedialog-progress-options">
    <title>Progresioaren elkarrizketa-koadroa</title>

    <para>Erabili <option>--progress</option> aukera, progresioaren elkarrizketa-koadroa sortzeko.</para>

    <para><application>MateDialog</application> aplikazioak errenkadaz errenkada irakurtzen ditu sarrera estandarreko datuak. Errenkada bat aurrez #rekin finkatzen bada, testua errenkada horretako testuarekin eguneratzen da. Errenkada batek zenbaki bakar bat soilik badu, ehunekoa zenbaki horrekin eguneratzen da.</para>
	
    <para>Progresioaren elkarrizketa-koadroak aukera hauek onartzen ditu:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>testua</replaceable></term>
	<listitem>
	  <para>Progresioaren elkarrizketa-koadroan bistaratu den testua zehazten du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--percentage</option>=<replaceable>ehunekoa</replaceable></term>
	<listitem>
	  <para>Progresioaren elkarrizketa-koadroan finkatu den hasierako ehunekoa zehazten du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--auto-close</option></term>
	<listitem>
	  <para>% 100a lortu denean, progresioaren elkarrizketa-koadroa ixten du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--pulsate</option></term>
	<listitem>
	  <para>Progresio-barra pultsuka luzatzen da sarrera estandarrean EOF karaktere bat irakurri arte.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a progress dialog:
      <programlisting lang="en">
        #!/bin/sh
        (
        echo "10" ; sleep 1
        echo "# Updating mail logs" ; sleep 1
        echo "20" ; sleep 1
        echo "# Resetting cron jobs" ; sleep 1
        echo "50" ; sleep 1
        echo "This line will just be ignored" ; sleep 1
        echo "75" ; sleep 1
        echo "# Rebooting system" ; sleep 1
        echo "100" ; sleep 1
        ) |
        matedialog --progress \
          --title="Update System Logs" \
          --text="Scanning mail logs..." \
          --percentage=0

        if [ "$?" = -1 ] ; then
                matedialog --error \
                  --text="Update canceled."
        fi

      </programlisting>

    </para>

    <figure id="matedialog-progress-screenshot">
      <title>Progresioaren elkarrizketa-koadroaren adibidea</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-progress-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> progress dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

<!-- ==== Text Entry Options ====== -->

  <sect1 id="matedialog-text-entry-options">
    <title>Testu-sarreraren elkarrizketa-koadroa</title>

    <para lang="en">
        Use the <option>--entry</option> option to create a text entry dialog. <application>MateDialog</application> returns the contents of the text entry to standard output. 
    </para>	
    <para>Testu-sarreraren elkarrizketa-koadroak aukera hauek onartzen ditu:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>testua</replaceable></term>
	<listitem>
	  <para>Testu-sarreraren elkarrizketa-koadroan bistaratu den testua zehazten du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--entry-text</option>=<replaceable>testua</replaceable></term>
	<listitem>
	  <para>Testu-sarreraren elkarrizketa-koadroko sarrera-eremuan bistaratu den testua zehazten du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--hide-text</option></term>
	<listitem>
	  <para>Testu-sarreraren elkarrizketa-koadroko sarrera-eremuan dagoen testua ezkutatzen du</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a text entry dialog:

      <programlisting lang="en">
        #!/bin/sh

        if matedialog --entry \
        --title="Add an Entry" \
        --text="Enter your _password:" \
        --entry-text "password" \
        --hide-text
          then echo $?
          else echo "No password entered"
        fi
      </programlisting>

    </para>

    <figure id="matedialog-entry-screenshot">
      <title>Testu-sarreraren elkarrizketa-koadroaren adibidea</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-entry-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> text entry dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>
  </sect1>

<!-- ==== Text Information Options ====== -->

  <sect1 id="matedialog-text-options">
    <title>Testu-informazioaren elkarrizketa-koadroa</title>

    <para>Erabili <option>--text-info</option> aukera, testu-informazioaren elkarrizketa-koadroa sortzeko.</para>
	
    <para>Testu-informazioaren elkarrizketa-koadroak aukera hauek onartzen ditu:</para>

    <variablelist>

      <varlistentry>
        <term><option>--filename</option>=<replaceable>fitxategi-izena</replaceable></term>
	<listitem>
	  <para>Testu-informazioaren elkarrizketa-koadroan kargaturiko fitxategia zehazten du.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--editable</option></term>
        <listitem>
          <para lang="en">Allows the displayed text to be edited. The edited text is returned to standard output when the dialog is closed.</para>
        </listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a text information dialog:
      <programlisting lang="en">
        #!/bin/sh

        FILE=`matedialog --file-selection \
          --title="Select a File"`

        case $? in
                 0)
                        matedialog --text-info \
                          --title=$FILE \
                          --filename=$FILE \
                          --editable 2&gt;/tmp/tmp.txt;;
                 1)
                        echo "No file selected.";;
                -1)
                        echo "No file selected.";;
        esac
      </programlisting>

    </para>

    <figure id="matedialog-text-screenshot">
      <title>Testu-informazioaren elkarrizketa-koadroaren adibidea</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-text-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> text information dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

</article>
