@DATABASE "McAgenda"
@SMARTWRAP
@NODE MAIN "McAgenda"
@FONT courier.font 13
@NEXT Condizioni_d'uso
@smartwrap


@{jcenter}
@{b}@{bg highlight}<< McAgenda v4.3a >>@{bg back}@{line}
~~~~~~~~~~~~~~@{ub}@{line}
@{u}Scritto da Roberto Bizzarri © 1993-1996@{uu}@{line}

@{b}McAgenda@{ub}@{line}

@{"        Introduzione        " LINK Introduzione}@{line}
@{"      Condizioni d'uso      " LINK Condizioni_d'uso}@{line}
@{"       ToolType e CLI       " LINK ToolType_&_CLI}@{line}

@{b}Interfaccia@{ub}@{line}

@{"     Schermo principale     " LINK Schermo_principale}@{line}
@{" Finestra di lettura record " LINK Finestra_di_lettura_record}@{line}
@{" Finestra di editing record " LINK Finestra_di_editing_record}@{line}
@{" Finestra di configurazione " LINK Finestra_di_configurazione}@{line}

@{b}Miscellanea@{ub}@{line}

@{"           History          " LINK History}@{line}
@{"           Autore           " LINK Autore}@{line}

@{jleft}
@ENDNODE


@NODE Introduzione
@{line}@{jcenter}
@{bg highlight} Introduzione @{bg back}@{line}
@{jleft}@{line}
     McAgenda non è altro che una semplice agenda telefonica ideata con
l'intento di avere un programma di piccole dimensioni, rapido utilizzo e
soprattutto di immediata consultazione per ogni singolo record... ritengo
infatti inutile dover caricare ogni volta grossi programmi (certamente con
potenzialità maggiori, ma che per un'agenda non servono!) e doversi
districare tra le molteplici opzioni... e tutto questo solo per leggere un
numero di telefono!! Allora tanto vale usare le classiche agende
cartacee...@{line}
     McAgenda necessita del Sistema Operativo 2.0 (V37) o superiore e la
"reqtools.library" (© Nico François & Magnus Holmgren).
@ENDNODE


@NODE Condizioni_d'uso
@{line}@{jcenter}
@{bg highlight} Condizioni d'uso @{bg back}@{line}
@{jleft}@{line}
     Questo programma è GRATUITO (freeware). Potete usarlo e distribuirlo
liberamente, purché gratuitamente e nel rispetto delle tradizionali regole
morali e legali, cioé lasciare intatti i file che accompagnano il programma,
rispettare i diritti d'autore ecc. Questo software è fornito "così com'è" senza
garanzia di alcun tipo e l'autore non risponde di eventuali danni causati dal
suo utilizzo.@{line}

     @{b}Vi chiedo solo di inviarmi un messaggio (vedi @{"Autore" LINK Autore}) via posta
elettronica; mi piace sapere che da qualche parte, qualcuno usa un mio programma! :-)@{ub}
@ENDNODE


@NODE ToolType_&_CLI
@{line}@{jcenter}
@{bg highlight} ToolType e CLI @{bg back}@{line}
@{jleft}@{line}
     McAgenda carica automaticamente i dati ogni qualvolta viene lanciato. Il
<nomefile> di default è "S:McAgenda.data" ma può essere modificato a piacere
servendosi dell'apposito ToolType oppure passandoglielo da CLI:@{line}
 1.Ram Disk:> @{b}McAgenda <path+nomefile>@{ub}@{line}
     I ToolTypes vengono presi in considerazione solo quando il programma è
lanciato da Workbench cliccando sull'icona:@{line}
@{line}
 @{b}DATAFILE=<path+nomefile>@{ub} : serve per specificare nome e directory
da cui sarà letto o salvato il file di dati.@{line}
@ENDNODE


@NODE Schermo_principale
@{line}@{jcenter}
@{bg highlight} Schermo principale @{bg back}@{line}
@{jleft}@{line}
     Usare McAgenda è semplicissimo. Possono essere gestiti 180 record
suddivisi in 2 aree da 90 ciascuna. Ogni area viene visualizzata su 3
pagine, con i gadget "Previous" e "Next" ci si sposta tra di esse. La prima
area è accessibile da tutti (Public), mentre la seconda è segreta (Secret):
per accedervi è necessario conoscere il codice d'accesso.@{line}
     Se l'area segreta non è stata ancora inizializzata, premendo il pulsante
"Secret" verrà chiesto di inserire un nuovo codice d'accesso (attenzione alle
maiuscole e minuscole poichè il programma ne tiene conto!). Se invece si carica
un'agenda contenente già i dati dell'area segreta, al primo accesso dovrete
inserire il codice. Per cambiarlo è sufficiente premere un tasto funzione
qualsiasi (F1-F10) quando vi trovate all'interno dell'area segreta.@{line}
     Nella lista dei record, accanto ad ognuno di essi, vi è un gadget
contenente il numero corrispondente: cliccandoci col tasto sinistro del mouse
si potrà leggere il contenuto del record, invece cliccando col tasto destro
potranno essere inseriti/modificati i dati. Le stesse operazioni possono essere
effettuate da tastiera: nell'elenco dei record noterete subito la presenza di
un cursore "»" giallo; tramite i comuni 4 tasti per il movimento cursore potete
spostare la freccetta sul record desiderato e premendo "Invio" passerete alla
lettura, mentre col tasto "Spazio" può essere inserito/modificato il record
prescelto.@{line}
     Il gadget denominato "Match" consente di inserire una stringa che
McAgenda ricercherà (lettere maiuscole o minuscole non fanno differenza) tra i
90 record dell'area corrente; possono essere usate le "wild-cards" (#?) nella
ricerca, come per i file in AmigaDOS. Per le opzioni di ricerca vedere
@{"Finestra di configurazione" LINK Finestra_di_configurazione}.@{line}
     Col gadget "New" si può cancellare dalla memoria tutta l'agenda e crearne
quindi una nuova.@{line}
     Il gadget "Load data" consente di ricaricare il file, "Save data"
(ovviamente) serve per salvare l'agenda; quest'ultima operazione è disponibile
anche durante il "Quit" nel caso in cui i dati siano stati modificati.@{line}
     Il gadget "Config" (vedere @{" Finestra di configurazione " LINK Finestra_di_configurazione})
permette di configurare McAgenda secondo le proprie esigenze; tali
configurazioni vengono salvate nel file dati stesso.@{line}
     Nella parte bassa dello schermo le due scritte di sinistra indicano
rispettivamente se i dati (record) e le configurazioni di McAgenda sono state
modificate. Le rimanenti due scritte, sul lato destro, indicano la percentuale di
riempimento delle aree di McAgenda.@{line}
     Da tutte le finestre (compreso lo schermo principale) il tasto "Esc" ha la
funzione di abbandonare l'operazione in corso.@{line}
@ENDNODE


@NODE Finestra_di_lettura_record
@{line}@{jcenter}
@{bg highlight} Finestra di lettura record @{bg back}@{line}
@{jleft}@{line}
     Durante la lettura di un record con i tasti cursore Sinistra/Destra si
passa al precedente/successivo. @{u}Inoltre premendo un tasto McAgenda si
posizionerà sul primo record che inizia col carattere specificato.@{uu}@{line}
     Il gadget "Edit" (o il tasto di Invio) permette di passare all'"editing"
del record che si sta leggendo.@{line}
     Durante la funzione di ricerca comparirà anche il gadget "Find Next"
mediante il quale McAgenda proseguirà la ricerca con i record seguenti.@{line}
@ENDNODE


@NODE Finestra_di_editing_record
@{line}@{jcenter}
@{bg highlight} Finestra di editing record @{bg back}@{line}
@{jleft}@{line}
     In questa finestra i comandi da tastiera sono attivi solo se nessuno dei 4
campi (Name, Address, ecc.) è selezionato. Agendo su "Ok" si conferma il
record corrente e si chiude la finestra. Il gadget "Cancel", annulla le
modifiche apportate al record corrente e ritorna alla lista. "Clean up" serve per
cancellare l'intero contenuto del record corrente.@{line}
     Premendo il tasto "Invio" o "Spazio" si attiva il primo campo. Con
"TAB/Shift+TAB" si scorrono i 4 campi. Durante l'inserimento dei dati
all'interno di un campo, con "Ctrl+X" si cancella il contenuto e
"AmigaDestro+Q" ripristina il valore precedente del gadget.@{line}
     "->Secret" (o "->Public") ha la funzione di trasferire il record corrente
nell'altra area. Tale gadget è attivo solo se l'area in cui intendete
trasferirlo dispone di almeno un record vuoto.@{line}
@ENDNODE


@NODE Finestra_di_configurazione
@{line}@{jcenter}
@{bg highlight} Finestra di configurazione @{bg back}@{line}
@{jleft}@{line}
Nella finestra di configurazione sono disponibili i seguenti settaggi:@{line}
  @{b}Backup datafile@{ub}: se attivo, McAgenda creerà la backup del file di
dati (<nomefile>.bak) la quale conterrà i dati precedenti all'ultima modifica
effettuata sui record.@{line}
  @{b}Confirm Quit@{ub}: cliccando su "Quit" un requester chiederà di
confermare l'operazione.@{line}
@{line}
Opzioni di ricerca (NB: la ricerca non fa differenza tra lettere maiuscole
e minuscole):@{line}
  @{b}Search on `Name'@{ub}: la ricerca della stringa specificata nel gadget
"Match" dello schermo principale avviene nel campo "Name" dei 90 record
dell'area corrente.@{line}

  @{b}Search on `Address'@{ub}: la ricerca avviene nel campo Address.@{line}

  @{b}Search on `Phone'@{ub}: la ricerca avviene nel campo Phone.@{line}

  @{b}Search on `Notes'@{ub}: la ricerca avviene nel campo Notes.@{line}
@ENDNODE


@NODE History
@{line}@{jcenter}
@{bg highlight} History @{bg back}@{line}
@{jleft}@{line}
   Breve riepilogo delle variazioni apportate a McAgenda, versione per
versione. NB: sono riportate solo le modifiche più significative.@{line}


@{b}v4.3a@{ub}@{line}
Corretto il mancato funzionamento di alcune hotkey (Esc nelle finestre e
Spazio/Invio nella principale) la cui gestione era stata erroneamente
rimossa nella v4.3; ringrazio "Clc" per la segnalazione.@{line}

@{b}v4.3@{ub}@{line}
Localizzato. Corretta errata gestione delle aree Pubblica/Segreta. Corretti
bug minori.@{line}

@{b}v4.2@{ub}@{line}
Ricompilato col SAS-C!! Sorgente completamente rivisto, notevolmente
corretto e migliorato. Praticamente riscritto quasi tutto il programma ;-) ...
Ora il gadget Match accetta le wild-cards; se non vengono inserite, assume
"#?<stringa>#?". Modificata window di configurazione e soppressi alcuni
settaggi di scarsa utilità.@{line}

@{b}v4.1@{ub}@{line}
Eseguita revisione generale del programma e migliorate alcune funzioni.
Aggiunta finestra di configurazione; ora i settaggi vengono salvati e letti
dal file dati. Aggiunto campo "Notes" ai record. Eliminati un paio di
grossi bug (finalmente ho il software necessario per scovarli!). Potenziata
funzione di ricerca.@{line}

@{b}v4.0@{ub}@{line}
Aggiunta di alcune funzioni per l'utente tra cui quella di ricerca record.
Notevolmente migliorata funzione di sort dei record. Creazione dell'area
segreta. Debugging generale.@{line}

@{b}v3.0@{ub}@{line}
Numerose correzioni, aggiornamenti e migliorie. Aggiunto utilizzo del
FileRequester della "reqtools.library". La scelta del record da
leggere/editare ora può avvenire direttamente tramite mouse -tasto sinistro
e destro- o tastiera; nella v2.x bisognava prima cliccare su Edit e poi
specificare il numero del record. Migliorata routine di sort. Aggiunto
gadget Iconify.@{line}

@{b}v2.4a@{ub}@{line}
Solo qualche miglioria e correzione rispetto alla precedente
versione.@{line}

@{b}v2.4@{ub}@{line}
Aggiunte hoykey per la selezione dei gadget e dei record da
tastiera.@{line}

@{b}v2.3@{ub}@{line}
Da questa versione McAgenda entra nel gratificante mondo della
"gadtools.library"! Infatti tutti i gadget sono stati rimpiazziati da
quelli più belli ed efficienti, nonché facili da gestire e creare, della
"gadtools.library" rendendo McAgenda un programma moderno (i vecchi gadget
sono tipici delle ormai obsolete versioni del SO 1.x che non disponevano
della "gadtools.library", nota per offrire gadgets con aspetto
tridimensionale).@{line}

@{b}v2.2@{ub}@{line}
Cambiato il "look" generale dello schermo, modificato il sistema di Quit
(chiede conferma e salva i dati se sono stati modificati), auementata la
capacità di ogni singolo record: 75 caratteri.@{line}

@{b}v2.1@{ub}@{line}
Solo qualche miglioria e correzione rispetto alla precedente
versione.@{line}

@{b}v2.0@{ub}@{line}
Ho  imparato  ad  usare alcune delle principali librerie di Amiga.  Da questa
versione McAgenda inizia a diventare un programma un pò più serio, dispone di
schermo  proprio,  fa  uso  di  finestre e gadget.  Radicalmente cambiato
rispetto alla prima versione.@{line}

@{b}v1.1@{ub}@{line}
Solo qualche piccola miglioria e correzione rispetto alla precedente
versione.@{line}

@{b}v1.0@{ub}@{line}
Nasce McAgenda. Inizialmente era solo una esercitazione in C poichè ero
ancora ai miei primi passi con questo fantastico linguaggio. Non conoscevo
ancora le librerie di Amiga quindi McAgenda era solo un programmino banale
e utilizzabile da shell, senza schemo proprio e non
"intuition-izzato"!!@{line}
@{line}
@ENDNODE

@NODE Autore
@{line}@{jcenter}
@{bg highlight} Autore @{bg back}@{line}
@{jleft}@{line}
Mi trovate su:         @{b}Nightmare BBS ~ 0721-21317 (Italy!)@{ub}@{line}
@{line}
indirizzo Internet:    @{b}robiz@mbox.vol.it@{ub}@{line}
@{line}
indirizzo Fidonet:     @{b}Roberto Bizzarri ~ 2:332/901.31@{ub}@{line}
@{line}
indirizzo postale:      @{b}Bizzarri Roberto,@{ub}@{line}
                        @{b}via Giolitti 124,@{ub}@{line}
                       @{b}61100 Pesaro ~ Italy@{ub}@{line}
                        @{b}(Tel. 0721-455324)@{ub}@{line}
@{line}
     McAgenda è disponibile nei siti mirror di Aminet ed in tutte le
maggiori BBS. In particolare si può fare riferimento alla seguente BBS dove
saranno sempre disponibili le ultime versioni ed aggiornamenti del
programma:@{line}
@{jcenter}Speed Of Life@{line}
0931-833773 (V34/28800) ~  0931-833763 (ZYX/19200)@{line}
2:335/533@fidonet ~ 39:102/12@amiganet@{line}
@{line}@{jleft}
@{b}@{fg highlight}Ringrazio per la collaborazione:@{ub}@{fg text}@{line}
@{line}@{jcenter}
Phalanx: mgiorgin@dsi.unive.it - phalanx@freenet.hut.fi@{line}
Alex Pagnoni: alexpag@mbox.vol.it - 2:332/901.50@{line}
@{line}
@ENDNODE
