-----------------------[Comment Manager V.0.3 beta]-------------------------

-------------[(c) 1997 Alessandro Cantatore * Team OS/2 Italy]--------------

Questo programma  gratuito ed  ancora in versione "beta". Nonostante ci
non dovrebbe causare alcun danno o perdita di dati. Questa versione 
liberamente usabile fino al 30 aprile 1997. Dopo tale data il programma
verr disattivato.

Come al solito l'autore non pu essere ritenuto responsbile di alcun danno
o perdita di dati che si presume siano causati dal programma stesso.
L'uso del programma  subordinato all'adesione alle suddette condizioni.

----------------------------------------------------------------------------

Cosa c' di nuovo rispetto alla precedente versione

  - La finestra principale del programma  stata leggermente ingrandita.
  - E' stata aggiunta la possibilit di editare l'attributo ".SUBJECT"
  - Ora  possibile impostare un font diverso da quello di default nella
    finestra principale del programma.
  - E' possibile selezionare pi file contemporaneamente, impostando lo
    stesso attributo per tutti i file selezionati.
  - Si pu disattivare il logo iniziale.
  - Se il programma viene minimizzato sulla scrivania viene correttamente
    mostrata l'icona.
  - Per migliorare l'interazione con la tastiera  ora possibile spostarsi
    tra le varie finestre premendo "Alt" + il carattere sottolineato


Introduzione:

Il programma permette di aggiungere, modificare o cancellare con facilit
gli attributi estesi .SUBJECT, .COMMENTS e KEYPHRASES dei file.
Per esempio, io ho molti file compressi scaricati da internet, di cui spesso
non ricordo il contenuto con i conseguenti problemi quando cerco un particolare
file. "Comment Manager" permette di aggiungere una piccola descrizione
(fino a 32 KB quindi neanche tanto piccola) ed alcune "frasi chiave", per
le funzioni di ricerca, ad ogni file o directory.
Anche se il pulsante "Find" non  funzionante in questa versione,  possibile
usare l'utilit di ricerca dei file incorporata in OS/2 per operazioni di
ricerca basate sull'attributo esteso "frasi chiave".
Nel caso di una BBS, che ha numerosi file compressi, riguardanti diversi
sistemi operativi e diversi tipi di applicazione, si potrebbero usare diverse
frasi chiave per ogni file, cje per esempio descrivano:
-1) l'autore dell'applicazione
-2) il sistema operativo per cui  stata progettata
-3) il tipo di applicazione (file manager, gioco, ecc.)
-4) una vostra valutazione (applicazione utile, scarsa, buona, ecc.)
-5) qualsiasi altra cosa
In questo modo, tramite l'utilit di ricerca incorporata nel sistema operativo
si potrebbero creare automaticamente cartelle contenti tutti i "file manager
per OS/2 in modo testo", tutti i "giochi DOS", tutti i programmi di un dato
autore e cos via.


Installazione:

Spostatelo in una qualsiasi directory ed avviatelo da riga di comando o con
il mouse. Non richiede la presenza di altre DLL a parte quelle facenti parte
di OS/2 e non scrive alcun dato nei file INI.
Da questa versione  possibile impostare alcune opzioni tramite parametri
che possono essere introdotti avviando il programma da riga di comando o
tramite l'apposito campo nel blocco impostazioni del programma stesso.
E' anche possibile creare diversi oggetti Comment con diverse impostazioni.
Vedete il paragraf "Opzioni:" per maggiori dettagli.


Come funziona:

Il programma non  altro che una finestra di dialogo per la selezione dei
vari file, con due campi per l'editazione delle frasi chiave e dei commenti
e uno per l'editazione dei "subject" (massimo 40 caratteri).
Se avete cambiato i dati relativi ad uno dei suddetti campi e selezionate
un nuovo file o directory, una finestra di dialogo vi chieder se volete
salvare le modifiche apportate, cambiare file senza salvare o annullare la
selezione del nuovo file.
Cliccando sul pulsante "Save", prima di selezionare un nuovo file, si salvano
i dati e si evita l'apparire della suddetta finestra di dialogo.
Se tramite l'opzione "-e" (oppure "/e") viene impostata la modalit di
selezione estesa, sar possibile selezionare pi file con la stessa modalit
di selezione della WPS:
 - trascianando il mouse con il tasto 1 premuto
 - cliccando con il mouse tenendo premuto il tasto Ctrl per selezionare
   file non contigui
 - cliccando con il mouse tenendo premuto il tasto Maiuscole per selezionare
   tutti i file compresi tra la prima selezione e l'ultima.
Gli attributi e le specifiche del file mostrato sono relativi al primo file
selzionato.
Volendo impostare lo stesso attributo (per esempio la stessa "Key Phrase")
per tutti i file selezionati,  necessario premere il pulsante "Save" in
quanto selezionando un file diverso senza premere tasto "Ctrl" o quello
"Maiuscole" (deselezionando cos i file precedentemente selezionati) e
selezionando "Save" dalla successiva finestra di dialogo, sar possibile
salvare solo il primo file della precedente selezione.
Se si preme il pulsante "Save" quando sono selezionati pi file compare
un'ulteriore finestra di dialogo con delle "checkbox" per specificare quale
attributo deve essere inpostato per tutti i file selezionati. Per esempio, i
file selezionati potrebbero avere ciascuno dei commenti diversi. Nel caso si
voglia impostare lo stesso "subject" e o "key phrase" per tutti, senza
modificare i vari commenti, sar sufficiente selezionare la checkbox "subject"
(o "Key Phrases"). Cos si imposter lo stesso "subject" per tutti i file
lasciando inalterati i commenti.
La routine di ricerca non  ancora stata implementata, per cui il pulsante
"Find" non provoca alcun cambiamento nel dialogo.
Il pulsante Quit permette di terminare il programma. Se qualche attributo 
stato cambiato, la finestra di dialogo sopra descritta vi permetter di
salvarlo, terminare il programma senza salvare le modifiche o cancellare la
chiusura del programma.


Opzioni:

E' ora possibile specificare alcune opzioni per modificare il comportamento
di default del programma. In attesa di aggiungere un file INI ed un notebook
per una pi agevole impostazione delle stesse, ho implementato la scelta di
tali opzioni trmaite parametri aggiuntivi da aggiungere da riga di comando
o nel campo "Parametri" della pagina Programma del blocco impostazioni di
Comment Manager. Potrebbe anche essere utile creare diversi oggetti programma,
ciascuno con opzioni diverse.
Le opzioni possono essere introdotte in qualsiasi ordine, in qualsiasi
combinazione, come lettere maiuscole o minuscole e possono essere introdotte
sia dallla barra "/" che dal trattino "-". Nel caso l'opzione immessa non
fosse valida viene mostrata una finestra di dialogo con una breve lista delle
opzioni valide.
Le opzioni valide sono:
   -N (-n | /N | /n) avvia il programma senza visualizzare il Logo
   -E (-e | /E | /e) permette di selezionare pi file con la stessa modalit
                     di selezione degli oggetti della WPS (vedi sopra).
   -FdatiFont (-f | /F | /f) datiFont rappresenta la dimensione e nome del
                     font (riportata esattamente come mostrata nella Font
                     Palette contenuta nella cartella Impostazione del sistema)
                     che si vuole usare nella finestra principale del
                     programma.
                     Se il nome del font include uno spazio  necessario
                     racchiudere tutta l'opzione tra virgolette (").
                     Esempio:
                     "-f5.System VIO"


Limiti del programma:

-1) Non  stato ancora implementato un "exception handler" nel caso venga
    selezionata un unit "non pronta" (un lettore di CD ROM senza CD ROM
    inserito, un drive senza floppy, ecc.). Se viene selezionato un drive
    non presente potete solo inserire il mezzo nel drive o terminare il
    programma.
-2) Il comportamento delle varie listbox non  coerente: un solo click del
    mouse  sufficiente per selezionare un nuovo drive o file, ma  necessario
    un doppio click per cambiare directory.
-3) Se il path relativo al file corrente  troppo lungo non viene mostrato
    completamente, ma questo accade raramente se si usa un carattere non
    molto grande come il WarpSans o il System VIO 5.
-4) Avendo usato "list box" standard ci potrebbero essere problemi nel caso
    di directory contenenti grosse quantit di file (32765 file con Warp 3
    o Warp 4 - con la versione 2 il limite potrebbe essere inferiore).
-5) Il codice non  stato ottimizzato n per la velocit, n per la dimensione.
    Il programma lavora molto bene con il mio P100, ma penso che la velocit
    dovrebbe essere buona anche con un 386 (fatemi sapere).
    Il programma non  stato compresso, non  comunque cos ingombrante
    (circa 35 KB). Se avete Warp 3 o 4 potete ridurne la dimensione fino
    a circa 20 KB usando LXLITE ( un programma freeware di Andrew Zabolotny
    e pu essere scaricato da hobbes.nmsu.edu/os2/archiver come lxlt115.zip).
    I programmi scritti in C possono richiedere un maggior lavoro di
    programmazione, ma producono eseguibili pi compatti e performanti!
-6) Nel caso della selezione multipla dei file, se si edita un attributo e
    si deselezionano i file precedentemente selezionati tramite la selezione
    di un nuovo file, premendo "Save" nella nuova finestra di dialogo si
    salva solo il primo dei file precedentemente selezionati. Volendo
    impostare lo stesso attributo per pi file  quindi necessario cliccare
    sul pulsante "Save" della finestra principale.


Cosa ci sar nelle prossime versioni?

Nel caso qualcuno sia interessato potrei facilmente aggiungere:
-0) Eliminare i limiti precedentemente citati.
-1) Blocco impostazioni/propriet per cambiare i colori e font della finestra
    ed impostare il comportamento di default delle varie altre funzioni.
-2) Finestra ridimensionabile con ridimensionamento automatico dei controlli
    interni. Memorizzazione nel proprio file INI delle dimensioni e posizione
    della finestra.
-3) Visualizzazione del contenuto dei "file_id.diz" inclusi nei file compressi
    con possibilit di copiarlo nell'attributo esteso ".COMMENTS".
-4) Importazioni di altri tipi di commenti come quelli creati dal 4DOS e 4OS/2.
-5) Possibilit di cambiare l'ora e la data dei file per uno o pi file anche
    ricorsivamente nelle subdirectory.
-6) Accesso agli attributi estesi standard e non standard.
-7) Una potente routine di ricerca dei file basata sul contenuto degli stessi,
    e/o sul contenuto degli attributi estesi.
-8) Un menu contestuale con le voci base di editazione (taglia/copia/inserisci,
    seleziona/deseleziona, ecc) nei campi di editazione degli attributi.
-9) Help con alcune note riguardanti gli attributi estesi.
-10)Migliore organizzazione della listbox delle directory.
-11)Possibilit di visualizzare anche le icone dei file e directory.
-12)Possibilit di memorizzare in un proprio file, sul disco fisso, gli
    attributi estesi dei file presenti su dischi non scrivibili in quanto
    tali (CD ROM) o per mancanza dispazio libero (FLOPPY pieni) in modo da
    creare un data base di tutti i file disponibili.
-13)Versioni nazionalizzate (in italiano).
-14)Qualsiasi altra funzione potete suggerirmi.

Probabilmente il programma definitivo verr distribuito come shareware in
diverse versioni e con prezzi differenti in modo da venire incontro alle
varie esigenze senza obbligare a spendere soldi per delle funzioni che non
si usano.

Scrivetemi per qualsiasi suggerimento o per riportare eventuali bug.

Alessandro Cantatore
  Team OS/2 Italy
alexcant@mbox.vol.it
