diff options
Diffstat (limited to 'tde-i18n-it/docs/tdewebdev/kommander/specials.docbook')
| -rw-r--r-- | tde-i18n-it/docs/tdewebdev/kommander/specials.docbook | 569 |
1 files changed, 99 insertions, 470 deletions
diff --git a/tde-i18n-it/docs/tdewebdev/kommander/specials.docbook b/tde-i18n-it/docs/tdewebdev/kommander/specials.docbook index bdcd25f2a06..c4d9713449c 100644 --- a/tde-i18n-it/docs/tdewebdev/kommander/specials.docbook +++ b/tde-i18n-it/docs/tdewebdev/kommander/specials.docbook @@ -2,431 +2,197 @@ <sect1 id="specials"> <sect1info> -<title ->Comandi Speciali e Variabili Globali Integrate</title> +<title>Comandi Speciali e Variabili Globali Integrate</title> <authorgroup> -<author -><firstname -></firstname -> <surname -></surname -> <affiliation -><address -> <email -></email> -</address -></affiliation> +<author><firstname></firstname> <surname></surname> <affiliation><address> <email></email> +</address></affiliation> </author> -<othercredit role="translator" -><firstname ->Samuele</firstname -><surname ->Kaplun</surname -><affiliation -><address -><email ->kaplun@aliceposta.it</email -></address -></affiliation -><contrib ->Traduzione del documento</contrib -></othercredit -> +<othercredit role="translator"><firstname>Samuele</firstname><surname>Kaplun</surname><affiliation><address><email>kaplun@aliceposta.it</email></address></affiliation><contrib>Traduzione del documento</contrib></othercredit> </authorgroup> </sect1info> -<title ->Comandi Speciali e Variabili Globali Integrate</title> +<title>Comandi Speciali e Variabili Globali Integrate</title> -<para ->I comandi speciali sono funzioni che vengono processate da &kommander;. Sappi che fino a quando &kommander; non avrà un parser completo tutti i comandi speciali saranno eseguiti prima che venga eseguito lo script. In molti casi questo non è un problema, ma talvolta sì. </para> +<para>I comandi speciali sono funzioni che vengono processate da &kommander;. Sappi che fino a quando &kommander; non avrà un parser completo tutti i comandi speciali saranno eseguiti prima che venga eseguito lo script. In molti casi questo non è un problema, ma talvolta sì. </para> <variablelist> <varlistentry> -<term -><function ->@dcop(<parameter ->appId</parameter ->, <parameter ->oggetto</parameter ->, <parameter ->funzione</parameter ->, <parameter ->argomenti</parameter ->)</function -></term> +<term><function>@dcop(<parameter>appId</parameter>, <parameter>oggetto</parameter>, <parameter>funzione</parameter>, <parameter>argomenti</parameter>)</function></term> <listitem> -<para ->Esegue una chiamata a &DCOP;. @dcop(<quote ->kmail</quote ->, <quote ->KMailIface</quote ->, <quote ->checkMail()</quote ->, <quote -></quote ->) </para> +<para>Esegue una chiamata a &DCOP;. @dcop(<quote>kmail</quote>, <quote>KMailIface</quote>, <quote>checkMail()</quote>, <quote></quote>) </para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@dcopid</function -></term> +<term><function>@dcopid</function></term> <listitem> -<para ->L'id &DCOP; del processo (kmdr-executor-@pid) </para> +<para>L'id &DCOP; del processo (kmdr-executor-@pid) </para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@dialog(<parameter ->finestra_di_dialogo</parameter ->[,<parameter ->parametri</parameter ->])</function -></term> +<term><function>@dialog(<parameter>finestra_di_dialogo</parameter>[,<parameter>parametri</parameter>])</function></term> <listitem> -<para ->Richiama la finestra di dialogo di Kommander specificata. Le finestre di dialogo sono ricercate nella cartella delle finestre di dialogo e nella cartella corrente - in quest'ordine. Ciò mette in sospeso la chiamata all'esecutore ed imposta la cartella predefinita a quella in cui si trova l'applicazione di Kommander. I parametri possono essere passati nell'usuale maniera Unix o puoi passare dei parametri per nome come in <quote ->variabile=valore</quote ->. Puoi infine recuperare i parametri passati nell'ambiente globale. @global(variabile) ritornerebbe <quote ->valore</quote ->. </para> +<para>Richiama la finestra di dialogo di Kommander specificata. Le finestre di dialogo sono ricercate nella cartella delle finestre di dialogo e nella cartella corrente - in quest'ordine. Ciò mette in sospeso la chiamata all'esecutore ed imposta la cartella predefinita a quella in cui si trova l'applicazione di Kommander. I parametri possono essere passati nell'usuale maniera Unix o puoi passare dei parametri per nome come in <quote>variabile=valore</quote>. Puoi infine recuperare i parametri passati nell'ambiente globale. @global(variabile) ritornerebbe <quote>valore</quote>. </para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@env(<parameter ->variabileDiAmbiente</parameter ->)</function -></term> +<term><function>@env(<parameter>variabileDiAmbiente</parameter>)</function></term> <listitem> -<para ->Viene espanso alla variabile d'ambiente specificata. @env(PWD) viene espanso a $PWD. Ricorda che <quote ->$</quote -> è parte della sintassi shell e non dovrebbe essere utilizzato. </para> +<para>Viene espanso alla variabile d'ambiente specificata. @env(PWD) viene espanso a $PWD. Ricorda che <quote>$</quote> è parte della sintassi shell e non dovrebbe essere utilizzato. </para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@exec(<parameter ->comando</parameter ->)</function -></term> +<term><function>@exec(<parameter>comando</parameter>)</function></term> <listitem> -<para ->restituisce l'output dell'esecuzione del comando specificato. @exec(ls -l). </para> +<para>restituisce l'output dell'esecuzione del comando specificato. @exec(ls -l). </para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@execBegin ... @execEnd</function -></term> +<term><function>@execBegin ... @execEnd</function></term> <listitem> -<para ->come in <function ->@exec</function ->, ma supporta gli script shebang (cioè che cominciano, ad esempio, con #!/bin/sh) e su più righe. Questo è utile in diversi linguaggi di scripting sia dichiarandoli o utilizzando una shebang. </para> +<para>come in <function>@exec</function>, ma supporta gli script shebang (cioè che cominciano, ad esempio, con #!/bin/sh) e su più righe. Questo è utile in diversi linguaggi di scripting sia dichiarandoli o utilizzando una shebang. </para> <itemizedlist> -<listitem -><para -><function ->@execBegin(php)</function -></para -></listitem> -<listitem -><para -><function ->@execBegin</function ->#!/usr/bin/php</para -></listitem> +<listitem><para><function>@execBegin(php)</function></para></listitem> +<listitem><para><function>@execBegin</function>#!/usr/bin/php</para></listitem> </itemizedlist> -<para ->Il primo utilizza il nome dell'eseguibile <acronym ->PHP</acronym ->. &kommander; cerca nel PATH <application ->php</application -> e se non lo trova verifica se è registrato con &kommander; in una posizione al di fuori del tuo path. Se non è così notifica all'utente che non può essere trovato. Il secondo esempio utilizza la classica <quote ->shebang</quote -> che può portare sia benefici che alcuni problemi. È utile ad esempio, se possiedi una copia beta di <acronym ->PHP5</acronym -> in <filename ->/usr/local/bin</filename -> che non deve essere trovata perché il percorso di ricerca è <filename ->/usr/bin</filename ->. Se, però, distribuisce la finestra di dialogo a qualcuno che ha messo <acronym ->PHP</acronym -> in <filename ->/usr/local/bin</filename -> questo non verrà trovato quando verrà usata la shebang. Perciò utilizzate le shebang con cautela. È invece raccomandato indicare l'eseguibile se condividete i file.</para> +<para>Il primo utilizza il nome dell'eseguibile <acronym>PHP</acronym>. &kommander; cerca nel PATH <application>php</application> e se non lo trova verifica se è registrato con &kommander; in una posizione al di fuori del tuo path. Se non è così notifica all'utente che non può essere trovato. Il secondo esempio utilizza la classica <quote>shebang</quote> che può portare sia benefici che alcuni problemi. È utile ad esempio, se possiedi una copia beta di <acronym>PHP5</acronym> in <filename>/usr/local/bin</filename> che non deve essere trovata perché il percorso di ricerca è <filename>/usr/bin</filename>. Se, però, distribuisce la finestra di dialogo a qualcuno che ha messo <acronym>PHP</acronym> in <filename>/usr/local/bin</filename> questo non verrà trovato quando verrà usata la shebang. Perciò utilizzate le shebang con cautela. È invece raccomandato indicare l'eseguibile se condividete i file.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@global(<parameter ->variabile</parameter ->)</function -></term> +<term><function>@global(<parameter>variabile</parameter>)</function></term> <listitem> -<para ->viene espanso nel valore della variabile globale specificata. </para> +<para>viene espanso nel valore della variabile globale specificata. </para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@null</function -></term> +<term><function>@null</function></term> <listitem> -<para ->Restituisce null. Ora che Kommander verifica i widget vuoti durante l'esecuzione questo comando preverrà la segnalazione errata di errori nel caso della non impostazione dello stato di un widget.</para> +<para>Restituisce null. Ora che Kommander verifica i widget vuoti durante l'esecuzione questo comando preverrà la segnalazione errata di errori nel caso della non impostazione dello stato di un widget.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@parentPid</function -></term> +<term><function>@parentPid</function></term> <listitem> -<para ->Il &PID; del processo genitore. </para> +<para>Il &PID; del processo genitore. </para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@pid</function -></term> +<term><function>@pid</function></term> <listitem> -<para ->Il &PID; del processo. </para> +<para>Il &PID; del processo. </para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@readSetting(<parameter ->chiave</parameter ->, <parameter ->valorePredefinito</parameter ->)</function -></term> +<term><function>@readSetting(<parameter>chiave</parameter>, <parameter>valorePredefinito</parameter>)</function></term> <listitem> -<para ->legge un valore da <filename ->kommanderrc</filename -> </para> +<para>legge un valore da <filename>kommanderrc</filename> </para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@selectedWidgetText</function -></term> +<term><function>@selectedWidgetText</function></term> <listitem> -<para ->il contenuto selezionato di un widget che può visualizzare più di un valore, come i widget lista </para> +<para>il contenuto selezionato di un widget che può visualizzare più di un valore, come i widget lista </para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@setGlobal(<parameter ->variabile</parameter ->, <parameter ->valore</parameter ->)</function -></term> +<term><function>@setGlobal(<parameter>variabile</parameter>, <parameter>valore</parameter>)</function></term> <listitem> -<para ->Imposta la variabile globale al valore specificato. </para> +<para>Imposta la variabile globale al valore specificato. </para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@widgetText</function -></term> +<term><function>@widgetText</function></term> <listitem> -<para ->il contenuto di un widget </para> +<para>il contenuto di un widget </para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@writeSetting(<parameter ->chiave</parameter ->, <parameter ->valore</parameter ->)</function -></term> +<term><function>@writeSetting(<parameter>chiave</parameter>, <parameter>valore</parameter>)</function></term> <listitem> -<para ->scrive il valore in <filename ->kommanderrc</filename -> </para> +<para>scrive il valore in <filename>kommanderrc</filename> </para> </listitem> </varlistentry> </variablelist> <sect2 id="arrays"> -<title ->Gruppo delle Funzioni per Array</title> +<title>Gruppo delle Funzioni per Array</title> <variablelist> <varlistentry> -<term -><function ->@Array.values(<parameter ->array</parameter ->)</function -></term> +<term><function>@Array.values(<parameter>array</parameter>)</function></term> <listitem> -<para ->Restituisce una lista separata da EOL di tutti i valori contenuti nell'array. Può essere utilizzato per scorrere attraverso l'array.</para> +<para>Restituisce una lista separata da EOL di tutti i valori contenuti nell'array. Può essere utilizzato per scorrere attraverso l'array.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@Array.keys(<parameter ->array</parameter ->)</function -></term> +<term><function>@Array.keys(<parameter>array</parameter>)</function></term> <listitem> -<para ->Restituisce un elenco separato da fine riga (EOL) di tutte le chiavi del vettore.</para> +<para>Restituisce un elenco separato da fine riga (EOL) di tutte le chiavi del vettore.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@Array.setValue(<parameter ->array</parameter ->, <parameter ->chiave</parameter ->, <parameter ->valore</parameter ->)</function -></term> +<term><function>@Array.setValue(<parameter>array</parameter>, <parameter>chiave</parameter>, <parameter>valore</parameter>)</function></term> <listitem> -<para ->Imposta una chiave ed un valore per un elemento di un array. Se l'array non esiste, viene creato.</para> +<para>Imposta una chiave ed un valore per un elemento di un array. Se l'array non esiste, viene creato.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@Array.clear(<parameter ->array</parameter ->)</function -></term> +<term><function>@Array.clear(<parameter>array</parameter>)</function></term> <listitem> -<para ->Rimuove tutti gli elementi dal vettore.</para> +<para>Rimuove tutti gli elementi dal vettore.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@Array.count(<parameter ->array</parameter ->)</function -></term> +<term><function>@Array.count(<parameter>array</parameter>)</function></term> <listitem> -<para ->Restituisce il numero di elementi nel vettore.</para> +<para>Restituisce il numero di elementi nel vettore.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@Array.value(<parameter ->array</parameter ->,<parameter ->chiave</parameter ->)</function -></term> +<term><function>@Array.value(<parameter>array</parameter>,<parameter>chiave</parameter>)</function></term> <listitem> -<para ->Restituisce il valore associato alla chiave indicata.</para> +<para>Restituisce il valore associato alla chiave indicata.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@Array.remove(<parameter ->array</parameter ->,<parameter ->chiave</parameter ->)</function -></term> +<term><function>@Array.remove(<parameter>array</parameter>,<parameter>chiave</parameter>)</function></term> <listitem> -<para ->Rimuove l'elemento con la chiave indicata dall'array.</para> +<para>Rimuove l'elemento con la chiave indicata dall'array.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@Array.fromString(<parameter ->array</parameter ->,<parameter ->stringa</parameter ->)</function -></term> +<term><function>@Array.fromString(<parameter>array</parameter>,<parameter>stringa</parameter>)</function></term> <listitem> -<para ->Aggiunge tutti gli elementi nella stringa nell'array. La stringa dovrebbe essere nel formato <emphasis ->chiave\tvalore\n</emphasis ->."</para> +<para>Aggiunge tutti gli elementi nella stringa nell'array. La stringa dovrebbe essere nel formato <emphasis>chiave\tvalore\n</emphasis>."</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@Array.toString(<parameter ->array</parameter ->,<parameter ->stringa</parameter ->)</function -></term> +<term><function>@Array.toString(<parameter>array</parameter>,<parameter>stringa</parameter>)</function></term> <listitem> -<para ->Restituisce tutti gli elementi nell'array nel formato <emphasis ->chiave\t\n</emphasis ->."</para> +<para>Restituisce tutti gli elementi nell'array nel formato <emphasis>chiave\t\n</emphasis>."</para> </listitem> </varlistentry> @@ -434,50 +200,27 @@ </sect2> <sect2 id="files"> -<title ->Gruppo di Funzioni per File</title> +<title>Gruppo di Funzioni per File</title> <variablelist> <varlistentry> -<term -><function ->@File.read(<parameter ->file</parameter ->)</function -></term> +<term><function>@File.read(<parameter>file</parameter>)</function></term> <listitem> -<para ->Restituisce il contenuto del file indicato.</para> +<para>Restituisce il contenuto del file indicato.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@File.write(<parameter ->file</parameter -><parameter ->stringa</parameter ->)</function -></term> +<term><function>@File.write(<parameter>file</parameter><parameter>stringa</parameter>)</function></term> <listitem> -<para ->Scrive la stringa data su un file.</para> +<para>Scrive la stringa data su un file.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@File.append(<parameter ->file</parameter -><parameter ->stringa</parameter ->)</function -></term> +<term><function>@File.append(<parameter>file</parameter><parameter>stringa</parameter>)</function></term> <listitem> -<para ->Aggiunge la stringa data alla fine del file.</para> +<para>Aggiunge la stringa data alla fine del file.</para> </listitem> </varlistentry> @@ -485,198 +228,98 @@ </sect2> <sect2 id="strings"> -<title ->Gruppo di Funzioni per Stringhe</title> +<title>Gruppo di Funzioni per Stringhe</title> <variablelist> <varlistentry> -<term -><function ->@String.length(<parameter ->stringa</parameter ->)</function -></term> +<term><function>@String.length(<parameter>stringa</parameter>)</function></term> <listitem> -<para ->Restituisce il numero di caratteri nella stringa.</para> +<para>Restituisce il numero di caratteri nella stringa.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@String.contains(<parameter ->stringa</parameter ->,<parameter ->sottostringa</parameter ->)</function -></term> +<term><function>@String.contains(<parameter>stringa</parameter>,<parameter>sottostringa</parameter>)</function></term> <listitem> -<para ->Controlla se la stringa contiene la sottostringa data.</para> +<para>Controlla se la stringa contiene la sottostringa data.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@String.find(<parameter ->stringa</parameter ->)</function -></term> +<term><function>@String.find(<parameter>stringa</parameter>)</function></term> <listitem> -<para ->Restituisce la posizione di una sottostringa nella stringa, o -1 se non trovata."</para> -<note -><para ->Questo comando avrà un altro parametro intero opzionale indicante la posizione iniziale da cui cercare nella versione Alpha 6.</para -></note> +<para>Restituisce la posizione di una sottostringa nella stringa, o -1 se non trovata."</para> +<note><para>Questo comando avrà un altro parametro intero opzionale indicante la posizione iniziale da cui cercare nella versione Alpha 6.</para></note> </listitem> </varlistentry> <varlistentry> -<term -><function ->@String.left(<parameter ->stringa</parameter ->, <parameter ->int</parameter ->)</function -></term> +<term><function>@String.left(<parameter>stringa</parameter>, <parameter>int</parameter>)</function></term> <listitem> -<para ->Restituisce i primi n caratteri della stringa.</para> +<para>Restituisce i primi n caratteri della stringa.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@String.right(<parameter ->stringa</parameter ->, <parameter ->int</parameter ->)</function -></term> +<term><function>@String.right(<parameter>stringa</parameter>, <parameter>int</parameter>)</function></term> <listitem> -<para ->Restituisce gli ultimi n caratteri della stringa.</para> +<para>Restituisce gli ultimi n caratteri della stringa.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@String.mid(<parameter ->stringa</parameter ->, <parameter ->int inizio</parameter ->, <parameter ->int fine</parameter ->)</function -></term> +<term><function>@String.mid(<parameter>stringa</parameter>, <parameter>int inizio</parameter>, <parameter>int fine</parameter>)</function></term> <listitem> -<para ->Restituisce una sottostringa della stringa, iniziando dalla posizione data.</para> +<para>Restituisce una sottostringa della stringa, iniziando dalla posizione data.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@String.remove(<parameter ->stringa</parameter ->, <parameter ->sottostringa</parameter ->)</function -></term> +<term><function>@String.remove(<parameter>stringa</parameter>, <parameter>sottostringa</parameter>)</function></term> <listitem> -<para ->Rimuove tutte le occorrenze di una data sottostringa.</para> +<para>Rimuove tutte le occorrenze di una data sottostringa.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@String.replace(<parameter ->stringa</parameter ->, <parameter ->sottostringa_trova</parameter ->, <parameter ->sottostringa_sostituisci</parameter ->)</function -></term> +<term><function>@String.replace(<parameter>stringa</parameter>, <parameter>sottostringa_trova</parameter>, <parameter>sottostringa_sostituisci</parameter>)</function></term> <listitem> -<para ->Sostituisce tutte le occorrenze di una data sottostringa con un'altra fornita.</para> +<para>Sostituisce tutte le occorrenze di una data sottostringa con un'altra fornita.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@String.upper(<parameter ->stringa</parameter ->)</function -></term> +<term><function>@String.upper(<parameter>stringa</parameter>)</function></term> <listitem> -<para ->Converte la stringa in maiuscolo.</para> +<para>Converte la stringa in maiuscolo.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@String.lower(<parameter ->stringa</parameter ->)</function -></term> +<term><function>@String.lower(<parameter>stringa</parameter>)</function></term> <listitem> -<para ->Converte la stringa in minuscolo.</para> +<para>Converte la stringa in minuscolo.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@String.compare(<parameter ->stringa</parameter ->, <parameter ->stringa</parameter ->)</function -></term> +<term><function>@String.compare(<parameter>stringa</parameter>, <parameter>stringa</parameter>)</function></term> <listitem> -<para ->Confronta due stringhe. Restituisce 0 se sono uguali, -1 se la prima è più bassa, 1 se la prima è più alta</para> +<para>Confronta due stringhe. Restituisce 0 se sono uguali, -1 se la prima è più bassa, 1 se la prima è più alta</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@String.isEmpty(<parameter ->stringa</parameter ->)</function -></term> +<term><function>@String.isEmpty(<parameter>stringa</parameter>)</function></term> <listitem> -<para ->Controlla se la stringa è vuota.</para> +<para>Controlla se la stringa è vuota.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@String.isNumber(<parameter ->stringa</parameter ->)</function -></term> +<term><function>@String.isNumber(<parameter>stringa</parameter>)</function></term> <listitem> -<para ->Controlla se la stringa è un numero valido.</para> +<para>Controlla se la stringa è un numero valido.</para> </listitem> </varlistentry> @@ -684,32 +327,18 @@ </sect2> <sect2 id="builtins"> -<title ->Variabili Globali Integrate</title> -<para ->L'accesso alle variabili globali integrate è analogo alle variabili globali regolari con <function ->@global</function ->.</para> +<title>Variabili Globali Integrate</title> +<para>L'accesso alle variabili globali integrate è analogo alle variabili globali regolari con <function>@global</function>.</para> <variablelist> <varlistentry> -<term -><function ->@global(_KDDIR)</function -></term> +<term><function>@global(_KDDIR)</function></term> <listitem> -<para ->La cartella in cui si trova la finestra di dialogo corrente.</para> +<para>La cartella in cui si trova la finestra di dialogo corrente.</para> </listitem> </varlistentry> <varlistentry> -<term -><function ->@global(_NAME)</function -></term> -<listitem -><para ->Il nome della finestra di dialogo</para -></listitem> +<term><function>@global(_NAME)</function></term> +<listitem><para>Il nome della finestra di dialogo</para></listitem> </varlistentry> </variablelist> </sect2> |