# O Manual do &kandy;

Cornelius Schumacher

    schumacher@kde.org

Marcus Gama

    marcus_gama@uol.com.br

Tradução
2002-02-05
0.03.00

O &kandy; é uma aplicação para sincronizar os dados de um celular com os dados no ambiente de trabalho.

KDE kdepim kandy sincronização telefone

## Usando o &kandy;

### A Janela de Terminal

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

Do lado esquerdo, você tem a lista dos comandos disponíveis; você poderá executé-los se fizer um duplo-clique neles ou se clicar no botão Executar. Os campos do resultado da resposta do modem mostram o que acontece. Se você digitou um comando novo, você poderá adicioná-lo à lista de comandos disponíveis selecionando o botão Adicionar; um diálogo aparecerá permitindo que você selecione um nome e os parâmetros do comando.

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

### Janela de Interface com o Celular

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

Você poderá ler as listas telefônicas clicando no botão Ler abaixo da lista correspondente. Clicando no botão Escrever você poderá escrever os dados da lista na lista telefônica correspondente. Pressionando em Salvar para Arquivo você poderá guardar a lista telefônica do celular 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 clicando no botão Mesclar: isto apenas irá colocar os dados de uma das listas na outra e vice-versa; se ocorrerem conflitos durante este processo, irá aparecer um diálogo.

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

### Configurando o &kandy;

Ao selecionar o item Configurar o Kandy do menu, você irá obter o diálogo de preferências do &kandy;. Você poderá definir o nome do dispositivo serial ao qual o seu celular está conectado neste diálogo; os exemplos de nomes dos dispositivos seriais no &Linux; são o `/dev/ttyS0` para a primeira e `/dev/ttyS1` para a segunda interface serial do seu computador. Você poderá também definir que janelas ficam abertas por padrão ao iniciar o &kandy;.

## Referência do Menu

### O menu Arquivo

&Ctrl;Q Arquivo 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 Conectar

  Conecta-se ao seu telefone.

Modem Desconectar

  Desconecta-se do seu telefone.

### O menu Configurações

Configurações Mostrar Barra de Ferramentas

  Mostra ou oculta a barra de ferramentas.

Configurações Mostrar Barra de Estado

  Mostra ou oculta a barra de estado.

Configurações Configurar Atalhos...

  Abre um diálogo padrão para modificar os atalhos do teclado.

Configurações Configurar Barras de Ferramentas...

  Abre um diálogo padrão para modificar os ícones na barra de ferramentas.

Configurações Configurar o Kandy...

  Abre um diálogo onde poderá personalizar a aplicação.; isto é descrito com mais detalhe na seção .

### O menu Ajuda

&help.menu.documentation;

## Créditos e Licenças

Direitos autorais 2001 do &kandy; para Cornelius Schumacher schumacher@kde.org.

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

Tradução de Marcus Gamamarcus_gama@uol.com.br

&underGPL; &underFDL;

## Instalação

### Como obter o &kandy;

&install.intro.documentation;

### Requisitos

Você irá necessitar do 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. Ele 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 algum problema ao compilar ou 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 celular com o livro de endereços do &kde;. Isto é equivalente a clicar no botão Sincronizar da Janela de Interface do Celular. A `exit()` fecha o &kandy;.