| KABCCLIENT(1) | Manual do Utilizador do KDE | KABCCLIENT(1) |
NAME¶
kabcclient - cliente de linha de comandos para o livro de endereços do KDESYNOPSIS¶
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
Opções de entrada
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
-ic, --input-codec
Opções de saída
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
-oc, --output-codec
Opções adicionais
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
--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
REMOÇÃO
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.
1
REUNIÃO
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.
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-mailkabcclient -S José
kabcclient --match-case -S José
echo "José" | kabcclient --match-case -S
kabcclient --nosave --add -if email "José Povinho <josepovinho@exemplo.com>"
kabcclient --add -if email "José Povinho <josepovinho@exemplo.com>"
kabcclient -if help
kabcclient -of help
kabcclient -of email -of-opts help
kabcclient -of email -of-opts allemails -S José
kabcclient --remove -if dialog
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.AUTHOR¶
Kevin Krammer <kevin.krammer@gmx.at>Autoria
| 2005-09-08 | Ambiente de Trabalho K |