Provided by:
kde-l10n-pt_4.4.2-0ubuntu6_all 
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 codificação] [-if formato] [-if-opts opções-formato]
[-oc codificação] [-of formato] [-of-opts opções-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 operação
-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
Opções 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
Opções de saÃda
-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
Opções 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
ADIÇÃO
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.
REMOÇÃO
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.
REUNIÃO
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 endereços de
e-mail
kabcclient -S José
Fazer o mesmo, mas com a distinção entre maiúsculas e minúsculas 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
endereço 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 endereços
kabcclient --add -if email "José Povinho <josepovinho@exemplo.com>"
Listar os formatos de entrada disponÃveis
kabcclient -if help
Listar os formatos de saÃda disponÃveis
kabcclient -of help
Listar as opções disponÃveis para o formato de saÃda ’email’
kabcclient -of email -of-opts help
Listar todos os endereços de e-mail de todos os contactos que contêm
’José’
kabcclient -of email -of-opts allemails -S José
Remover todos os contactos que o utilizador seleccionou na janela da
lista de selecção de contactos
kabcclient --remove -if dialog
Exportar os contactos seleccionados para um ficheiro VCard (formato
predefinido de saÃda)
kabcclient -S -if dialog > contactos.vcf
AUTORIA
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.