# O Manual do &kandy;

Cornelius
Schumacher

    schumacher@kde.org

José
Pires

    jncp@netcabo.pt

Tradução
2002-02-05
0.03.00

O &kandy; é uma aplicação para sincronizar os dados de um telemóvel com os dados no ecrã.

KDE
kdepim
kandy
sincronização
telefone

## Utilizar o &kandy;

### A Janela de Terminal

A janela do terminal oferece uma interface de baixo nível para controlar o telemóvel através de comandos de modem `AT`. Você poderá escrever os comandos no campo central em cima: os campos centrais inferiores mostram a resposta directa do telemóvel; o lado direito da janela principal mostra o resultado processado.

Do lado esquerdo, você tem a lista dos comandos disponíveis; você podê-los-á executar se fizer um duplo-click neles ou se carregar no botão Executar. Os campos do resultado da resposta do modem mostram o que acontece. Se você escrito um comando novo, podê-lo-á adicionar à lista de comandos disponíveis, seleccionando o botão Adicionar; irá aparecer uma janela que lhe permite seleccionar um nome e os parâmetros do comando.

A lista de comandos é gravada num ficheiro &XML; ao seleccionar a opção Gravar do menu ou ao carregar o botão respectivo da barra de ferramentas. Você poderá carregar um ficheiro existente ao seleccionar a opção Abrir do menu.

### Janela de Interface com o Telemóvel

Ao escolher a Interface do Telemóvel do menu Mostrar da janela do terminal, você irá abrir a Janela da Interface do seu telemóvel. Isto mostra uma interface compreensível do estado e dos dados presentes no telemóvel, incluindo a lista telefónica. Existem duas listas de dados da lista telefónica: um que representa o livro de endereços do &kde; e o outro representa os dados do telemóvel.

Você poderá ler as listas telefónicas se carregar no botão Ler por baixo da lista correspondente. Se carregar no botão Gravar poderá escrever os dados da lista na lista telefónica correspondente. Se carregar em Gravar para Ficheiro você poderá guardar a lista telefónica do telemóvel como uma lista de valores separados por vírgulas no disco. Depois de carregar os dados da lista telefónica com os botões Ler, você poderá juntar as listas telefónicas se carregar no botão Juntar: isto irá colocar os dados apenas numa das listas na outra e vice-versa; se ocorrerem conflitos durante este processo, irá aparecer uma janela.

O botão Sincronizar efectua todas as acções necessárias para sincronizar as listas telefónicas. Ele lê os dados do livro de endereços do &kde; e do telemóvel, faz a junção e volta a escrever no telemóvel.

### Configurar o &kandy;

Ao seleccionar o item Configurar o Kandy do menu, você irá obter a janela de preferências do &kandy;. Você poderá definir o nome do dispositivo série a que o seu telemóvel está ligado nesta janela; os exemplos de nomes dos dispositivos série no &Linux; são o `/dev/ttyS0` para a primeira e `/dev/ttyS1` para a segunda interface série do seu computador. Você poderá também definir que janelas é que ficam abertas por omissão ao iniciar o &kandy;.

## Referência do Menu

### O menu Ficheiro

&Ctrl;Q Ficheiro Sair

  Sai do &kandy;.

### Menu Mostrar

Mostrar Terminal

  Abre a janela de terminal, onde pode interagir com o seu telefone utilizando comandos `AT`.

### Menu Modem

Modem Ligar

  Liga-se ao seu telefone.

Modem Desligar

  Desliga-se do seu telefone.

### O menu Configuração

Configuração Mostrar a Barra de Ferramentas

  Mostra ou esconde a barra de ferramentas.

Configuração Mostrar a Barra de Estado

  Mostra ou esconde a barra de estado.

Configuração Configurar os Atalhos...

  Abre uma janela para modificar os atalhos do teclado.

Configuração Configurar as Barras de Ferramentas...

  Abre uma janela para modificar os ícones na barra de ferramentas.

Configuração Configurar o Kandy...

  Abre uma janela onde poderá personalizar a aplicação.; isto é descrito com mais detalhe na secção .

### O menu Ajuda

&help.menu.documentation;

## Créditos e Licenças

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

Documentação por Cornelius Schumacher, com adições por Lauri Watts lauri@kde.org.

Tradução de José Nuno Pires jncp@netcabo.pt

&underGPL; &underFDL;

## Instalação

### Como obter o &kandy;

&install.intro.documentation;

### Requisitos

Você irá necessitar de ter o pacote 'kdelibs' instalado para poder compilar com sucesso o pacote 'kdepim' que contém o &kandy;. O pacote 'kdelibs' poderá ser encontrado na mesma localização que o pacote 'kdepim'.

O &kaddressbook; faz parte do pacote kdebase. Pode ser encontrado na mesma localização do que o pacote kdepim.

### Compilação e Instalação

&install.compile.documentation;

A compilação e instalação do pacote obrigatório 'kdelibs' segue o mesmo processo. Se você tiver alguns problemas a compilar ou a instalar o &kandy;, poderá obter alguma ajuda nas listas de correio do &kde; ou no grupo de notícias da Usenet: comp.windows.x.kde.

## Informações para Programadores

### Interface DCOP

O &kandy; contém uma interface de DCOP KandyIface com as seguintes funções: a `syncPhonebook()` sincroniza a lista telefónica do telemóvel com o livro de endereços do &kde;. Isto é equivalente a carregar no botão Sincronizar da Janela de Interface do Telemóvel. A `exit()` fecha o &kandy;.