<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN">
<book lang="pt-BR">

<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>
</authorgroup>
<date>31/07/1997</date>
<releaseinfo>0.03.02</releaseinfo>
<abstract>
<para>Este manual descreve o KFind Versão 0.3.2</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>KFind</keyword>
<keyword>file search utility</keyword>
</keywordset>
</bookinfo>

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

<para>O <emphasis remap="bf">Kfind</emphasis> foi criado para ajudar a encontrar arquivos dentro de uma
hierarquia de diretórios. Ou seja, quando você sabe que um arquivo está 
'em algum lugar por ali' mas não <emphasis>exatamente</emphasis> onde, então o <emphasis remap="bf">kfind</emphasis> lhe será
de grande ajuda. Tendo encontrado o(s) arquivo(s), você pode salvar, apagar,
mudar as propriedades do arquivo, gravá-los em pacotes e/ou abrir o
diretório contendo o arquivo no gerenciador de arquivos (<emphasis remap="bf">KFM</emphasis>).</para>

<para>Espero que você ache esse programa útil; eu apreciaria receber sugestões
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="Instalao">
<title>Instalação</title>

<sect1 id="como-obter-o-kfind">
<title>Como obter o KFind</title>

<para>O KFind é uma aplicação-base do projeto KDE
<ulink url="http://www.kde.org">http://www.kde.org</ulink>. O KFind pode ser encontado em 
<ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, o site FTP primário do projeto KDE.</para>
</sect1>

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

<para><emphasis remap="sf">O <emphasis remap="bf">Kfind</emphasis> é parte integrante da distribuição do KDE e portanto será
automaticamente instalado junto com as outras aplicações no curso normal
da instalação do KDE. Portanto, dificilmente você precisará seguir os passos
abaixo.</emphasis></para>

<para>Para compilar o KFind, você precisa das versões mais recentes 
das bibliotecas <literal remap="tt">libkdecore</literal> e <literal remap="tt">libkfm</literal>. Todas as bibliotecas
requeridas bem 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="compilao-e-instalao">
<title>Compilação e Instalação</title>

<para>Para compilar e instalar o KFind em seu sistema, digite o seguinte no
diretório-base da distribuição do KFind:
<screen> 
% ./configure 
% make 
% make install 
</screen>
</para>

<para>Como o KFind usa o <literal remap="tt">autoconf</literal>, você não deve ter problemas para compilá-lo.
Se tiver percalços, dirija-se às listas de discussão do KDE.</para>
</sect1>

<sect1 id="configurao">
<title>Configuração</title>

<para>A configuração é feita normalmente via janela Preferências; veja a seção de
usuário deste manual para maiores informações. Uma descrição técnica da
configuração do <emphasis remap="bf">KFind</emphasis> segue, a quem interessar possa.</para>

<para>O <emphasis remap="bf">Kfind</emphasis> lê os parâmetros de configuração de um arquivo próprio,
(normalmente, <literal remap="tt">&tilde;/.kfindrc</literal>).</para>

<para>Esse arquivo contém informações sobre salvamento de resultados de buscas,
empacotadores disponíveis e outros parâmetros; esses parâmetros podem ser
editados na janela de <emphasis remap="bf">Preferências</emphasis> do <literal remap="tt">KFind</literal>.</para>

<para><emphasis remap="bf">Informações Gerais:</emphasis> o arquivo de recursos consiste de seções. Cada seção
é iniciada por um cabeçalho cercado por chaves, como em
<literal remap="tt">[Saving]</literal>.</para>

<para>As informações que seguem cada cabeçalho relacionam-se a aspectos específicos
da operação do <literal remap="tt">KFind</literal>.</para>

<para><emphasis remap="bf">Salvando a configuração:</emphasis> o arquivo de configuração mantém o nome de
arquivo e o formato a ser usado para salvar resultados de buscas. Este parâmetro
é armazenado no arquivo <emphasis remap="it">.kfindrc</emphasis> no item <literal remap="tt">[Saving]</literal> como segue:
<screen>[Saving]
Format=HTML
Filename=/root/result.html
</screen>

onde o item <literal remap="tt">Format</literal> pode ter os valores <literal remap="tt">HTML</literal> ou <literal remap="tt">Plain Text</literal>.</para>

<para><emphasis remap="bf">Configuração de Empacotadores:</emphasis> os empacotadores disponíveis ao
<literal remap="tt">kfind</literal> estão especificados no arquivo <emphasis remap="it">.kfindrc</emphasis>, item
<literal remap="tt">[Archiver Types]</literal>, como segue:
<screen>[Archiver Types]
Archivers=tar;zip;zoo;
</screen>
</para>

<para>E cada empacotador está detalhadamente descrito em sua própria linha:
<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 por ocasião da criação de
um novo pacote, e a segunda linha é usada para a atualização de pacotes
preexistentes. A terceira linha é a descrição do empacotador que aparecerá
na janela <emphasis remap="bf">Preferências</emphasis>. Variáveis podem ser usadas nestes comandos,
e são precedidas por um símbolo de porcentagem, como você pôde ver acima.</para>

<para>Segue uma lista de variáveis de linha de comando:</para>

<para><literal remap="tt">&percnt;a</literal> O nome completo do pacote</para>

<para><literal remap="tt">&percnt;f</literal> O nome normal do arquivo</para>

<para><literal remap="tt">&percnt;d</literal> O diretório-pai. Se o argumento é um arquivo, e não um diretório,
esta variável fornece o diretório em que está o arquivo.</para>

<para><literal remap="tt">&percnt;n</literal> O nome do arquivo. Se o argumento é um diretório, então esta
variável fornece o nome do diretório.</para>
</sect1>
</chapter>

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

<para>Nesta seção, a interface de usuário do KFind será descrita brevemente.</para>

<para>A janela do KFind é separada em quatro áreas: barra de ferramentas, 
abas de parâmetros de busca, área de visualização e barra de status.
A área de visualização e a barra de status ficam visíveis após a recepção
dos resultados da busca.</para>

<sect1 id="barra-de-ferramentas">
<title>Barra de ferramentas</title>

<para><variablelist>
<varlistentry>
<term>Iniciar Pesquisa</term>
<listitem>
<para>Inicia uma nova busca utilizando os parâmetros especificados nos respectivos
campos.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Nova Pesquisa</term>
<listitem>
<para>Limpa os resultados e esconde a área de visualização.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Parar Pesquisa</term>
<listitem>
<para>Pára o processo de busca.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Abrir</term>
<listitem>
<para>Pede ao <emphasis remap="bf">Kfm</emphasis> para abrir o arquivo da forma usual.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Adicionar ao arquivo</term>
<listitem>
<para>Adiciona o arquivo selecionado ao pacote.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Apagar</term>
<listitem>
<para>Apaga arquivo selecionados e requisita ao <emphasis remap="bf">KFM</emphasis> que releia o diretório.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Propriedades</term>
<listitem>
<para>Mostra as propriedades do arquivo selecionado.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Abrir pasta que contém</term>
<listitem>
<para>Pede ao <emphasis remap="bf">Kfm</emphasis> que abra o diretório que contém o arquivo selecionado.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Salvar Pesquisa</term>
<listitem>
<para>Salva os resultados no arquivo especificado na janela
<emphasis remap="bf">Opções -&gt; Preferências</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="abas-de-parametros-de-procura">
<title>Abas de parâmetros de procura</title>

<para>Parte principal do <literal remap="tt">KFind</literal>. São usadas para especificar os parâmetros
para o utilitário <literal remap="tt">find</literal>. Há três grupos de parâmetros de busca:</para>

<para><variablelist>
<varlistentry>
<term>Localização do nome</term>
<listitem>
<para>Esta aba é usada para especificar o nome de arquivo pelo qual você está
procurando. O nome é digitado numa caixa de combinação e pode conter os
seguintes 'coringas': 
<itemizedlist>
<listitem><para>? aceita qualquer caractere</para></listitem>
<listitem><para>* aceita qualquer seqüência de caracteres</para></listitem>
<listitem><para>&lsqb;&lsqb;]] aceita um conjunto definido de caracteres, por exemplo
&lsqb;a-zA-Z0-9\.] aceita letras ASCII maiúsculas e minúsculas, dígitos numéricos
e o ponto.</para></listitem>
</itemizedlist>

A caixa de combinação armazena a história dos nomes. A caixa de combinação
<emphasis remap="bf">Procurar em</emphasis> e o botão <emphasis remap="bf">Examinar</emphasis> são usados para especificar o diretório
onde a busca vai começar. Se o processo <literal remap="tt">find</literal> deve procurar em
subdiretórios, habilite a opção <emphasis remap="bf">Incluir subpastas</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Data da modificação</term>
<listitem>
<para>Esta aba permite procurar por arquivos criados num dado período de tempo.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Avançado</term>
<listitem>
<para>Esta aba permite a procura por tipos específicos de arquivos tais como
documentos Postscript, imagens JPEG e arquivos de som WAV. A busca também
pode ser restrita a arquivos acima ou abaixo de determinado tamanho.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="rea-de-visualizao">
<title>Área de visualização</title>

<para>Esta área contém os resultados do processo <literal remap="tt">find</literal>. Após clicar-se em
um item, as funções Abrir, Adicionar à Pacote, Apagar, Propriedades e
Abrir diretório do arquivo serão habilitadas. Clicar duas vezes executa o
arquivo binário ou abre o documento.</para>
</sect1>
</chapter>

<chapter id="Ositensdomenu">
<title>Os itens do menu</title>

<sect1 id="arquivo">
<title>Arquivo</title>

<para>As seguintes funções estão disponíveis no menu Arquivo:
<variablelist>
<varlistentry>
<term>Abrir</term>
<listitem>
<para>Esta opção chama o KFm para abrir o arquivo selecionado, utilizando a ligação
padrão; por exemplo, arquivos binários serão executados, arquivos-texto serão
abertos com o editor de texto etc. Esta ação também pode ser executada via
duplo clique sobre o arquivo na lista.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Adicionar ao arquivo</term>
<listitem>
<para>Adiciona o arquivo selecionado a um pacote</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Apagar</term>
<listitem>
<para>Apaga o arquivo selecionado</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Propriedades</term>
<listitem>
<para>Permite alterar as propriedades do arquivo selecionado</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Abrir pasta que contém</term>
<listitem>
<para>Abre o diretório que contenha o arquivo selecionado em uma janela KFM</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Salvar Pesquisa</term>
<listitem>
<para>Salva a lista de arquivos selecionados</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Sair</term>
<listitem>
<para>Sai do <literal remap="tt">Kfind</literal></para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="editar">
<title>Editar</title>

<para>Os itens deste menu estão desligados.</para>
</sect1>

<sect1 id="opes">
<title>Opções</title>

<para>Neste menu você pode iniciar a janela de Preferências. Esta janela permite
ao usuário determinar em que arquivo e formato o <literal remap="tt">KFind</literal> vai armazenar
os resultados das buscas. O Usuário também pode consultar os tipos de 
arquivo disponíveis e detalhes dos empacotadores.</para>

<para><variablelist>
<varlistentry>
<term>Salvando</term>
<listitem>
<para>Esta janela permite ao usuário especificar um arquivo para salvar os
resultados de uma busca. O botão <emphasis remap="bf">Formato de arquivo</emphasis> torna possível
dizer se os resultados serão salvos ndoem texto puro ou HTML. Os botões de
rádio <emphasis remap="bf">Salvar resultados no arquivo</emphasis> determinam se o resultado das
buscas serão salvos no arquivo padrão ou num arquivo especificado pelo
usuário. Pressionar o botão <emphasis remap="bf">Formato de arquivo</emphasis> lista os tipos de 
arquivo para onde o KFind pode gravar os resultados das buscas. Atualmente,
os formatos texto e HTML são suportados.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Tipos de arquivo</term>
<listitem>
<para>Esta janela permite visualizar (e talvez editar, um dia) a associação entre
os nomes de arquivos e seus tipos. A caixa de seleção da esquerda lista
todos os tipos de arquivos possíveis. Selecionar uma opção desta lista 
mostra os atributos do tipo de arquivo nas outras caixas.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Arquivadores</term>
<listitem>
<para>Esta janela permite visualizar (e talvez editar, no futuro) as definições
dos empacotadores usados pela função <emphasis remap="it">Adicionar a Pacote</emphasis>.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="ajuda">
<title>Ajuda</title>

<para>Deste menu de ajuda, você pode obter informações sobre o KFind e a sua
documentação.</para>
</sect1>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
