<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
<!ENTITY name "<application>herramienta de búsqueda de Gnome</application>">

]>

<article id="index" lang="es">


  <artheader> 
  <title>Herramienta de búsqueda de Gnome</title>
    <copyright>
      <year>2000</year>
      <holder>Alexander Kirillov</holder>
    </copyright>
    <copyright>
      <year>2001</year>
      <holder>Manuel de Vega Barreiro (traducción al Castellano)</holder>
    </copyright>
   <legalnotice>
           <para>
    Permission is granted to copy, distribute and/or modify this
    document under the terms of the <citetitle>GNU Free Documentation
    License</citetitle>, Version 1.1 or any later version published
    by the Free Software Foundation with no Invariant Sections, no
    Front-Cover Texts, and no Back-Cover Texts. You may obtain a copy
    of the <citetitle>GNU Free Documentation License</citetitle> from
    the Free Software Foundation by visiting <ulink type="http"
    url="http://www.fsf.org">their Web site</ulink> or by writing to:
    Free Software Foundation, Inc., 59 Temple Place - Suite 330,
    Boston, MA 02111-1307, USA.
   </para>
   <para>
    Many of the names used by companies to distinguish their products and
    services are claimed as trademarks. Where those names appear in any
    GNOME documentation, and those trademarks are made aware to the members
    of the GNOME Documentation Project, the names have been printed in caps
    or initial caps.
   </para>

           <para>
       Se permite la copia, distribución y/o modificación de este 
       documento bajo los términos de la <citetitle>licencia de documentación libre
       de GNU</citetitle>, versión 1.1 o cualquier versión posterior publicada por la
       fundación para el software libre; 
<!-- Dejo esta frase sin traducir por no la entiendo; o al menos lo
que creo entender iria en contra de la licencia Gnu -->
       sin secciones invariantes, sin portada, y sin contraportada. 
       Puede obtener una copia de la <citetitle>licencia de documentación libre
       de GNU</citetitle>  en la fundación para el
       software libre, visitando su <ulink type="http"
    url="http://www.fsf.org">pagina web</ulink> o escribiendo a:
    Free Software Foundation, Inc., 59 Temple Place - Suite 330,
    Boston, MA 02111-1307, USA.
       </para>
       <para>
Muchos de los nombres usados por compañías para distinguir sus productos y servicios
se declaran como marcas registradas. Cuando esos nombres aparezcan en cualquier documentación
Gnome, y esas marcas registradas sean conocidas por los miembros del proyecto de documentación
Gnome, lo nombres se imprimirían en mayúsculas o como nombres propios. 
</para>
    </legalnotice>
  </artheader>

  <sect1 id="intro">
    <title>Introducción</title> 

    <para>
       <application>La herramienta de búsqueda de Gnome</application>
es una utilidad para buscar ficheros en su sistema. Puede realizar muchos
tipos de búsqueda: por ficheros, por fecha de modificación, por el
contenido de los ficheros, etc. Esta incluida en el paquete
<filename>gnome-utils</filename>, que es parte del entorno de escritorio
Gnome. este documento describe la versión 1.2 de la 
<application>La herramienta de búsqueda de Gnome</application>.
    </para>

    <para>
La herramienta de búsqueda puede arrancarse seleccionando 
<guimenuitem>Herramienta de búsqueda Gnome</guimenuitem> en el submenú
<guimenu>Utilidades</guimenu> del
<guimenu>Menú principal</guimenu>, o ejecutando el comando
<command>gsearchtool</command> en la linea de ordenes.
    </para> 



    <para>
Observe que la <application>herramienta de búsqueda de Gnome</application>
es solo una interfaz de los comandos <command>find</command>,
<command>grep</command>, y <command>locate</command>.
Estos comandos son extremadamente potentes, pero no muy fáciles de usar
para los usuarios noveles. La 
<application>herramienta de búsqueda de Gnome</application> 
proporciona una interfaz fácil de usar para los usos mas habituales 
de estos comandos. Si necesita realizar algún tipo de búsqueda no 
previsto por la <application>herramienta de búsqueda de Gnome</application>
, posiblemente pueda conseguirlo desde la linea de ordenes, usando 
las opciones apropiadas de <command>find</command> y <command>grep</command>.
En estos casos, debería leer las paginas de información de estos comandos,
lo que podrá hacer usando el 
<application>visualizador de ayudas de Gnome</application>.
    </para>
    </sect1>



  <sect1 id="usage"> 
    <title>Uso</title>
    <para>
La <application>herramienta de búsqueda de Gnome</application> proporciona
dos tipos de búsquedas:
<emphasis>búsqueda completa</emphasis> y <emphasis>búsqueda rápida</emphasis>.
La búsqueda completa es fiable y tiene muchas opciones pero puede
resultar lenta. La búsqueda rápida usa técnicas especiales para acelerar la
búsqueda; es mucho mas rápida, pero solo puede buscar por nombre de fichero,
y nos es adecuada para una búsqueda completa. Esta sección describe el modo
de búsqueda completa; la búsqueda rápida se describe en 
<xref linkend="locate">.  
    </para>      
<figure id="mainwin">
 <title>Ventana principal de búsqueda</title>
 <screenshot>
  <screeninfo>Ventana principal de búsqueda</screeninfo>
  <graphic format="png"  fileref="figures/mainwin" srccredit="sasha">
  </graphic>
 </screenshot>
</figure>

    <para> 
Para iniciar una búsqueda, debe indicar al la herramienta de búsqueda de
Gnome los criterios de búsqueda y el directorio donde iniciarla.
    </para> 

   <para>
Por defecto, la búsqueda se inicie en el directorio de trabajo actual;
si la &name; se inicia desde el menú, entonces el directorio de trabajo actual
es su directorio hogar. Puede cambiar el directorio de inicio tecleando
cualquier ruta valida en el campo <guilabel>Inicio en el directorio</guilabel>,
o seleccionando el directorio usando el botón <guibutton>Buscar...</guibutton>.
Por ejemplo, para buscar en todos los ficheros de su sistema, teclee 
<filename>/</filename> en este campo (aviso: podría tardar <emphasis>muchísimo</emphasis> tiempo).
</para> 


   <para>
Por omisión $name; busca también en los subdirectorios del directorio indicado;
Puede inhibir esta funcionalidad, habilitado la opción
<guilabel>No buscar en los subdirectorios</guilabel>.
Para un control mas preciso, puede habilitar la opción 
<guilabel>No buscar en sistemas de ficheros montados</guilabel>, que excluirá 
de la búsqueda los subdirectorios que estén físicamente localizados (montados)
en dispositivos o particiones distintas de la del directorio inicial &mdash;
para mas detalles véase <xref linkend="criteria">.
    </para>

   <para> 
El único criterio de búsqueda presentado por defecto es el 
<guilabel>nombre de fichero</guilabel>. Puede usar los comodines
<keysym>*</keysym> (vale por cualquier secuencia de símbolos, incluida
la secuencia nula) y <keysym>?</keysym> (vale por cualquier símbolo unitario)
en este campo; para encontrar todos los ficheros que empiecen por la letra D, teclee
<filename>D*</filename> (aviso: ¡los nombres de ficheros dependen de las mayúsculas
y minúsculas!). Puede especificar criterios de búsqueda mucho mas complicados
&mdash; véase <xref linkend="criteria">.
   </para>
   
   <para>
Una vez especificados los criterios de búsqueda y el directorio de inicio, pulse
<guibutton>Iniciar</guibutton>. Esta operación tardará cierto tiempo (dependiendo
del tamaño del directorio y la velocidad del sistema), y una vez transcurrido
se presentará una ventana con una lista de todos los ficheros que cumplan el criterio
(puede estar vacía), como la mostrada en <xref linkend="results">. Si la búsqueda tarda
demasiado, puede abortarla pulsando el botón <guibutton>Detener</guibutton>.
   </para>

<figure id="results">
 <title>Ventana de resultado de la búsqueda</title>
 <screenshot>
  <screeninfo>Ventana de resultado de la búsqueda</screeninfo>
  <graphic format="png"  fileref="figures/results" srccredit="sasha">
  </graphic>
 </screenshot>
</figure>


   <para>
En la ventana de resultado de la búsqueda, puede realizar un doble clic sobre
cualquier fichero para abrirlo. Tendrá el mismo efecto que hacer doble clic en ese
fichero en un ventana del gestor de ficheros &mdash; esto es, el fichero se 
abrirá usando la ccion por omisión para ese tipo de fichero. Puede también salvar
la lista de ficheros encontrados pulsando el botón <guibutton>Salvar</guibutton>.
Se le preguntara el nombre del fichero en el que salvar la lista; la lista se salvara
en un fichero de texto plano.
    </para> 
    </sect1>

  <sect1 id="criteria">
    <title>Criterios de búsqueda</title> 

    <para>
Además de las búsquedas simples de búsqueda descritas anteriormente, la &name;
permite especificar otros criterios. Para hacerlo, deberá seleccionar el tipo de criterio
apropiado de la lista desplegable (situada a la izquierda del botón <guibutton>Añadir</guibutton>),
y pulsar <guibutton>Añadir</guibutton>. Esto añadirá este criterio a los ya existentes.
&name; buscara los ficheros que cumplan <emphasis>todos</emphasis> los criterios especificados.
Por ejemplo, <xref linkend="sample">  muestra una búsqueda de todos los ficheros con extensión
<filename>txt</filename> que fueron modificados durante los últimos 7 días y que
contengan la palabra GNOME.
    </para>
 
    <figure id="sample">
     <title>Sección simple de búsqueda Gnome</title>
     <screenshot>
      <screeninfo>Sección simple de búsqueda Gnome</screeninfo>
      <graphic format="png" fileref="figures/gsearch" srccredit="sasha">
      </graphic>
    </screenshot>
   </figure>

    <para>
Puede eliminar cualquier criterio de búsqueda previamente añadido pulsando
el botón <guibutton>Quitar</guibutton> situado a su lado. Puede también
deshabilitar temporalmente un criterio desactivando la casilla 
<guibutton>Activar</guibutton> situada a su lado.
    </para>


    <para> 
A continuación se muestra una lista de todos los posibles criterios:
      <itemizedlist>
	<listitem><para> 
	    <emphasis>Nombre de fichero</emphasis>  &mdash; 
Búsqueda por nombre de fichero. Como de costumbre, puede usar los comodines * y ? en la búsqueda.
Recuerde también que los nombres en Unix dependen de las mayúsculas y minúsculas. 
	</para></listitem>

	<listitem>
          <para> <emphasis>No buscar en los subdirectorios</emphasis> &mdash; 
si esta opción esta activada, &name; no buscara ficheros en los subdirectorios del directorio de inicio.
           </para></listitem>

	<listitem><para> 
	    <emphasis>Propietario del fichero</emphasis>  &mdash; 
busca usando el nombre del usuario al que pertenecen los ficheros.
	</para></listitem>

	<listitem><para> 
	    <emphasis>Grupo propietario del fichero</emphasis>  &mdash; 
busca usando el grupo al que pertenece el fichero.
	</para></listitem>

	<listitem><para> 
	    <emphasis>Tiempo de la ultima modificación</emphasis>  &mdash; 
busca fichero modificados en los últimos N días (para se mas precisos, durante las
N*24 horas).
	</para></listitem>

	<listitem><para> <emphasis>No buscar en sistemas de ficheros montados</emphasis> &mdash; 
si esta opción esta activada, &name; buscara solamente en los subdirectorios que estén montados en
el mismo dispositivo (disco) que el directorio de inicio. Por ejemplo, si el directorio de inicio es
<filename>/</filename> y esta montado en <filename>/dev/hda</filename> (primer disco duro), y 
tiene un subdirectorio <filename>/home</filename> montado en <filename>/dev/hdb</filename> (segundo
disco duro), entonces no se buscara en <filename>/home</filename>. Esta opción puede se útil
para excluir ficheros en disco removibles (Cd-Rom, disquetes) de la búsqueda.
	  </para></listitem>

	<listitem>
	  <para> <emphasis>Ficheros vacíos</emphasis> &mdash; 
Este criterio lo cumplen los ficheros vacíos. Usados a menudo por los administradores
de sistemas para el mantenimiento del sistema.
	  </para></listitem>

	<listitem><para> 
	  <emphasis>Dueños o grupos no validos</emphasis> &mdash; 
lo cumplen ficheros que pertenecen a usuarios o grupos desconocidos para el sistema. Esta opción es
útil para buscar ficheros pertenecientes a usurarios eliminados del sistema. Usado a menudo por
los administradores de sistemas para el mantenimiento del sistema.
	</para></listitem>

	<listitem>
	  <para> 
	    <emphasis>Excepciones en el nombre de los ficheros</emphasis> &mdash;
lo cumplen todos los ficheros a excepción de los indicados. Como anteriormente, puede
usar comodines. Por ejemplo, si especifica en el campo <filename>*~</filename>, &name;
excluirá de la búsqueda todos los ficheros que terminen con una tilde (~). 
	  </para>
	</listitem>

	<listitem><para> 
            <emphasis>Correspondencia de texto simple</emphasis>
	    &mdash; 
lo cumplen todos los ficheros que <emphasis>contienen</emphasis> en texto dado.
Dado que esta opción requiere la lectura del contenido de cada fichero, puede 
ralentizar significativamente la búsqueda. Nota: no puede usar comodines en esta
opción.
	  </para></listitem>

	<listitem><para> <emphasis>Búsqueda por expresiones regulares</emphasis> &mdash; 
lo cumplen todos los ficheros que <emphasis>contienen</emphasis> la expresión regular dada.
dado que esta opción requiere la lectura del contenido de cada fichero, 
puede 
ralentizar significativamente la búsqueda.
	  </para></listitem>

	<listitem>
	  <para> 
	    <emphasis>Búsqueda por expresiones regulares extendidas</emphasis> &mdash; 
lo cumplen todos los ficheros que <emphasis>contienen</emphasis> la expresión regular extendida dada.
dado que esta opción requiere la lectura del contenido de cada fichero, 
puede 
ralentizar significativamente la búsqueda.
          </para>
	</listitem>

      </itemizedlist>


Para los que no estén familiarizados con el termino expresiones regulares,
digamos simplemente que es una sintaxis extremadamente potente y flexible
para patrones de comprobación de igualdad. A diferencia de las comprobaciones
con simples comodines, permite realizar operaciones lógicas (y, o, no), indicar
listas de símbolos a comprobar, chequeos de cadenas al principio de las lineas,
y mucho mas. Puede encontrar una descripción detallada de las expresiones
regulares y sus extensiones en la pagina de manual de <application>grep</application>.
Los usuarios noveles encontraran probablemente muy complicado su uso, pero para los
mas experimentados, las expresiones regulares resultan muy útiles.   
    </para>
  </sect1>


  <sect1 id="locate">
    <title>Modo de búsqueda rápido</title>
    <para> 
Esta sección describe el modo de búsqueda rápido de &name;. Para usar este modo,
cambie a la ventana <guilabel>Búsqueda rápida (locate)</guilabel>, mostrada en
<xref linkend="locatewin">.
      </para>

    <figure id="locatewin">
     <title>Ventana de búsqueda rápida</title>
     <screenshot>
      <screeninfo>Ventana de búsqueda rápida</screeninfo>
      <graphic format="png" fileref="figures/locate" srccredit="sasha">
      </graphic>
    </screenshot>
   </figure>

    <para>
En el modo de búsqueda rápida, &name; no busca en ese momento un fichero en el disco
&mdash;, si no que usa una base de datos especial que contiene los nombres de todos los
ficheros del sistema. Esto hace la búsqueda mucho mas rápida. Sin embargo, esto 
significa también que la única búsqueda que se puede hacer es la de nombres de ficheros.
Mas importante aun, esta búsqueda no encontrara ficheros que hayan sido añadidos después
de la ultima actualización de la base de datos (en muchos sistemas, se actualiza diariamente,
normalmente por la noche &mdash; , para mas información léase mas abajo).
    </para>
    <para>
Para localizar un fichero usando el modo de búsqueda rápido, simplemente teclee
una parte del nombre del fichero en el campo <guilabel>Buscar fichero</guilabel>.
Por ejemplo, para encontrar todos los ficheros cuyo nombre contenga la cadena
"searchtool", teclee <userinput>searchtool</userinput> en ese campo.
Esto mostrara también todos aquellos ficheros que contengan la cadena "searchtool"
en su ruta completa &mdash; en particular, todos los ficheros localizados en el directorio
<filename
      class="directory">/usr/share/help/gsearchtool</filename>.
    </para>
    <para>
Para restringir la búsqueda a un subdirectorio, puede usar el nombre del directorio
en combinación con comodines. Por ejemplo, para hacer una búsqueda rápida de todos los ficheros
con extensión <filename>txt</filename> en el directorio <filename
      class="directory">/home/user</filename>, teclee <userinput>
      /home/user/*.txt</userinput> en el campo <guilabel>Buscar fichero</guilabel>.
    </para>

    <para>
El modo de búsqueda rápido es actualmente una interfaz para el comando 
<command>locate</command>, así que si necesita una información mas detallada, 
puede leer la pagina de manual apropiada.
    </para>
    <sect2 id="locatedb">
      <title>La base de datos de locate</title>
      <para>
Esta sección discute la actualización de la base de datos usado para las búsquedas
rápidas. A no ser que sea administrador de sistemas o sienta curiosidad,
no necesita leerla.
      </para>
      <para>
En la mayoría de los sistemas, la base de datos usada por el comando
<command>locate</command> (y por tanto, por el modo de búsqueda rápido de
 &name;), se actualiza de forma diaria, normalmente por las noches. Esta 
operación se realiza como una tarea <command>cron</command> &mdash; lea la
pagina de manual de <command>cron</command> si no esta familiarizado con esta
utilidad. Observe que si habitualmente apaga su ordenador por las noches, la
base de datos no se actualizara. En ese caso, debería cambiar el momento 
de actualización por omisión, bien editando manualmente <filename>/etc/crontab</filename>,
o bien usando una herramienta gráfica como <application>cromagnon</application>. Eso
requiere privilegios de adminsitración de sistema (root).   
      </para>

      <para>
Puede también provocar la actualización de la base de datos de forma inmediata ejecutando
el comando <command>updatedb</command>. De nuevo, esto requiere privilegios de administrador
de sistema (root). Sin ninguna opción, reconstruye la base de datos completa, para todos
los ficheros del sistema. Dispone también de muchas opciones para la linea de ordenes 
que permiten un ajuste fino (por ejemplo, indicándole que se salte ciertos directorios).
Si necesita mas información, lea la pagina de manual de   
      <command>updatedb</command>.
      </para>
    </sect2>


    </sect1>



  <sect1 id="authors">
    <title>Autores</title>
     <para>
George Lebl (<email>jirka@5z.com</email>) escribió &name;. 
Por favor env&iacute;e todos los comentarios, sugerencias, e informes de errores a la 
<ulink url="http://bugs.gnome.org" type="http">
base de datos de seguimiento de errores de Gnome
</ulink>. Encontrara informaci&oacute;n sobre la forma de enviar informes de errores en linea en
<ulink      url="http://bugs.gnome.org/Reporting.html" type="http">
http://bugs.gnome.org/Reporting.html
</ulink>. Si esta usando Gnome 1.1 o posterior, puede usar tambi&eacute;n el comando
<command>
bug-buddy
</command>
para enviar informes de errores.
    </para>
    <para>
Alexander Kirillov (<email>kirillov@math.sunysb.edu</email>) escribió este manual.
Por favor env&iacute;e todos los comentarios y sugerencias acerca de este manual al
proyecto de documentaci&oacute;n de Gnome en <email>docs@gnome.org</email>
o añada sus comentarios en 
<ulink type="http" url="http://www.gnome.org/gdp/doctable/">la tabla de seguimiento de la documentación Gnome</ulink>.
      </para>
    </sect1>


 <!-- ============= Application License ============================= -->

 <sect1 id="license">
  <title>Licencia</title>
  <para>
   Este programa es de libre distribución; puede redistribuirlo y/o modificarlo
bajo los términos de la <citetitle>licencia de documentación libre de GNU</citetitle>
publicada por la fundación para el software libre; ya sea la versión 2 de la licencia, 
o (si lo desea) cualquier versión posterior. 
  </para>
  <para>
Este programa se distribuye con la esperanza de que sea útil, pero sin garantía
alguna; incluso sin las garantías implícitas asociadas a platicas comerciales o
acuerdos de cualquier tipo. Véase la <citetitle>licencia de documentación libre de GNU</citetitle>
para mas detalles.
  </para>
  <para>
       Se incluye una copia de la <citetitle>licencia de documentación libre
       de GNU</citetitle>  en un apéndice de la <citetitle>Guía de usuario Gnome</citetitle>.

       Puede también obtener una copia de la <citetitle>licencia de documentación libre
       de GNU</citetitle>  en la fundación para el
       software libre, visitando su <ulink type="http"
    url="http://www.fsf.org">pagina web</ulink> o escribiendo a:
   <address>
    Free Software Foundation, Inc.
    <street>59 Temple Place</street> - Suite 330
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
    <country>USA</country>
   </address>
  </para>

  <para>
   This program is free software; you can redistribute it and/or
   modify it under the terms of the <citetitle>GNU General Public
   License</citetitle> as published by the Free Software Foundation;
   either version 2 of the License, or (at your option) any later
   version.
  </para>
  <para>
   This program is distributed in the hope that it will be useful, but
   WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   <citetitle>GNU General Public License</citetitle> for more details.
  </para>
  <para>
   A copy of the <citetitle>GNU General Public License</citetitle> is
   included as an appendix to the <citetitle>GNOME Users
   Guide</citetitle>.  You may also obtain a copy of the
   <citetitle>GNU General Public License</citetitle> from the Free
   Software Foundation by visiting <ulink type="http"
   url="http://www.fsf.org">their Web site</ulink> or by writing to
   <address>
    Free Software Foundation, Inc.
    <street>59 Temple Place</street> - Suite 330
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
    <country>USA</country>
   </address>
  </para>
 </sect1>



</article>


