Provided by: kde-l10n-pt_4.8.2-0ubuntu2_all bug

NAME

       kabcclient - cliente de linha de comandos para o livro de endereços do
       KDE

SYNOPSIS

       kabcclient [[-A] | [-R] | [-M] | [-S] | [-L]] [--match-case] [--nosave]
                  [-ic codificao] [-if formato] [-if-opts opes-formato]
                  [-oc codificao] [-of formato] [-of-opts opes-formato]
                  [dados-entrada]

DESCRIçãO

       O kabcclient permite o acesso pela linha de comandos ao livro de
       endereços do KDE, como por exemplo em programas da linha de comandos.
       Suporta a introdução de dados a partir do 'stdin' ou através de
       argumentos adicionais. O resultado é sempre enviado para o 'stdout'.

OPçõES

       Modos de operao

           -A, --add
               Adiciona um novo item de contacto ao livro de endereços

           -R, --remove
               Remove um contacto existente do livro de endereços

           -M, --merge
               Reúne os dados à entrada com um item de contacto existente no
               livro de endereços. Este adiciona todas as informações novas ao
               contacto já existente.

           -S, --search
               Procura no livro de endereços pelos contactos correspondentes

           -L, --list
               Lista todos os itens de contactos do livro de endereços

       Opes de entrada

           -ic, --input-codec
               Passa os dados de entrada através de uma codificação de texto
               específica. Veja o -ic help para obter mais informações sobre
               as codificações de entrada. Por omissão é igual a local, que
               irá usar a codificação para a configuração regional actual do
               locale(5)

           -if, --input-format
               Processa o texto à entrada de acordo com determinadas regras de
               formatação. Veja os formatos disponíveis com o -if help. Por
               omissão, é igual a search

           Em vez de ler o texto à entrada, o 'kabcclient' pode mostrar uma
           janela para seleccionar os contactos com o formato de entrada
               dialog

           -if-opts, --input-format-options
               Opções adicionais para o formato de entrada escolhido. Algumas
               poderão ser obrigatórias e outras opcionais, dependendo do
               formato. Veja o -if-opts help para obter as opções de formato
               disponíveis

       Opes de sada

           -oc, --output-codec
               Passa o texto à saída por uma dada codificação de texto. Veja
               em -oc help algumas informações adicionais sobre as
               codificações à saída. Por omissão é usado o local, o qual irá
               usar a codificação regional actual do locale(5).

           -of, --output-format
               Formata o texto à saída de acordo com determinadas regras de
               formatação. Veja os formatos disponíveis em -of help. Por
               omissão, é igual a vcard

           -of-opts, --output-format-options
               Opções adicionais para o formato de saída escolhido. Algumas
               poderão ser obrigatórias e outras opcionais, dependendo do
               formato. Veja o -of-opts help para obter as opções de formato
               disponíveis

       Opes adicionais

           --match-case
               Usar uma correspondência de texto com distinção de maiúsculas,
               ao comparar o texto à entrada com os itens de contactos

           --nosave
               Efectua as operações de mudança das informações, como o -A, -R
               ou o -M, apenas em memória mas não guarda as alterações no
               livro de endereços

DIAGNóSTICOS

       Como é normal, um código à saída igual a zero corresponde a sucesso.
       Dependendo da operações escolhida, um código diferente de zero
       corresponde a um dado problema que a aplicação encontrou

       ADIO

           1
               A leitura do texto à entrada foi mal-sucedida

           2
               A criação de um item de contacto adequado foi mal-sucedida, de
               acordo com o texto à entrada; p.ex. poderão não existir dados
               ou estes terem um formato inválido para o formato de entrada
               escolhido

           3
               A gravação das alterações no livro de endereços foi
               mal-sucedida. Isto poderá ser derivado, por exemplo, de outras
               aplicações estarem a bloquear o livro de endereços de momento.

       REMOO

           1
               A leitura do texto à entrada foi mal-sucedida

           2
               O programa não conseguiu remover nenhum item de contactos do
               livro de endereços. Isto poderá ser derivado de um problema ao
               processar os dados de entrada, por não encontrar qualquer item
               correspondente no livro de endereços ou por ter devolvido mais
               de um item correspondente. No último caso, aparecerá uma
               mensagem de erro no 'stderr'

           3
               A gravação das alterações no livro de endereços foi
               mal-sucedida. Isto poderá ser derivado, por exemplo, de outras
               aplicações estarem a bloquear o livro de endereços de momento.

       REUNIO

           1
               A leitura do texto à entrada foi mal-sucedida

           2
               O programa não conseguiu reunir os dados de entrada com nenhum
               item de contacto do livro de endereços. Isto poderá ser
               derivado de um erro no processamento dos dados de entrada, por
               não conseguir encontrar um item de contacto correspondente no
               livro de endereços ou por encontrar mais de um item de contacto
               correspondente no livro de endereços. No último caso, será
               apresentada uma mensagem de erro no 'stderr'

           3
               A gravação das alterações no livro de endereços foi
               mal-sucedida. Isto poderá ser derivado, por exemplo, de outras
               aplicações estarem a bloquear o livro de endereços de momento.

           PESQUISA, 1
               A leitura do texto à entrada foi mal-sucedida

           2
               O programa não conseguiu encontrar nenhum item de contacto
               correspondente no livro de endereços. Isto poderá ser derivado
               de um erro no processamento dos dados à entrada ou na pesquisa
               de um item correspondente no livro de endereços

EXEMPLOS

       Procurar pelos itens de contacto com 'Jos' no nome ou nos endereos de
       e-mail

           kabcclient -S José

       Fazer o mesmo, mas com a distino entre maisculas e minsculas activa

           kabcclient --match-case -S José

       Fazer o mesmo, mas lendo o texto  entrada do 'stdin'

           echo "José" | kabcclient --match-case -S

       Tentar adicionar um item de contacto novo, usando os dados de um
       endereo de e-mail formatado

           kabcclient --nosave --add -if email "José Povinho <josepovinho@exemplo.com>"

       Fazer o mesmo, mas desta vez guardando os dados no livro de endereos

           kabcclient --add -if email "José Povinho <josepovinho@exemplo.com>"

       Listar os formatos de entrada disponveis

           kabcclient -if help

       Listar os formatos de sada disponveis

           kabcclient -of help

       Listar as opes disponveis para o formato de sada 'email'

           kabcclient -of email -of-opts help

       Listar todos os endereos de e-mail de todos os contactos que contm
       'Jos'

           kabcclient -of email -of-opts allemails -S José

       Remover todos os contactos que o utilizador seleccionou na janela da
       lista de seleco de contactos

           kabcclient --remove -if dialog

       Exportar os contactos seleccionados para um ficheiro VCard (formato
       predefinido de sada)

           kabcclient -S -if dialog > contactos.vcf

AUTHOR

       Esta página de manual foi escrita por Kevin Krammer
       <kevin.krammer@gmx.at>. É dada a permissão para copiar, distribuir e/ou
       modificar este documento, segundo os termos da Licença Pública da GNU
       (GPL), versão 2 ou posteriores publicas pela Free Software Foundation.

       Nos sistemas Debian, o texto completo desta licença poderá ser
       encontrado em /usr/share/common-licenses/GPL.