<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY korn "<application>korn</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
]>
<book lang="pt-BR">
<bookinfo>
<title>Manual do KOrn</title>
<authorgroup>
<author>
<surname>Sirtaj Singh Kang, </surname>
<affiliation>
<address><email><ulink url="mailto:taj@kde.org">taj@kde.org</ulink></email></address>
</affiliation>
</author>
</authorgroup>
<date>Versão 0.3, 14 Setembro 1998</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<abstract>
<para>Esta documentação foi atualizada pela última vez para o KOrn versão 0.3. Queira dirigir quaisquer comentários e adições ao autor.</para>
<para>the KOrn Handbook</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>KOrn</keyword>
<keyword>mailbox checker</keyword>
</keywordset>
</bookinfo>

<chapter id="introduo">
<title>Introdução</title>

<sect1 id="o-que-o-korn">
<title>O que é o KOrn?</title>

<para>KOrn é um programa compatível com X11 e KDE que monitora arquivos de caixas
postais UNIX, procurando por mensagens recém-chegadas e não lidas. Ele
varre periodicamente cada caixa postal e mostra o número de mensagens não lidas
que a caixa contém, em um pequeno botão na tela. Os recursos incluem:</para>

<para><itemizedlist>
<listitem>
<para>Freqüência de varredura especificada separadamente para cada caixa;</para>
</listitem>
<listitem>
<para>Layout dos botões pode ser horizontal ou vertical;</para>
</listitem>
<listitem>
<para>Customização de comandos a serem executados pela notificação de nova
mensatem e clique de botão;</para>
</listitem>
<listitem>
<para>Configuração simplificada; </para>
</listitem>
<listitem>
<para>Não usa as bibliotecas Xt/Xaw :-)</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="por-que-tem-o-nome-korn">
<title>Por que tem o nome "KOrn" ?</title>

<para>Para os que perguntaram, ele é chamado KOrn pois:</para>

<para><itemizedlist>
<listitem>
<para><literal remap="tt">1.</literal> começa com K;</para>
</listitem>
<listitem>
<para><literal remap="tt">2.</literal> há muitos programas KDE com nomes sérios;</para>
</listitem>
<listitem>
<para><literal remap="tt">3.</literal> Eu assisti a um fabuloso concerto
<ulink url="http://www.korn.com/">KoRn</ulink> quando a versão 0.1 desse
software estava sendo escrita.</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="por-quem-o-korn-foi-escrito">
<title>Por quem o KOrn foi escrito ?</title>

<para>Pessoas que assinam muitas listas de discussão e/ou filtram mensagens de
e-mail em caixas postais separadas (com <emphasis>procmail</emphasis>, por exemplo). Não
há mais necessidade de rodas 10 xbiffs ou qbiffs... basta rodar um KOrn.</para>
</sect1>
</chapter>

<chapter id="instalao">
<title>Instalação</title>

<sect1 id="como-obter-o-korn">
<title>Como obter o KOrn</title>

<para>A última versão do KOrn é <emphasis>0.3</emphasis>. Ela pode ser obtida de:</para>

<para><itemizedlist>
<listitem>
<para>Site FTP do KDE e espelhos, em
<ulink url="ftp://ftp.kde.org/pub/kde/unstable/apps/network/">ftp://ftp.kde.org/pub/kde/unstable/apps/network/</ulink>.</para>
</listitem>
<listitem>
<para>Repositório FTP do autor, em
<ulink url="ftp://ftp.ph.unimelb.edu.au/pub/users/taj/kde/">ftp://ftp.ph.unimelb.edu.au/pub/users/taj/kde/</ulink>.</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="pr-requisitos">
<title>Pré-requisitos</title>

<para>Você também precisa de um computador rodando X11, Unix e o KDE, bem como
as bibliotecas Qt. Este programa já foi testado nas plataformas
Linux/x86 com XFree86, e MkLinux/PPC with X11R6.</para>
</sect1>

<sect1 id="compilao-e-instalao">
<title>Compilação e instalação</title>

<para>As instruções de compilação e instalação são as genéricas para todos os
aplicativos do KDE.</para>
</sect1>
</chapter>

<chapter id="fundamentos">
<title>Fundamentos</title>

<sect1 id="como-eu-configuro-o-korn">
<title>Como eu configuro o KOrn ?</title>

<para>Para configurar o KOrn a seu gosto uma vez que esteja instalado, basta 
rodá-lo, ou digite <literal remap="tt">korn</literal> na linha de comando do UNIX. Você será conduzido
a um procedimento simples de instalação. Segue a descrição de cada opção:</para>

<para><itemizedlist>
<listitem>
<para><literal remap="tt">Nome</literal> Um nome de referência, curto e <emphasis remap="bf">único</emphasis> para a caixa.
Não coloque vírgulas neste nome.</para>
</listitem>
<listitem>
<para><literal remap="tt">Mensagem</literal> A mensagem a ser mostrada na Dica para a caixa postal.</para>
</listitem>
<listitem>
<para><literal remap="tt">Caminho</literal> O caminho da caixa postal a ser monitorada.</para>
</listitem>
<listitem>
<para><literal remap="tt">Tempo</literal> O intervalo, em segundos, entre varreduras na caixa.
Não é bom usar valores menores que 20 segundos, pois isso vai consumir 
inutilmente tempo de CPU (ou seja, vai tornar sua maquina mais lenta).</para>
</listitem>
<listitem>
<para><literal remap="tt">Comando de notificação</literal> O comando a ser executado quando novas
mensagens forem recebidas na caixa. Útil para reproduzir sons, por exemplo.</para>
</listitem>
<listitem>
<para><literal remap="tt">Comando de Clique</literal> O comando a ser executado quando o botão da
caixa for clicado, quando houver novos e-mails.</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="opes-de-linha-de-comando">
<title>Opções de linha de comando</title>

<para><itemizedlist>
<listitem>
<para><literal remap="tt">--nomouse</literal> Se o KOrn é iniciado com esta opção, ele irá ignorar
quaisquer eventos do mouse. Isso é util ao rodar-se o KOrn embutido no Painel
ou no FVWM.</para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="limitaes-e-problemas-conhecidos">
<title>Limitações e problemas conhecidos</title>

<para><itemizedlist>
<listitem>
<para>Caixas velhas não são removidas do arquivo de configuração quando
são renomeadas.
Uma caixa listada duas vezes é criada com o novo nome. Isto não poderá ser
consertado até que apareça um método para remover grupos na classe
<emphasis>KConfig</emphasis> do KDE.</para>
</listitem>
<listitem>
<para>Precisa ser reiniciado para recarregar a nova configuração.</para>
</listitem>
<listitem>
<para>Muitas outras coisas.</para>
</listitem>
</itemizedlist>
</para>
</chapter>

<chapter id="eplogo">
<title>Epílogo</title>

<sect1 id="desenvolvedores">
<title>Desenvolvedores</title>

<para><literal remap="tt"><ulink url="mailto:taj@kde.org">Sirtaj Singh Kang</ulink> - Autor, mantenedor
<ulink url="http://www.ph.unimelb.edu.au/~ssk/">(Home page)</ulink></literal></para>
</sect1>

<sect1 id="autores">
<title>Autores</title>

<para><literal remap="tt"><ulink url="mailto:taj@kde.org">Sirtaj Singh Kang</ulink> - Redactor</literal></para>

<para><literal remap="tt"><ulink url="mailto:ebisch@cybercable.tm.fr">Eric Bischoff</ulink> - Editor</literal></para>

<para><literal remap="tt"><ulink url="mailto:epx@netville.com.br">Elvis Pfützenreuter</ulink> - Tradução para Português do Brasil</literal></para>
</sect1>
</chapter>
<![ %addindex; [ &docindex; ]]>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->