<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN">
<book lang="pt">
<bookinfo>
<title>Manual do KFind</title>
<authorgroup>
<author>
<firstname>Miroslav</firstname>
<surname>Flídr</surname>
<affiliation><address><email>flidr@kky.zcu.cz</email></address></affiliation>
</author>
<author>
<firstname>Martin</firstname>
<surname>Hartig</surname>
<affiliation><address><email>hartig@mathematik.uni-kl.de</email></address></affiliation>
</author>
<author>
<firstname>Mark</firstname>
<surname>Roberts</surname>
<affiliation><address><email>mar2@scigen.co.uk</email></address></affiliation>
</author>
<othercredit role="translator">
<firstname>Sérgio</firstname>
<surname>Fernandes</surname>
<affiliation><address><email>sergio_fernandes@rocketmail.com</email></address></affiliation>
<contrib>Tradução da Documentação</contrib>
</othercredit>
</authorgroup>
<date>21/06/1998</date>
<releaseinfo>0.04.01</releaseinfo>
<keywordset>
<keyword>KDE</keyword>
<keyword>KFind</keyword>
<keyword>Procurar ficheiros</keyword>
</keywordset>
<abstract>
<para>Este Manual descreve a versão 0.4 do KFind</para>
</abstract>
</bookinfo>

<chapter id="introduction">
<title>Introdução</title>
<para>O <emphasis remap="bf">Kfind</emphasis> procura ficheiros que satisfazem determinado critério, dentro da
hierarquia de directorias.</para>
<para>Muitas vezes sabe que um ficheiro está 'algures po aí', mas não consegue lembrar-se onde está, mesmo com um bom
esforço. Então o <emphasis remap="bf">KFind</emphasis> é a ferramenta exacta para esse problema. Tendo encontrado o(s)
ficheiro(s) pretendido(s), pode:
<itemizedlist>
<listitem>
<para>guardá-los,</para>
</listitem>
<listitem>
<para>apagá-los,</para>
</listitem>
<listitem>
<para>mudar as propriedades do ficheiro,</para>
</listitem>
<listitem>
<para>armazená-los em arquivos e/ou</para>
</listitem>
<listitem>
<para>abrir a directoria que contém o(s) ficheiro(s) no gestor de ficheiros (<emphasis remap="bf">Kfm</emphasis>).</para>
</listitem>
</itemizedlist>
</para>
<para>Espero que ache este programa util e apreciarei qualquer sugestão e comentários.</para>
<para><literal remap="tt">Miroslav Flídr</literal>
<ulink url="mailto:flidr@kky.zcu.cz">flidr@kky.zcu.cz</ulink>.</para>
</chapter>
<chapter id="Installation">
<title>Instalação</title>
<sect1 id="how-to-obtain-kfind">
<title>Como Obter o KFind</title>
<para>O KFind é parte do projecto KDE <ulink url="http://www.kde.org">http://www.kde.org</ulink>. O KFind pode ser
encontrado em <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, o site de ftp principal do
projecto KDE. Também existem ligações para muitos espelhos FTP.</para>
</sect1>
<sect1 id="requirements">
<title>Requesitos</title>
<para>Para compilar com sucesso o KFind, necessita das últimas versões de <literal remap="tt">libkdecore</literal> e
<literal remap="tt">libkfm</literal>. Todas as librarias requeridas como o KFind em si podem ser encontrados em <ulink
url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>.</para> </sect1>
<sect1 id="compilation-and-installation">
<title>Compilação e Instalação</title>
<para>O <emphasis remap="bf">Kfind</emphasis> é normalmente uma parte integrante de um lançamento do KDE e por
conseguinte será instalado automáticamente com outras aplicações KDE durante o curso normal da instalação do KDE.</para>
<para>Se necessita compilar e instalar o KFind você mesmo no seu sistema, digite o seguinte na directoria base da
distribuição do KFind:
<screen> 
% ./configure 
% make 
% make install 
</screen>
</para>
<para>Como o KFind usa o <literal remap="tt">autoconf</literal>, não deve ter problemas para o compilar. Se tiver
problemas, por favor relate-as para as listas de mailing do <emphasis remap="bf">KDE</emphasis>.</para>
</sect1>
<sect1 id="configuration">
<title>Configuração</title>
<para>A configuração é normalmente realizada no diálogo das Preferências; veja a secção do utilizador deste manual para
mais detalhes. Uma descrição técnica da configuração do <emphasis remap="bf">kfind</emphasis> segue para as partes
interessadas:</para>
<para>O <emphasis remap="bf">Kfind</emphasis> lê os parametros de configuração a partir de um ficheiro de configuração
(normalmente <literal remap="tt">&tilde;/.kde/share/config/kfindrc</literal>).</para>
<para>Este ficheiro contém informação acerca da gravação dos resultados de pesquisas, arquivadores disponiveis e outros
parametros de configuração; estes parametros podem ser editados a partir do diálogo de <emphasis
remap="bf">Preferencias</emphasis> do <literal remap="tt">Kfind</literal>.</para>
<para><emphasis remap="bf">Informação Geral:</emphasis>o ficheiro de recursos é constituido por secções. Cada secção é
iniciada por um título de cabeçalho em paranteses rectos i.é:<literal remap="tt">[Gravando]</literal>.</para>
<para>A informação a seguir ao cabeçalho está relacionada com um aspecto específico da operação do <literal
remap="tt">Kfind</literal>.</para>
<para><emphasis remap="bf">Gravando Configuração:</emphasis>O ficheiro de configuração contém o nome e o formato do
ficheiro que irá ser usado para gravar os resultados da pesquisa. Estes parametros são armazenados da seguinte maneira:
<screen>
[Saving]
Format=HTML
Filename=/root/result.html
</screen>
Onde a entrada <literal remap="tt">Format</literal> pode ter valores <literal remap="tt">HTML </literal>ou <literal
remap="tt">Plain Text</literal>.</para>
<para><emphasis remap="bf">Configuração de Arquivadores:</emphasis> Os Arquivadores disponiveis para o <literal
remap="tt">kfind</literal> são especificados na entrada <emphasis remap="it">kfindrc</emphasis> <literal
remap="tt">[Archiver Types]</literal> da seguinte maneira:
<screen>
[Archiver Types]
Archivers=tar;zip;zoo;
</screen>
</para>
<para>E cada arquivador é descrito detalahdamente pela sua entrada:
<screen>
[tar]
ExecOnCreate=tar cf %a -C %d %n
ExecOnUpdate=tar uf %a -C %d %n
Comment=Tar
</screen>
</para>
<para>A primeira linha contém o comando a ser executado quando criar um novo ficheiro e a segunda é para actualizar
arquivos existentes. A terceira é o comentário usado para a descrição do arquivo no diálogo das <emphasis
remap="bf">Preferencias</emphasis>. Pode usar-se variáveis com estes comandos, que são denotados por um símbolo
de &percnt;.</para> <para>The following is a list of legal command line variables:</para>
<para><literal remap="tt">&percnt;a</literal> Nome completo do arquivo</para>
<para><literal remap="tt">&percnt;f</literal> O nome normal do ficheiro</para>
<para><literal remap="tt">&percnt;d</literal> A directoria anterior. Se o argumento passado é um ficheiro ( não uma
directoria ) então ser-lhe-á dada a directoria onde se encontra o ficheiro.</para>
<para><literal remap="tt">&percnt;n</literal> O nome do ficheiro. Se o argumento passado é uma directoria então isto é o
nome desta directoria.</para>
</sect1>
</chapter>
<chapter id="OnscreenFundamentals">
<title>Fundamentais do Ecrã</title>
<para>Nesta secção será descrita muito brevemente a interface do Kfind.</para>
<para>A janela do <emphasis remap="bf">Kfind</emphasis> está dividida em três áreas: barra de ferramentas, diálogo dos
parâmetros de pesquisa, e uma área de visualização. Esta área e a barra de estado ficam visiveis apenas depois de
receberem resultados da pesquisa.</para>
<sect1 id="toolbar">
<title>Barra de Ferramentas</title>
<para><variablelist>
<varlistentry>
<term>Iniciar Pesquisa</term>
<listitem>
<para>Inicia uma nova pesquisa usando os parâmetros especificados no diálogo de parâmetros.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Nova Pesquisa</term>
<listitem>
<para>Limpa os resultados e começa com novos parâmetros.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Parar Pesquisa</term>
<listitem>
<para>Termina o processo de pesquisa.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Abrir</term>
<listitem>
<para>Pergunta ao <emphasis remap="bf">Kfm</emphasis> para iniciar a ligação por defeito para o ficheiro seleccionando.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Adicionar ao arquivo</term>
<listitem>
<para>Adiciona o ficheiro seleccionado ao arquivo escolhido.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Apagar</term>
<listitem>
<para>apaga ficheiros seleccionados e diz ao <emphasis remap="bf">Kfm</emphasis> para refrescar a directoria.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Propriedades</term>
<listitem>
<para>Mostra as propriedades do ficheiro seleccionado.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Abrir a Pasta que Contém</term>
<listitem>
<para>Diz ao <emphasis remap="bf">Kfm</emphasis> para abrir a pasta que contém o ficheiro seleccionado.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Gravar Resultados da Pesquisa</term>
<listitem>
<para>Grava os resultados para o ficheiro especificado no diálogo em <emphasis
remap="bf">Opções-&gt;Preferencias</emphasis>.</para> </listitem>
</varlistentry>
<varlistentry>
<term>Ajuda</term>
<listitem>
<para>Mostra a documentação do <emphasis remap="bf">KFind</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Sair</term>
<listitem>
<para>Sai do KFind.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<sect1 id="search-parameters-dialog">
<title>Diálogo do Parâmetros de Pesquisa</title>
<para>Este diálogo é a parte principal do <literal remap="tt">KFind</literal>. É usada para especificar os parâmetros
para o utilitário de pesquisa. Existem três grupos de parâmetros de pesquisa:</para>
<para><variablelist>
<varlistentry>
<term>Nome e localização</term>
<listitem>
<para>Este diálogo é usado para especificar um nome de ficheiro a localizar. Este nome de ficheiro é introduzido na
caixa pendente e pode conter os seguintes caracteres especiais:
<itemizedlist>
<listitem><para> ? condiz com qualquer caracter</para></listitem>
<listitem><para> * condiz com qualquer sequência de caracteres</para></listitem>
<listitem><para>&lsqb; ] condiz com uma definição de um conjunto de caracteres, por ex.: &lsqb;a-zA-Z0-9] condiz com
letras maiúsculas e minúsculas e digitos.</para></listitem>
<listitem><para>\ símbolo é alfanúmerico ou um ponto</para></listitem>
</itemizedlist>
A caixa pendente armazena a história dos nomes. O botão <emphasis remap="bf">Examinar</emphasis> é usado para
especificar a directoria onde a pesquisa será efectuada. Se quer que a pesquisa entre nas subdirectorias, especifique-o
com o botão de activação <emphasis remap="bf">Incluir supastas</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Data de Modificação</term>
<listitem>
<para>Este diálogo permite pesquisar ficheiros criados ou modificados dentro de um período de tempo especifico.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Advançado</term>
<listitem>
<para>Este diálogo permite procurar por tipos especificos de ficheiros, por ex. documentos Postscript, imagens JPEG ou
ficheiros de som WAV.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<sect1 id="viewing-area">
<title>Área de Visualização</title>
<para>A área de visualização contém resultados od processo de pesquisa. Depois de um ficheiro ter sido seleccionado, as
funções abrir, adicionar ao arquivo, apagar, propriedades e abrir pasta que contém ficam activadas. O duplo clique causa
a execução.</para>
</sect1>
</chapter>
<chapter id="TheMenuEntries">
<title>As Opções do Menu</title>
<sect1 id="file">
<title>Ficheiro</title>
<para>As funções seguintes estão disponiveis a partir do menu ficheiro:
<variablelist>
<varlistentry>
<term>Abrir</term>
<listitem>
<para>Esta opção chama o <emphasis remap="bf">kfm</emphasis> para abrir o ficheiro seleccionado correntemente, usando a
ligação por defeito, i.é., ficheiros de programas serão executados, ficheiros de texto iniciarão o editor de textos,
etc. Esta acção também pode ser realizada através de um duplo clique no nome do ficheiro da lista.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
Adicionar ao arquivo</term>
<listitem>
<para>Adiciona o ficheiro seleccionado ao arquivo.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Apagar</term>
<listitem>
<para>Apaga o ficheiro seleccionado.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Propriedades</term>
<listitem>
<para>Permite que as propriedades do ficheiro seleccionado sejam alteradas.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Abrir a Pasta Que Contém</term>
<listitem>
<para>Abra a directoria contendo o ficheiro seleccionado numa janela do gestor de ficheiros (KFM)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Gravar Pesquisa</term>
<listitem>
<para>Grava a lista com os ficheiros seleccionados</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Sair</term>
<listitem>
<para>Sai do <literal remap="tt">Kfind</literal></para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<sect1 id="edit">
<title>Editar</title>
<para>As opções deste menu estão desactivadas.</para>
</sect1>
<sect1 id="options">
<title>Opções </title>
<para>A partir deste menu pode iniciar o diálogo das preferências. A primeira alça do diálogo das preferências
permite-lhe seleccionar o nome e o formato do ficheiro onde os resultados da pesquisa são armazenadas. A segunda alça
mostra os tipos de ficheiros disponiveis e os detalhes dos arquivadores.</para>
<para><variablelist>
<varlistentry>
<term>Gravar</term>
<listitem>
<para>Especifica o nome do ficheiro onde os resultados da pesquisa são armazenados. Por defeito é <literal
remap="tt">.kfind-results.html</literal> localizado na pasta pessoal do utilizador. Se for escolhido outro nome, pode-se
especificar o formato dos resultados armazenados. Os formatos suportados são o HTML e Texto (.txt). </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Arquivadores</term>
<listitem>
<para>Este diálogo permite visualizar (e no futuro, provávelmente editar) as definições do arquivo usadas pela função
<emphasis remap="it">Adicionar ao Arquivo</emphasis>.</para></listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<sect1 id="help">
<title>Ajuda</title>
<para>&gt;Mostra informação acerca do KFind e da documentação do KFind.</para>
</sect1>
</chapter>
<chapter id="Epilog">
<title>Epílogo</title>
<sect1 id="developers">
<title>Desenvolvedores</title>
<para><variablelist>
<varlistentry>
<term>Miroslav Fl&iacute;dr</term>
<listitem>
<para><ulink url="mailto:flidr@kky.zcu.cz">E-Mail: flidr@kky.zcu.cz</ulink></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Mario Weilguni;</term>
<listitem>
<para><ulink url="mailto:mweilguni@kde.org">E-Mail: mweilguni@kde.org</ulink></para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<sect1 id="authors">
<title>Autores</title>
<para><variablelist>
<varlistentry>
<term>Miroslav Fl&iacute;dr</term>
<listitem>
<para><ulink url="mailto:flidr@kky.zcu.cz">E-Mail: flidr@kky.zcu.cz</ulink></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Martin Hartig</term>
<listitem>
<para><ulink url="hartig@mathematik.uni-kl.de">E-Mail: hartig@mathematik.uni-kl.de</ulink></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Mark Roberts</term>
<listitem>
<para><ulink url="mailto:mar2@scigen.co.uk">E-Mail: mar2@scigen.co.uk</ulink></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Eric Bischoff</term>
<listitem>
<para>- Editor
<ulink url="mailto:ebisch@cybercable.tm.fr">E-mail: ebisch@cybercable.tm.fr</ulink></para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
