<sect1 id="mini-commander">
  <title>Applet Mini-Commander</title>

  <para>
    L'applet <application>Mini-Commander</application>, mostrato in <xref
    linkend="mini-commander-applet-fig">, aggiunge una linea di comando al
    vostro <interface>Pannello</interface>. Fra le sue caratteristiche ci sono
    il completamento e la storia dei comandi, macro modificabili (che possono
    essere usate per molti scopi) e un orologio interno opzionale. Con questa
    applet è possibile avviare un programma o una macro, vedere una pagina html,
    cercare pagine man o info e altro. <application>Mini-Commander</application>
    può essere staccato dal <interface>Pannello</interface> usando una
    maniglietta opzionale, cosa utile se lo state usando su pannelli verticali.
  </para> 
  <para>
    Per aggiungere questa applet ad un <interface>Pannello</interface>, cliccate
    con il tasto destro del mouse sul <interface>Pannello</interface> e scegliete
    <menuchoice>
      <guimenu>Pannello</guimenu>
      <guisubmenu>Aggiungi al pannello</guisubmenu>
      <guisubmenu>Applet</guisubmenu>
      <guisubmenu>Utilità</guisubmenu>
      <guimenuitem>Mini-Commander</guimenuitem>
    </menuchoice>.
  </para>

  <figure id="mini-commander-applet-fig">
    <title>Applet Mini-Commander</title>
   <screenshot>
    <screeninfo>Applet Mini-Commander</screeninfo>
      <graphic format="png" fileref="figures/mini-commander_applet" 
	       srccredit="Martin Baulig">
      </graphic>
    </screenshot>
  </figure>

  <!-- ============= Usage  ================================ -->
  <sect2 id="APPLET-usage">
    <title>Uso</title>

    <para>
      Per avviare un programma o un comando basta semplicemente digitarli e
      premere invio. Oppure è possibile cercarli sul vostro file-system
      cliccando sul piccolo <guiicon>cerchietto</guiicon> nell'angolo in basso. 
    </para>
    <para>
      <application>Mini-Commander</application> ha il completamento dei comandi
      come molte altre shell. Con questa caratteristica spesso non dovrete
      digitare l'intero comando ma solo i primi caratteri e poi potrete premere
      il tasto <keycap>tab</keycap>. <application>Mini-Commander</application>
      cercherà di completare il nome del comando allo stesso modo di molte altre
      shell UNIX.
    </para>
    <para>
      <application>Mini-Commander</application> ha anche la storia dei comandi,
      che permette di richiamare comandi digitati precedentemente usando i tasti
      <keycap>freccia su</keycap> o <keycap>freccia giù</keycap>, allo stesso
      modo sempre delle shell UNIX. Notate che i comandi non vengono
      memorizzati nel caso in cui siano già presenti per evitare ripetizioni; è
      possibile accedere alla storia dei comandi premendo la piccola
      <guibutton>freccia in giù</guibutton> nell'applet e selezionando il
      comando direttamente dalla lista.
    </para>
    <para>
      <application>Mini-Commander</application> ha anche la capacità di usare
      macro, di cui alcune sono state già inserite. Ad esempio se digitate il
      comando <command>term:<replaceable>command</replaceable></command> viene
      eseguito <command><replaceable>command</replaceable></command> in una
      finestra di terminale. Se invece inserite un URL viene avviato il vostro
      browser Web per visualizzarlo. È possibile definire le macro oppure
      cambiare quelle predefinite.
    </para>

    <para>
      Cliccando con il tasto destro del mouse appare un menù contenente le
      seguenti voci:
      <itemizedlist>

	<listitem>
	  <para>
	    <guimenuitem>Proprietà &hellip; </guimenuitem> &mdash; apre la
	    finestra di dialogo  <link linkend="mini-commander-prefs">
	    <guilabel>Proprietà del mini-commander</guilabel></link>.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    <guimenuitem>Aiuto</guimenuitem> &mdash; mostra questo documento.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    <guimenuitem>Informazioni su &hellip; </guimenuitem> &mdash; mostra
	    le informazioni sull'<application>Applet
	    Mini-commander</application> come la versione dell'applet e il nome
	    dell'autore.
	  </para>
	</listitem>

      </itemizedlist>
    </para>
  </sect2>


  <!-- ============= Customization ============================= -->
  <sect2 id="mini-commander-prefs">
    <title>Personalizzazione</title>
    <para>
      È possibile personalizzare l'applet
      <application>Mini-Commander</application> cliccandoci sopra con il tasto
      destro e scegliendo <guimenuitem>Proprietà&hellip;</guimenuitem>. Apparirà
      così la finestra di dialogo <interface>Proprietà del
      mini-commander</interface> (mostrata in <xref
      linkend="mini-commander-settings-fig-1">), con la quale è possibile
      modificare molte impostazioni.
    </para>

    <figure id="mini-commander-settings-fig-1">
      <title>Finestra di dialogo Proprietà del mini-commander: Sezione
	Generali</title>
      <screenshot>
	<screeninfo>Finestra di dialogo Proprietà del mini-commander: Sezione
	  Generali</screeninfo>
	<graphic format="png" fileref="figures/mini-commander_settings_general"
		 srccredit="Martin Baulig">
	</graphic>
      </screenshot>
    </figure>

    <para>
      Le proprietà nella sezione <guilabel>Generali</guilabel> sono:
      <itemizedlist>

	<listitem>
	  <para>
	    Visualizza l'ora &mdash; Se viene selezionato questo bottone viene
	    visualizzata l'ora nell'angolo in basso dell'applet.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Visualizza la data &mdash; Se viene selezionato questo bottone viene
	    visualizzata la data nell'angolo in basso dell'applet.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Mostra gestore &mdash; Se viene selezionato questo bottone viene
	    visualizzato un gestore all'inizio dell'applet permettendo così di
	    staccarla dal <interface>Pannello</interface>. È possibile poi
	    riattaccare l'applet al <interface>Pannello</interface>
	    trascinandocela sopra nuovamente.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Mostra cornice &mdash; Se viene selezionato questo bottone viene
	    mostrata una piccola cornice intorno all'applet.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Abilita auto-completamento in base alla lista &mdash; Se viene
	    selezionato questo bottone <application>Mini-Commander</application>
	    cercherà automaticamente di completare i comandi usando la storia
	    dei comandi precedenti.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Larghezza applet &mdash; Immettete la larghezza desiderata.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Lunghezza applet &mdash; Immettete la lunghezza desiderata.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Altezza linea di comando &mdash; (Questa opzione è disabilitata)
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Colore della linea di comando &mdash; Selezionate il colore per il
	    testo che immettete.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Sfondo della linea di comando &mdash; Selezionate il colore dello
	    sfondo della linea di comando
	  </para>
	</listitem>
	
      </itemizedlist>
    </para>

    <!--
  <figure id="mini-commander-settings-fig-2">
  <title>Properties dialog: Macros Tab</title>
  <screenshot>
  <screeninfo>Properties dialog: Macros Tab</screeninfo>
  <graphic format="png" fileref="figures/mini-commander_settings_macros"
    srccredit="Martin Baulig">
  </graphic>
  </screenshot>
  </figure>
    -->

    <para>
      La sezione <guilabel>Macro</guilabel> consiste in una lista di 99 macro
      ognuna composta da un'espressione regolare (<guilabel>Suffisso</guilabel>)
      e da una macro (<guilabel>Macro</guilabel>). Immettete l'espressione
      regolare da cercare in <application>Mini-Commander</application> nella
      colonna di sinistra e la macro da avviare corrispondentemente nella
      colonna di destra. La configurazione predefinita contiene delle macro già
      definite che possono aiutare a definirne altre.
    </para>

    <para>
      Fatti i cambiamenti voluti cliccate sul pulsante <guibutton>OK</guibutton>
      per salvarli e chiudete la finestra di dialogo <interface>Proprietà del
      mini-commander</interface>. Per annullare le modifiche e tornare alle
      impostazioni precedenti, cliccate sul pulsante
      <guibutton>Chiudi</guibutton>.
    </para>
  </sect2>


  <!-- ============= Freq. Asked Questions ==================== -->
  <sect2 id="faq">
    <title>Domande poste frequentemente (FAQ)</title>

    <para>
      Vengono qui elencate le domande poste con maggiore frequenza e le relative
      risposte.
    </para>

    <qandaset>
      <qandaentry>
	<question>
	  <para>
	    Perché non riesco a dare il focus della tastiera a
	    <application>Mini-Commander</application>?
	  </para>
	</question>
	<answer>
	  <para>
	    Questo è un problema confuso creato da molte ragioni e che può
	    verificarsi solo in alcune circostanze.
	  </para>

	  <para>
	    Se non riuscite mai a dare il focus della tastiera all'applet
	    <application>Mini-Commander</application> potrebbe essere un
	    problema dato dal vostro window-manager. In questo caso potrebbe
	    essere utile una vostra segnalazione al mio indirizzo in merito a
	    quale window-manager state usando (specificandone il nome e la
	    versione).
	  </para>

	  <para>
	    A volte può accadere che possiate dare il focus della tastiera
	    all'applet <application>Mini-Commander</application> solo la prima
	    volta e poi non siate più in grado di ridarlo. Attualmente la
	    ragione di questo bug è sconosciuta.
	  </para>

	</answer>
      </qandaentry>
   
    </qandaset>
  </sect2>


  <!-- ============= Bugs ================================== -->
  <!-- This section should describe known bugs and limitations of
  the program if there are any - please be frank and list all
  problems you know of -->
  <sect2 id="bugs">
    <title>Bug conosciuti e limitazioni</title>
    <para>
      A volte è impossibile dare il focus della tastiera a
      <application>Mini-Commander</application> dopo la prima volta.
    </para>
  </sect2>


  <!-- ============= Further Information ==================== -->
  <sect2 id="furtherinfo">
   <title>Ulteriori informazioni</title>
    <para>
      Per maggiori informazioni sull'applet
      <application>Mini-Commander</application> potete guardare l'home page di
      riferimento <ulink url="http://www.maruhn.com/mini-commander/">
      http://www.maruhn.com/mini-commander/</ulink>.
    </para>
  </sect2>

  <!-- ============= Authors ================================ -->

  <sect2 id="authors">
    <title>Autori</title>
    <para>
      <application>Mini-Commander</application> è stata scritta da Oliver Maruhn
      (<email>oliver@maruhn.com</email>). Inviate tutti i commenti,
      suggerimenti e notifiche di errori al <ulink url="http://bugs.gnome.org"
      type="http">GNOME bug tracking database</ulink>. (Le istruzioni per
      riportare errori possono essere trovate <ulink
      url="http://bugs.gnome.org/Reporting.html" type="http">on-line</ulink>. Se
      state usando la versione di GNOME 1.1 o una più recente è possibile usare
      anche il programma <application>bug-buddy</application>
      (<command>bug-buddy</command>), che si trova nel sotto-menù
      <guisubmenu>Utilità</guisubmenu> nel <guimenu>Menù Principale</guimenu>,
      per riportare errori.
    </para>

    <para>
      Questo manuale è stato scritto da Oliver Maruhn
      (<email>oliver@maruhn.com</email>). Alcune piccole modifiche e aggiornamenti
      sono stati scritti da  Dan Mueth
      (<email>d-mueth@uchicago.edu</email>). Inviate tutti i commenti e i
      suggerimenti riguardo questo manuale allo <ulink type="http"
      url="http://www.gnome.org/gdp">GNOME Documentation Project</ulink>
      mandando un email a <email>docs@gnome.org</email>. È possibile anche
      spedire commenti on-line usando lo <ulink type="http"
      url="http://www.gnome.org/gdp/doctable/">GNOME Documentation Status
      Table</ulink>.
   </para>

    <para>
      La traduzione italiana è stata curata da Leandro Noferini
      (<email>lnoferin@cybervalley.org</email>). Inviate tutti i commenti e
      suggerimenti riguardo questa traduzione a
      <email>gnome-i18n@lists.it.gnome.org</email>.
   </para>

  </sect2>


  <!-- ============= Application License ============================= -->

  <sect2 id="license">
    <title>Licenza</title>
    <para>
      This program is free software; you can redistribute it and/or
      modify it under the terms of the <citetitle>GNU General Public
	License</citetitle> as published by the Free Software Foundation;
      either version 2 of the License, or (at your option) any later
      version.
    </para>
    <para>
      This program is distributed in the hope that it will be useful, but
      WITHOUT ANY WARRANTY; without even the implied warranty of
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      <citetitle>GNU General Public License</citetitle> for more details.
    </para>
    <para>
      A copy of the <citetitle>GNU General Public License</citetitle> is
      included as an appendix to the <citetitle>GNOME Users
	Guide</citetitle>.  You may also obtain a copy of the
      <citetitle>GNU General Public License</citetitle> from the Free
      Software Foundation by visiting <ulink type="http"
      url="http://www.fsf.org">their Web site</ulink> or by writing to
      <address>
	Free Software Foundation, Inc.
	<street>59 Temple Place</street> - Suite 330
	<city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
	<country>USA</country>
      </address>
    </para>
  </sect2>

</sect1>




<!--  LocalWords:  maniglietta Mini-Commander mdash macro
 -->
