# Manuale di &kandy;

## Uso di &kandy;

### Finestra del terminale

La finestra del terminale ti fornisce una interfaccia avanzata con la quale puoi controllare il tuo cellulare attraverso i comandi `AT` di un comune modem. Questi comandi vanno digitati nel campo che si trova in posizione centrale e in alto. Il campo che si trova più in basso ti mostra invece la risposta diretta che ottieni dal telefono cellulare. A fianco, nel lato destro della finestra, vedi il risultato delle tue operazioni.

Nella zona a sinistra della finestra trovi una lista di comandi predefiniti. Puoi eseguirli semplicemente facendo un doppio clic sul comando oppure facendo clic sul pulsante Esegui. Nel campo "output" vedrai la risposta del cellulare. Se digiti un comando che non è in elenco lo puoi aggiungere alla lista facendo clic su Aggiungi. Comparirà inoltre una finestra di dialogo nella quale potrai scegliere il nome e i parametri per quel comando.

La lista dei comandi può essere salvata in un file &XML; selezionando Salva dal menu oppure facendo clic sul pulsante corrispondente che si trova nella barra degli strumenti. Per caricare la lista dei comandi devi scegliere Apridal menu oppure devi fare clic sul pulsante corrispondente nella barra degli strumenti.

### Interfaccia utente grafica del cellulare

Scegliendo Interfaccia utente grafica del cellulare dal menu Mostra della finestra del terminale aprirai una finestra che ti da una panoramica dello stato e dei dati presenti nel cellulare, compresa la rubrica. Ci sono due liste per la rubrica: la prima rappresenta la rubrica di &kde; e la seconda rappresenta la rubrica presente nel cellulare.

Per leggere il contenuto di ciascuna rubrica è sufficiente fare clic sul pulsante Leggi situato sotto la lista corrispondente. Facendo clic invece sul pulsante Scrivi salverai i dati contenuti nella lista nelle rispettive rubriche.Il pulsante Salva su file ti consente di salvare la rubrica del cellulare in un file in formato CSV (valori separati da virgole). Una volta che hai caricato la rubrica utilizzando il pulsante Leggi puoi unificare le due rubriche facendo clic sul pulsante Unisci. Questa operazione copia le voci che sono presenti solo in una delle due rubriche nell'altra e vice versa. Se il programma incontra dei conflitti durante l'unione delle rubriche ti compare una finestra di dialogo per risolverli.

Il pulsante Sincronizza esegue tutte le azioni necessarie per sincronizzare le rubriche. Per prima cosa legge i dati dalla rubrica di &kde; e dalla rubrica del cellulare poi unifica le voci e le salva nei rispettivi dispositivi.

### Configurazione di &kandy;

Selezionando Configura Kandy dal menu Impostazioni compare una finestra di dialogo che ti consente di modificare le preferenze di &kandy;. In questa finestra puoi selezionare il nome del dispositivo seriale al quale è connesso il tuo telefono cellulare. Alcuni esempi di nomi di dispositivi seriali sotto &Linux; sono: `/dev/ttyS0` per la prima e `/dev/ttyS1` per la seconda porta seriale del tuo computer. In questa finestra puoi selezionare inoltre quale finestra di &kandy; deve comparire all'avvio dell'applicazione.

## Guida ai menu

### Menu File

&Ctrl;Q File Esci

- Esce da &kandy;.

### Menu Mostra

Mostra Terminale

- Apre la finestra terminale nella quale puoi comunicare con il cellulare attraverso i comandi `AT`.

### Menu Modem

Modem Connettiti

- Si connette al cellulare.

Modem Disconnettiti

- Si disconnette dal cellulare.

### Menu Impostazioni

Impostazioni Mostra la barra degli strumenti

- Attiva/Disattiva la visualizzazione della barra degli strumenti.

Impostazioni Mostra la barra di stato

- Attiva/Disattiva la visualizzazione della barra di stato.

Impostazioni Configura le scorciatoie...

- Apre una finestra di dialogo nella quale puoi modificare le associazioni dei tasti per le scorciatoie.

Impostazioni Configura le barre degli strumenti...

- Apre una finestra di dialogo nella quale puoi modificare le icone nella barra degli strumenti.

Impostazioni Configura Kandy...

- Apre una finestra di dialogo nella quale puoi personalizzare l'applicazione. Questo è spiegato con maggior dettaglio nella sezione configuring.

### Menu Aiuto

&help.menu.documentation;

## Riconoscimenti e Licenza

&kandy; copyright 2001 Cornelius Schumacher schumacher@kde.org.

Documentazione scritta da Cornelius Schumacher, con l'aiuto di Lauri Watts lauri@kde.org.

Documentazione tradotta da: Nicola Ruggero nicola@nxnt.org

&underGPL; &underFDL;

## Installazione

### Come ottenere &kandy;

&install.intro.documentation;

### Requisiti

Per riuscire a compilare correttamente il pacchetto tdepim, che contiene &kandy;, devi avere installato il pacchetto tdelibs. Il pacchetto tdelibs lo puoi trovare nella stessa posizione in cui trovi il pacchetto tdepim.

&kaddressbook; fa parte del pacchetto tdebase. Anche quest'ultimo lo puoi trovare nella stessa posizione in cui trovi il pacchetto tdepim.

### Compilazione e Installazione

&install.compile.documentation;

Per la compilazione e l'installazione del pacchetto tdelibs devi seguire la stessa procedura. Per qualsiasi problema di compilazione o installazione di &kandy;, puoi chiedere aiuto alla mailing list di &kde; oppure puoi consultare il newsgroup: comp.windows.x.kde.

## Informazioni per gli sviluppatori

### Interfaccia DCOP

&kandy; fornisce una interfaccia DCOP chiamata KandyIface che contiene le seguenti funzioni: `syncPhonebook()` sincronizza la rubrica del telefono cellulare con la rubrica di &kde;. Equivale a fare clic sul pulsante Sincronizza situato nella interfaccia utente grafica del cellulare. `exit()` esce da &kandy;.