  Batch Editor V. 0.1 * (c) 1998 Alessandro Cantatore - Team OS/2 Italy

  **************************************************************************

  NOTA:

  In nessun caso l'autore del programma pu essere ritenuto responsabile di
  DANNI causati dal programma.

  L'USO DEL PROGRAMMA  GRATUITO e libero su qualsiasi numero di macchine.

  E' permesso MODIFICARE il programma per adattarlo alle proprie esigenze.

  E' permesso DISTRIBUIRE il programma purch siano inclusi tutti i file
  contenuti nell'archivio originale senza alcuna modifica.

  Non  permessa la VENDITA del programma, ma  permesso richiedere un prezzo
  ragionevole per coprire le spese del mezzo di distribuzione.

  --------------------------------------------------------------------------
  L'USO DEL PROGRAMMA IMPLICA L'APPROVAZIONE DELLE SUMMENZIONATE CONDIZIONI.
  --------------------------------------------------------------------------

  Alessandro Cantatore
  alexcant@tin.it
  alexcant@pandora.it
  FIDONET: 2:335/705.2
  http://acsoft.ghostbbs.ml.org

  **************************************************************************


--[Indice]------------------------------------------------------------------

 - Introduzione
 - Installazione
 - Caratteristiche e configurazione del programma
 - Sviluppi futuri
 - Registrazione


--[Introduzione]------------------------------------------------------------

  Batch Editor  una semplice applicazione PM "multithreaded" che permette
  di definire una lista di stringhe da ricercare e sostituire in una serie
  di file.
  Usandolo sui file di sistema pu essere utilizzato per spostare una
  installazione del sistema operativo da una partizione ad un'altra con
  una diversa lettera di identificazione o per editare i riferimenti ad
  un'applicazione che si vuole spostare in una differente directory.


--[Installazione]-----------------------------------------------------------

  E' sufficiente copiare in una qualsiasi directory i file del programma:
  BATCHED.EXE
  SMWUTIL.DLL
  PROGRESS.DLL
  Il programma non necessita di alcuna modifica del CONFIG.SYS, purch
  nella direttiva LIBPATH sia compresa la directory corrente, cio ".;".
  Il programma non modifica i file INI di sistema.


--[Caratteristiche e configurazione del programma]--------------------------

  Il programma consiste in una finestra di dialogo con due "listbox" e
  alcuni pulsanti che vengono opportunamente abilitati e disabilitati
  dal programma.

  Nella listbox di sinistra, "File:", vengono elencati i nomi dei file
  da editare.
  I nomi dei file possono includere i caratteri "jolly" "*" e "?".
  I nomi dei file possono essere aggiunti o inserendone il path completo
  nell'entryfield sottostante la listbox e cliccando sul bottone "Add"
  o selezionando uno o pi file dal dialogo che appare quando si clicca
  sul bottone "Find...".
  Quando si seleziona un file nella listbox, vengono abilitati il bottone
  "Remove", tramite cui  possibile cancellare il file dalla lista, e la
  checkbox "Recur subdirectories" che permette di cercare i file
  corrispondenti alle specifiche del file selezionato anche nelle
  subdirectory.
  Un doppio click su un file della lista introduce il nome del file
  nell'entryfield sottostante permettendo cos di editarlo.

  Nella listbox di destra, "Strings:", vengono elencate le coppie di
  stringhe da ricercare e sostituire separate dai caratteri " -> ".
  Le stringhe da ricercare vengono inserite nel campo "Find:", quelle
  da sostituire nel campo "Replace:". Se non viene introdotto alcun dato 
  in quest'ultimo campo, le stringhe verranno semplicemente cancellate
  dai file durante la procedura di editazione.
  I pulsanti "Add" e "Remove" servono per aggiungere e rimuovere le
  coppie di stringhe nella lista.
  La checkbox "Case insensitive" viene abilitata quando si seleziona una
  stringa e permette ricercare e sostituire la stringa selezionata
  indipendentemente dal fatto che i caratteri che la compongono siano
  maiuscoli o minuscoli.
  Nella versione corrente non viene eseguito alcun controllo sulle
  stringhe inserite nella listbox. Dato che nella procedura di editazione
  le sostituzioni vengono eseguite nell'ordine in cui appaiono nella lista,
  tale ordine  critico quando nella lista delle stringhe da ricercare
  siano comprese stringhe che iniziano con porzioni di altre stringhe.
  Per esempio, nel caso si vogliano sostituire tutte le occorrenze di
  "strcpy" con "CopyString" e quelle di "str" con "psz",  indispensabile
  che "strcpy" preceda "str" nella lista. Nel caso contrario non si avrebbe
  alcuna sostituzione di "strcpy" con "CopyString" perch verrebbe prima 
  considerata l'occorrenza di "str" ottenendo cos "pszcpy".
  Al momento non  prevista alcuna opzione per sostituire solo stringhe
  che siano parole a se stanti. Per esempio specificando nel campo di
  ricerca la stringa "copy" verranno sostituite non solo tutte le
  occorrenze di "copy" ma anche parte di parole come "copyFile".
  Per evitare ci  necessario sostituire la stringa da preservare con
  se stessa, cio inserire prima di "copy" la coppia "copyFile -> copyFile".

  Dopo aver inserito i nomi dei file e le sostituzioni da effettuare
  cliccando su "Start" si avvia la procedura di editazione vera e propria.
  A questo punto appare un dialogo con una barra di progresso.
  Premendo sul bottone "Stop" nel dialogo di progresso si pu interrompere
  l'operazione.
  Il programma non salva una copia di backup dei file editati! E' quindi
  opportuno creare un backup dei file prima di procedere con l'editazione.


--[Sviluppi futuri]---------------------------------------------------------

- Nelle prossime versioni dell'applicazione l'interfaccia verr migliorata
  rendendo la finestra principale dell'applicazione e la larghezza delle
  liste dei file e delle stringhe ridimensionabili.
- Verr aggiunto un blocco delle preferenze per impostare il font preferito
  e altre opzioni.
- Verr aggiunta una statusbar per l'help contestuale e il report di errori.
- Supporto per il "drag and drop" nella listbox dei file.
- Controllo stringhe sostituzione per evitare duplicati e o conflitti.
- Importazione di liste di file e di sostituzioni da testo.
- Possibilit di ricercare sostituire stringhe che contengono caratteri NULL.
- Possibilit di ricercare e sostituire stringhe secondo la sintassi del
  GREP.
- Possibilit di salvare "profili di sostituzione" in modo da poter usare
  il programma come convertitore di formati.
- Possibilit di creare un backup dei file editati anche specificando un
  programma esterno di compressione dei dati.
- Possibilit di preview delle sostituzioni con eventuale esclusione di
  alcune sostituzioni.
- Dialogo con doppia barra di progresso: una per il progresso nel numero
  dei file, l'altra per il progresso relativo al file.
- Supporto per il REXX per potenziare ulteriormente gli automatismi di
  editazione e di conversione di formati.


--[Registrazione]-----------------------------------------------------------

  La versione corrente  in fase di pre-beta e come tale liberamente usabile.
  La versione definitiva del programma sar probabilmente shareware.
