Provided by: kde-l10n-pt_4.3.2-0ubuntu1_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

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.