Provided by: kde-l10n-pt_4.7.1-0ubuntu1_all bug

NAME

       kabcclient - cliente de linha de comandos para o livro de enderecos do
       KDE

SYNOPSIS

       kabcclient [[-A] | [-R] | [-M] | [-S] | [-L]] [--match-case] [--nosave]
                  [-ic codifica,c~ao] [-if formato] [-if-opts op,c~oes-formato]
                  [-oc codifica,c~ao] [-of formato] [-of-opts op,c~oes-formato]
                  [dados-entrada]

DESCRI,c~aO

       O kabcclient permite o acesso pela linha de comandos ao livro de
       enderecos do KDE, como por exemplo em programas da linha de comandos.
       Suporta a introducao de dados a partir do 'stdin' ou atraves de
       argumentos adicionais. O resultado e sempre enviado para o 'stdout'.

OP,c~oES

       Modos de opera,c~ao

           -A, --add
               Adiciona um novo item de contacto ao livro de enderecos

           -R, --remove
               Remove um contacto existente do livro de enderecos

           -M, --merge
               Reune os dados a entrada com um item de contacto existente no
               livro de enderecos. Este adiciona todas as informacoes novas ao
               contacto ja existente.

           -S, --search
               Procura no livro de enderecos pelos contactos correspondentes

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

       Op,c~oes de entrada

           -ic, --input-codec
               Passa os dados de entrada atraves de uma codificacao de texto
               especifica. Veja o -ic help para obter mais informacoes sobre
               as codificacoes de entrada. Por omissao e igual a local, que
               ira usar a codificacao para a configuracao regional actual do
               locale(5)

           -if, --input-format
               Processa o texto a entrada de acordo com determinadas regras de
               formatacao. Veja os formatos disponiveis com o -if help. Por
               omissao, e igual a search

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

           -if-opts, --input-format-options
               Opcoes adicionais para o formato de entrada escolhido. Algumas
               poderao ser obrigatorias e outras opcionais, dependendo do
               formato. Veja o -if-opts help para obter as opcoes de formato
               disponiveis

       Op,c~oes de sa'ida

           -oc, --output-codec
               Passa o texto a saida por uma dada codificacao de texto. Veja
               em -oc help algumas informacoes adicionais sobre as
               codificacoes a saida. Por omissao e usado o local, o qual ira
               usar a codificacao regional actual do locale(5).

           -of, --output-format
               Formata o texto a saida de acordo com determinadas regras de
               formatacao. Veja os formatos disponiveis em -of help. Por
               omissao, e igual a vcard

           -of-opts, --output-format-options
               Opcoes adicionais para o formato de saida escolhido. Algumas
               poderao ser obrigatorias e outras opcionais, dependendo do
               formato. Veja o -of-opts help para obter as opcoes de formato
               disponiveis

       Op,c~oes adicionais

           --match-case
               Usar uma correspondencia de texto com distincao de maiusculas,
               ao comparar o texto a entrada com os itens de contactos

           --nosave
               Efectua as operacoes de mudanca das informacoes, como o -A, -R
               ou o -M, apenas em memoria mas nao guarda as alteracoes no
               livro de enderecos

DIAGN'oSTICOS

       Como e normal, um codigo a saida igual a zero corresponde a sucesso.
       Dependendo da operacoes escolhida, um codigo diferente de zero
       corresponde a um dado problema que a aplicacao encontrou

       ADI,C~AO

           1
               A leitura do texto a entrada foi mal-sucedida

           2
               A criacao de um item de contacto adequado foi mal-sucedida, de
               acordo com o texto a entrada; p.ex. poderao nao existir dados
               ou estes terem um formato invalido para o formato de entrada
               escolhido

           3
               A gravacao das alteracoes no livro de enderecos foi
               mal-sucedida. Isto podera ser derivado, por exemplo, de outras
               aplicacoes estarem a bloquear o livro de enderecos de momento.

       REMO,C~AO

           1
               A leitura do texto a entrada foi mal-sucedida

           2
               O programa nao conseguiu remover nenhum item de contactos do
               livro de enderecos. Isto podera ser derivado de um problema ao
               processar os dados de entrada, por nao encontrar qualquer item
               correspondente no livro de enderecos ou por ter devolvido mais
               de um item correspondente. No ultimo caso, aparecera uma
               mensagem de erro no 'stderr'

           3
               A gravacao das alteracoes no livro de enderecos foi
               mal-sucedida. Isto podera ser derivado, por exemplo, de outras
               aplicacoes estarem a bloquear o livro de enderecos de momento.

       REUNI~AO

           1
               A leitura do texto a entrada foi mal-sucedida

           2
               O programa nao conseguiu reunir os dados de entrada com nenhum
               item de contacto do livro de enderecos. Isto podera ser
               derivado de um erro no processamento dos dados de entrada, por
               nao conseguir encontrar um item de contacto correspondente no
               livro de enderecos ou por encontrar mais de um item de contacto
               correspondente no livro de enderecos. No ultimo caso, sera
               apresentada uma mensagem de erro no 'stderr'

           3
               A gravacao das alteracoes no livro de enderecos foi
               mal-sucedida. Isto podera ser derivado, por exemplo, de outras
               aplicacoes estarem a bloquear o livro de enderecos de momento.

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

           2
               O programa nao conseguiu encontrar nenhum item de contacto
               correspondente no livro de enderecos. Isto podera ser derivado
               de um erro no processamento dos dados a entrada ou na pesquisa
               de um item correspondente no livro de enderecos

EXEMPLOS

       Procurar pelos itens de contacto com 'Jos'e' no nome ou nos endere,cos de
       e-mail

           kabcclient -S Jose

       Fazer o mesmo, mas com a distin,c~ao entre mai'usculas e min'usculas activa

           kabcclient --match-case -S Jose

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

           echo "Jose" | kabcclient --match-case -S

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

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

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

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

       Listar os formatos de entrada dispon'iveis

           kabcclient -if help

       Listar os formatos de sa'ida dispon'iveis

           kabcclient -of help

       Listar as op,c~oes dispon'iveis para o formato de sa'ida 'email'

           kabcclient -of email -of-opts help

       Listar todos os endere,cos de e-mail de todos os contactos que cont^em
       'Jos'e'

           kabcclient -of email -of-opts allemails -S Jose

       Remover todos os contactos que o utilizador seleccionou na janela da
       lista de selec,c~ao de contactos

           kabcclient --remove -if dialog

       Exportar os contactos seleccionados para um ficheiro VCard (formato
       predefinido de sa'ida)

           kabcclient -S -if dialog > contactos.vcf

AUTORIA

       Esta pagina de manual foi escrita por Kevin Krammer
       <kevin.krammer@gmx.at>. E dada a permissao para copiar, distribuir e/ou
       modificar este documento, segundo os termos da Licenca Publica da GNU
       (GPL), versao 2 ou posteriores publicas pela Free Software Foundation.

       Nos sistemas Debian, o texto completo desta licenca podera ser
       encontrado em /usr/share/common-licenses/GPL.