# Manual do KFind

Miroslav
Flídr

    flidr@kky.zcu.cz

Martin
Hartig

    hartig@mathematik.uni-kl.de

Mark
Roberts

    mar2@scigen.co.uk

31/07/1997
0.03.02

Este manual descreve o KFind Versão 0.3.2

KDE
KFind
file search utility

## Introdução

O Kfind 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 exatamente onde, então o kfind 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 (KFM).

Espero que você ache esse programa útil; eu apreciaria receber sugestões e comentários.

`Miroslav Flídr` flidr@kky.zcu.cz.

## Instalação

### Como obter o KFind

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

### Pré-requisitos

O Kfind é 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.

Para compilar o KFind, você precisa das versões mais recentes das bibliotecas `libkdecore` e `libkfm`. Todas as bibliotecas requeridas bem como o KFind em si podem ser encontrados em ftp://ftp.kde.org/pub/kde/.

### Compilação e Instalação

Para compilar e instalar o KFind em seu sistema, digite o seguinte no diretório-base da distribuição do KFind:

    % ./configure
    % make
    % make install

Como o KFind usa o `autoconf`, você não deve ter problemas para compilá-lo. Se tiver percalços, dirija-se às listas de discussão do KDE.

### Configuração

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 KFind segue, a quem interessar possa.

O Kfind lê os parâmetros de configuração de um arquivo próprio, (normalmente, `˜/.kfindrc`).

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 Preferências do `KFind`.

Informações Gerais: o arquivo de recursos consiste de seções. Cada seção é iniciada por um cabeçalho cercado por chaves, como em `[Saving]`.

As informações que seguem cada cabeçalho relacionam-se a aspectos específicos da operação do `KFind`.

Salvando a configuração: 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 .kfindrc no item `[Saving]` como segue:

    [Saving]
    Format=HTML
    Filename=/root/result.html

onde o item `Format` pode ter os valores `HTML` ou `Plain Text`.

Configuração de Empacotadores: os empacotadores disponíveis ao `kfind` estão especificados no arquivo .kfindrc, item `[Archiver Types]`, como segue:

    [Archiver Types]
    Archivers=tar;zip;zoo;

E cada empacotador está detalhadamente descrito em sua própria linha:

    [tar]
    ExecOnCreate=tar cf %a -C %d %n
    ExecOnUpdate=tar uf %a -C %d %n
    Comment=Tar

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 Preferências. Variáveis podem ser usadas nestes comandos, e são precedidas por um símbolo de porcentagem, como você pôde ver acima.

Segue uma lista de variáveis de linha de comando:

`&percnt;a` O nome completo do pacote

`&percnt;f` O nome normal do arquivo

`&percnt;d` 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.

`&percnt;n` O nome do arquivo. Se o argumento é um diretório, então esta variável fornece o nome do diretório.

## Fundamentos

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

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.

### Barra de ferramentas

Iniciar Pesquisa

  Inicia uma nova busca utilizando os parâmetros especificados nos respectivos campos.

Nova Pesquisa

  Limpa os resultados e esconde a área de visualização.

Parar Pesquisa

  Pára o processo de busca.

Abrir

  Pede ao Kfm para abrir o arquivo da forma usual.

Adicionar ao arquivo

  Adiciona o arquivo selecionado ao pacote.

Apagar

  Apaga arquivo selecionados e requisita ao KFM que releia o diretório.

Propriedades

  Mostra as propriedades do arquivo selecionado.

Abrir pasta que contém

  Pede ao Kfm que abra o diretório que contém o arquivo selecionado.

Salvar Pesquisa

  Salva os resultados no arquivo especificado na janela Opções -> Preferências.

Ajuda

  Mostra a documentação do KFind.

Sair

  Sai do KFind.

### Abas de parâmetros de procura

Parte principal do `KFind`. São usadas para especificar os parâmetros para o utilitário `find`. Há três grupos de parâmetros de busca:

Localização do nome

  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':

  - ? aceita qualquer caractere

  - * aceita qualquer seqüência de caracteres

  - &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.

  A caixa de combinação armazena a história dos nomes. A caixa de combinação Procurar em e o botão Examinar são usados para especificar o diretório onde a busca vai começar. Se o processo `find` deve procurar em subdiretórios, habilite a opção Incluir subpastas.
Data da modificação

  Esta aba permite procurar por arquivos criados num dado período de tempo.

Avançado

  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.

### Área de visualização

Esta área contém os resultados do processo `find`. 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.

## Os itens do menu

### Arquivo

As seguintes funções estão disponíveis no menu Arquivo:

Abrir

  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.

Adicionar ao arquivo

  Adiciona o arquivo selecionado a um pacote

Apagar

  Apaga o arquivo selecionado

Propriedades

  Permite alterar as propriedades do arquivo selecionado

Abrir pasta que contém

  Abre o diretório que contenha o arquivo selecionado em uma janela KFM

Salvar Pesquisa

  Salva a lista de arquivos selecionados

Sair

  Sai do `Kfind`

### Editar

Os itens deste menu estão desligados.

### Opções

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

Salvando

  Esta janela permite ao usuário especificar um arquivo para salvar os resultados de uma busca. O botão Formato de arquivo torna possível dizer se os resultados serão salvos ndoem texto puro ou HTML. Os botões de rádio Salvar resultados no arquivo determinam se o resultado das buscas serão salvos no arquivo padrão ou num arquivo especificado pelo usuário. Pressionar o botão Formato de arquivo lista os tipos de arquivo para onde o KFind pode gravar os resultados das buscas. Atualmente, os formatos texto e HTML são suportados.

Tipos de arquivo

  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.

Arquivadores

  Esta janela permite visualizar (e talvez editar, no futuro) as definições dos empacotadores usados pela função Adicionar a Pacote.

### Ajuda

Deste menu de ajuda, você pode obter informações sobre o KFind e a sua documentação.