Go Back to o3find main page

*** o3find - Version 0.8.2

Ricerca di testo per StarOffice e OpenOffice.org

Con o3find e' possibile cercare una parola o una frase in molti 
documenti StarOffice / OpenOffice.org (SO/OOo).
E' anche possibile cercare testo in altri tipi di documenti 
(ad es. testo templice, Microsoft Office, etc.)



*** Novita'


Nella 0.8.2
* Cambiamenti solo nell'edizione a finestra

Nella 0.8.1
* Nuova opzione "-nostyle" per ignorare stili e paragrafi

Nella 0.8
* Possibilita' di cercare in tutti i tipi di file, non solo SO/OOo
(vedi opzione "-f")
* Nuova optione "-ao" per cercare nei file aperti al momento

Nella 0.72
* Nuova opzione: -exec
* Supporto per caratteri speciali, come le lettere accentate (escluso Windows 95)

Nella 0.70
* -d puo' specificare piu' di una directory
* Correzione di bug
* Supporto dei seguenti caratteri speciali: < > & ' "

Nella 0.62
* Nuove opzioni: -meta, -metaonly

Nella 0.60
* Nuove opzioni: -f, -e, -b, -nf
* Opzione -files:stdin rinominata in -input



*** Requisiti di sistema


- PC (386 o compatibile) con Microsoft Windows (95/98/ME/NT4/2000/XP)

NON e' necessario avere installato StarOffice o OpenOffice.org.



*** Installazione


Decomprimere l'archivio ZIP in una directory a scelta: il programma e'
piu' comodo da usare se si mette il file o3find.exe in una directory
contenuta nella variabile d'ambiente PATH (per ulteriori informazioni
su PATH consultare la documentazione di Windows).

Per disinstallare il programma, e' sufficiente rimuovere il file o3find.exe .



*** Istruzioni


Questo e' un semplice programma a riga di comando: 
eseguire o3find dal prompt dei comandi tipo DOS.

NOTA: o3find non funziona se si riavvia Windows 9x/ME in modalita' MS-DOS.


Utilizzo: 
	 o3find [opzioni] -s <stringaricerca> 

 <stringaricerca> Il testo da cercare

  Per trovare una parola (o parte di una parola), basta digitarla: ad es.:
	o3find -s ciao

  Per trovare una frase con spazi (o caratteri speciali quali < oppure > ), 
  racchiuderla tra doppi apici.
	o3find -s "ciao a tutti"

NOTA PER UTENTI WINDOWS 95: sotto Windows 95, 
il programma non e' in grado di trovare caratteri speciali 
come le lettere accentate.
Ad es. per cercare "perchè" sotto Windows 95, digitare solo "perch"
Per default il programma cerca solo nei file che hanno l' estensione ".sx?"
tipica dei documenti StarOffice / OpenOffice.org .
sxw = Documento di testo (Writer)
sxc = Foglio di calcolo (Calc)
sxd = Disegno (Draw)
sxi = Presentazione (Impress)
sxm = Formula (Math)
sxg = Documento master (global document)
Per cercare anche in altri tipi di file vedi l'opzione "-f"


Opzioni (l'ordine non e' importante)
Attenzione: tutte le opzioni devono essere scritte in minuscolo.


  -d <directory> 	Directory di ricerca (con o senza la barra finale)
	Se si omette <directory>, il programma cerca nella directory attuale
Se il percorso contiene spazi, racchiuderlo tra doppi apici.
Esempi:
	 o3find -d d:\mieidoc -s cane
	 o3find -d d:\mieidoc\ -s "cani e gatti" 
	 o3find "c:/documents and settings/jack/" -s cane

E' possibile specificare piu' di una directory:
	 o3find -d d:\mydocs c:\otherdocs -s cane


  -i  	Ignora maiuscole/minuscole
Per default, il programma fa differenza tra maiuscole e minuscole. 
Ad es. il comando seguente trova documenti contenenti esattamente 
la parola "laura" in minuscolo:

	o3find -s laura

Mentre il seguente trova "laura", "Laura", "LAURA", etc.:

	o3find -i -s laura

Notare che una ricerca con l'opzione -i e' solitamente piu' lenta del normale.


  -r  	Ricerca nelle sotto-directory

Per default, il programma cerca solo in una directory (quella attuale 
o quella specificata con l'opzione -d)
Con -r il programma cerca in tutte le sotto-directory della directory di ricerca.


 -f <pattern> [<pattern>...] Trova i nomi di file (o pattern) specificati

Con questa opzione il programma cerca i nomi di file o i pattern (con caratteri jolly)
elencati dopo -f (separati da spazi).

Es. questo comando cerca la parola "Hamlet" nel file "denmark.sxw"

	o3find -f denmark.sxw -s Hamlet

Es. questo comando cerca la parola "Hamlet" nei documenti Calc ed Impress

	o3find -f *.sxc *.sxi -s Hamlet

Es. questo comando cerca la parola "Hamlet" in tutti i file, compresi ad esempio file
di testo o Microsoft Office. 
ATTENZIONE: questo puo' rallentare notevolmente la ricerca. 

	o3find -f *.* -s Hamlet

NOTA: se si usa l'opzione -f per cercare in file diversi dal formato SO/OOo,
le righe contenenti il testo da cercare non sono MAI mostrate.


  -e  	Non mostrare errori e avvertimenti

Usare questa opzione per nascondere errori e avvertimenti 
(ad es. opzioni in conflitto). 


 -b       Modalita' breve (non mostrare le righe contenenti il testo da cercare)

Mostra solo i nomi dei file (per una ricerca piu' rapida).
NOTA: se si usa l'opzione -f per cercare in file diversi dal formato SO/OOo,
le righe contenenti il testo da cercare non sono MAI mostrate, indipendentemente
dal fatto che l'opzione -b sia specificata oppure no.


 -ao       Modalita' Already Open (=gia' aperti) 


Questa opzione permette di cercare anche nei file che sono gia' aperti da 
SO/OOo o da altri programmi (evitando dunque il messaggio 
d'errore "Permission denied").
 In questo caso o3find legge il documento
com'era prima dell'apertura o all'ultimo salvataggio (non e' in grado
di rilevare modifiche non salvate)



Usare questa opzione con cautela: se un documento viene modificato
 mentre 
o3find lo sta leggendo possono verificarsi errori.


 -nostyle       Ignora formati, stili e paragrafi

Cerca il testo "scavalcando" diversi formati, tipi di carattere, stili 
e paragrafi (SOLO per documenti SO/OOo)
Ad es. supponi di voler cercare il testo "in mezzo alla riga" ma la 
parola "mezzo" sia grassetto o corsivo.
Non la troverai... a meno che non usi l'opzione "-nostyle".

NOTA 1: l'opzione "-nostyle" attiva in automatico la modalita' breve (-b)
NOTA 2: l'opzione "-nostyle" rallenta la ricerca



  -nf  	Mostra anche i file che non contengono il testo da cercare

Per default, il programma mostra solo i file nei quali il testo e' stato
trovato. Usare -nf per mostrare ANCHE quelli dove NON e' stata trovato.
Ad es.:

	o3find -s Bjarne -nf

Esempio: questo comando mostra SOLO i file che NON contengono 
la parola "Bjarne":

	o3find -s Bjarne -nf -b | find "not found"


  -meta     Ricerca nei metadati.

Cerca il testo sia nel contenuto dei documenti che nei metadati.
Ad. es. trova tutti i documenti modificati da Smith, o che contengono la parola 'Smith'.

	o3find -r -meta -s Smith 

NOTA: Questa opzione ha effetto solo sui documenti in formato SO/OOo.
Se si usa l'opzione -f per cercare in file diversi dal formato SO/OOo,
l'opzione e' ignorata per tali file.


  -metaonly     Ricerca solo nei metadati (ignora il contento dei documenti).

Simile a -meta, ma non cerca nel contenuto. Questo consente una ricerca piu'
rapida se si e' interessati solo ai metadati. 

-meta e -metaonly non possono essere usate contemporaneamente

NOTA: Questa opzione ha effetto solo sui documenti in formato SO/OOo.
Se si usa l'opzione -f per cercare in file diversi dal formato SO/OOo,
l'opzione e' ignorata per tali file.


 -exec <command> Esegue il comando per tutti i file trovati

Il comando specificato viene eseguito SOLO sui file che contengono il testo da cercare.
Il comando deve essere racchiuso tra doppi apici.
Utilizzare il simbolo {} dove dovrebbe stare il nome del file: 
il simbolo {} in <command> verra' sostituito dal nome del file trovato, 
automaticamente racchiuso tra doppi apici 
(quindi, NON racchiudere {} tra doppi apici).

Esempi: elimina i documenti trovati (ATTENZIONE: i file sono eliminati fisicamente, NON 
vengono spostati nel Cestino e NON E' POSSIBILE recuperarli!)

	o3find -s "carta straccia" -exec "DEL {}"

Rinomina i file trovati:

	o3find -s Obsoleto -exec "COPY {} {}.vecchio"

Apre i file trovati (RICHIEDE STAROFFICE O OPENOFFICE INSTALLATO !)
Notare che il simbolo {} e' ripetuto due volte (vedi la documentazione del comando START)

	o3find -s Interessante -exec "START {} {}"


  -input 	Legge i file da cercare dallo standard input
  	 Se si usa questa opzione, -d and -r vengono ignorati

Se si specifica -input, il programma legge i nomi dei file da cercare dallo 
standard input (digitati alla tastiera, letti da un file di testo o accodati con un pipe
da un altro comando). I nomi dei file devono essere separati da "a capo" e non devono
contenere caratteri jolly. 

Ad es: digitare:
	o3find -input -s "cani e gatti"
e premere INVIO. Quindi digitare alcuni nomi di file, premendo sempre INVIO dopo ciascuno.
Al termine, premere CTRL+Z.

Ad es: il comando seguente cerca la frase "cani e gatti" in TUTTI 
i file della directory attuale e in tutte le sue sotto-directory, ordinando i 
file in base alla data (mostra prima i piu' vecchi)

	dir *.* /s /b /OD | o3find -s "cani e gatti" -input

-input e -f non possono essere usati contemporaneamente



*** Codice sorgente


Il codice sorgente e' stato compilato sotto Windows Windows (98 e XP Pro) 
con Microsoft Visual C++ 6.0 (SP5).

Al momento il programma e' disponibile solo per Windows, ma credo
che possa essere trasportato facilmente su altri sistemi (in particolare Linux).

Il pacchetto comprende i sorgenti della libreria ZipArchive, 
ma senza la documentazione (per risparmiare spazio).

IMPORTANTE: i sorgenti di ZipArchive sono stati modificati
per implementare alcune caratteristiche di o3find.



*** Limitazioni


Questo programma non puo' leggere file cifrati.
Questo programma non puo' leggere file compressi, tranne, ovviamente
i documenti SO/OOo.

I file non-OOo sono trattati come file binari: si presenta cosi' il problema
dei "falsi positivi", tipico di molti programmi di ricerca.
Se ad esempio cerchiamo
la parola "Roma", o3find elenchera' tutti i file di Microsoft Office che usano
il carattere "Times New Roman", anche se poi la parola "Roma" non
appare affatto nel "vero" documento. Analogamente, o3find trovera' termini
quali "Baseline" nei documenti PDF perche' sono parole-chiave PDF.

Questo programma non supporta i caratteri UNICODE, ma puo' cercare i 
normali caratteri ANSI sia in file ANSI che in file UNICODE.



*** Informazioni sulla licenza


o3find - Copyright (C) 2003-2005 Paolo Copello
Ridistribuibile alle condizioni della GNU GPL.
http://web.tiscali.it/fanelia

    Questo  programma è  software  libero; è  lecito redistribuirlo  o
    modificarlo secondo i termini  della Licenza Pubblica Generica GNU
    come è pubblicata dalla Free  Software Foundation; o la versione 2
    della licenza o (a propria scelta) una versione successiva.

    Questo programma  è distribuito nella  speranza che sia  utile, ma
    SENZA  ALCUNA GARANZIA;  senza  neppure la  garanzia implicita  di
    NEGOZIABILITÀ  o di  APPLICABILITÀ PER  UN PARTICOLARE  SCOPO.  Si
    veda la Licenza Pubblica Generica GNU per avere maggiori dettagli.

    Questo  programma deve  essere  distribuito assieme  ad una  copia
    della Licenza Pubblica Generica GNU;  in caso contrario, se ne può
    ottenere  una scrivendo  alla Free  Software Foundation,  Inc., 59
    Temple Place, Suite 330, Boston, MA 02111-1307 USA


*** CREDITS:


ZipArchive library - creation, modification and decompression of "zip" format archives
Copyright (C) 2000 - 2003 Tadeusz Dracz.
http://www.artpol-software.com

CCmdLine - A utility for parsing command lines.
Copyright (C) 1999 Chris Losinger, Smaller Animals Software.
http://www.smalleranimals.com

Special thanks to Laura Mensi, Elena Brescacin and Paolo Attivissimo

Sun and StarOffice are registered trademarks of Sun Microsystems, Inc. 
Microsoft, Windows and Microsoft Office are registered trademarks of Microsoft Corporation.



Go Back to o3find main page

 

 

Copyright © 2003-2005 Paolo Copello.
Important note: The ad-banners were added by Tiscali hosting service, Paolo Copello is NOT responsible for their contents
Nota importante: I banner pubblicitari sono stati aggiunti dall'hosting service di Tiscali, Paolo Copello NON è responsabile dei loro contenuti.