@database EasyFR.guide @master EasyFR.guide @$VER: 2.0 @author "Francesco Dipietromaria" @(c) "1995" @remark Created with Heddley v1.1 (c) Edd Dumbill 1994 @node "Main" "EasyFR.guide" @next "Legal issues" @{b}EasyFR v2.1@{ub} EasyFR, una utility per la gestione dei File-Request FidoNet. Copyright © 1994 Angelo Vizzarro Copyright © 1995 Francesco Dipietromaria GUI creata con MUI © 1993 Stefan Stuntz. Questa guida descrive l' installazione e l' uso di 'EasyFR'. @{" Aspetti legali " link "Legal issues" 0} @{" Cos'è EasyFR? " link "About EasyFR" 0} @{" Installazione " link "How to install" 0} @{" Partenza! " link "Let's go!" 0} @{" Storia " link "History" 0} @{" Registrazione " link "How to register" 0} @{" Come contattare l'autore " link "Author address" 0} @{" Ringraziamenti " link "Acknowledgements" 0} @endnode @node "Legal issues" "EasyFR.guide/Aspetti legali" @next "License" @prev "Main" @{b} Aspetti legali@{ub} @{" Licenza " link "License" 0} @{" Nessuna garanzia " link "No Warranty" 0} @{" Smentite " link "Disclaimer" 0} @endnode @node "License" "EasyFR.guide/Licenza d'uso" @next "No Warranty" @prev "Main" @{b} Licenza@{ub} Questa licenza si applica al prodotto chiamato "EasyFR", un programma per i computer della serie Amiga, pubblicato da Francesco Dipietromaria sotto il concetto di ShareWare, ed alla documentazione, agli esempi ed a tutto ciò che è contenuto nella distribuzione originale. I termini "Programma" ed "EasyFR" di seguito si riferiscono a questo prodotto. Il beneficiario di questa licenza siete "voi". * Potete copiare e distribuire fedeli riproduzioni del codice eseguibile del probramma e della documentazione come l'avete ricevuto, su qualunque supporto, verificando che stiate appropriatamente rilasciando una versione originale, con il programma non modificato, con tutte le informazioni di copyright e di mancanza di garanzia intatte, compresa tutta la documentazione, i files di esempio e tutto ciò che è contenuto nell'originale. * Non potete copiare e/o distribuire questo programma senza la documentazione e tutti gli altri files aggiuntivi che lo accompagnano. Non potete copiare e/o distribuire versioni modificate del programma. * Non potete copiare, modificare, sub-licenzare, distribuire o trasferire il programma, fatta eccezione dei modi descritti in questa licenza. Qualsiasi tentativo altrimenti di copiare, modificare, sub-licenziare, distribuire o trasferire il programma è vano e conclude automaticamente i vostri diritti di usare questo programma sotto questa licenza. Comunque, coloro che hanno ricevuto copie o diritti all'uso di copie da voi sotto questa licenza non vedranno concludere la loro licenza finché vi aderiranno completamente. * Copiando, distribuendo e/o usando il programma voi indicate la vostra adesione a questa licenza ad essere tale, in tutti i suoi termini e le sue condizioni. * Ogni volta che ridistribuite il programma, il nuovo beneficiario automaticamente riceve una licenza dall'@{"autore" link "Author address" 0} per copiare, distribuire e/o usare il programma soggetto a questi termini e condizione. Non potete imporre nessun'altra restrizione sull'esercizio dei diritti del beneficiario qui definiti. * Non potete disassemblare, decompilare o in altro modo invertire l'ingenierizzazione del programma. * Potete usare il programma per un periodo non superiore alle 3 settimane per la valutazione. Dopo questo periodo vi dovrete @{"registrare" link "How to register" 0} o interrompere l'utilizzo del programma. * Se desiderate inserire parti del programma in altri programmi, scrivete all'autore per chiedere il permesso. * Voi accettate di cessare la distribuzione del programma e dei dati associati se richiesto dall'autore. * Potete chiedere un pagamento per coprire le spese di distribuzione. Il pagamento per la distribuzione di un dischetto non può essere superiore al costo di un dischetto di publico dominio da Fred Fish. @endnode @node "No Warranty" "EasyFR.guide/Garanzia" @next "About EasyFR" @prev "Copyright" @{b} Garanzia@{ub} Questo programma è distribuito privo di garanzie di qualunque tipo, esplicite o implicite. Nell'usare `EasyFR' voi accettate qualunque rischio riguardante la qualità o le prestazioni dello stesso. Non c'è nessuna garanzia per il programma. In eccezione a dove scritto altrimenti dai proprietari dei diritti e/o in altre parti, i programmi sono distribuiti senza alcuna garanzia, sia implicita che esplicita, incluso, ma non limitato a garanzie di commerciabilità e di funzionalità per un particolare scopo. L'intero rischio della qualità e delle prestazioni dei programmi è a vostro carico. Se i programmi dovessero causarvi dei danni, voi vi fate carico di tutte le spese necessarie per i servizi, le riparazioni o le correzioni. In nessun caso (se non chiaramente prescritto dalle leggi in vigore o scritto dai proprietari dei diritti) gli autori o chiunque altro abbia redistribuito i programmi come prescritto sopra sarà perseguibile per i danni incluso qualsiasi danno generale, speciale, incidentale o consequenziale all'uso o ad incapacità d'uso dei programmi (incluso, ma non limitato alla perdita di dati, o a perdite causate a voi o a terze parti da errori dei programmi o dall'impossibilità di operare con altri programmi), anche se siete stati avvisati della possibilità di subire tali danni. Qualunque suggerimento, commento o lamentela è gradito. @{"Come contattare l'autore" link "Author address" 0}. @endnode @node "Disclaimer" "EasyFR.guide/Disclaimer" @next "Copyright" @prev "No Warranty" Smentite Nessuna garanzia, sia esplicita che implicita, è fornita commerciabilità o sulla funzionalità di `EasyFR'. Francesco Dipietromaria (di seguito indicato come "l'autore") si riserva il diritto di non sviluppare future versioni di `EasyFR'. L'autore cercherà di correggere qualsiasi problema, se ne saranno scoperti, ma non è in nessun caso obbligato a farlo. L'autore non si assume né accetta alcuna responsabilità per l'uso o il cattivo uso dei programmi. Non potrà inoltre essere ritenuto responsabile di danni o qualunque compenso oltre l'originale tassa di registrazione, dovuti a causa di perdite di profitto o altri danni nati dall'uso o dall'incapacità d'uso di questo programma. L'autore non potrà essere ritenuto responsabile dei danni causati dall'impossibilità di questo programma di funzionare come descritto, o dalla distruzione di altri programmi o dati residenti su di un sistema sul quale si è cercato di far funzionare i programmi. L'utente di questo programma lo utilizza a suo pieno rischio. @endnode @node "Copyright" "EasyFR.guide/Copyright" @next "About EasyFR" @prev "Disclaimer" @{b} Copyright@{ub} `EasyFR' è diventato @{i}shareware@{ui} a partire dalla versione 2.0. Gli utenti non registrati troveranno il solito fastidioso requester alla partenza del programma ed utilizzaranno una funzione rallentata e che richiede più memoria per la lettura delle filelist compattate con le librarie XPK. Sostenete il concetto di shareware. Se vi piace questo programma e lo utilizzate, prendete in considerazione l'ipotesi di @{"registrarvi" link "How to register" 0}. @endnode @node "About EasyFR" "EasyFR.guide/Cos'è EasyFR?" @next "How to install" @prev "Copyright" @{b} Cos'è EasyFR@{ub} Il progetto di `EasyFR' è nato dal mio amico Angelo Vizzarro, realizzatore della prima versione di questo software: "L'idea per la realizzazione di `EasyFR' nasce il giorno in cui il mio amico Gino Casavecchia mi mostra una serie di utility (su Amiga) per la gestione del File-Request; nessuna che gli andasse bene. E così, visto che ero in cerca di uno spunto per provare sul campo la `Magic User Interface' (MUI) mi misi al lavoro e questo è il risultato!" Nasce così. Sfortunatamente Angelo Vizzarro decise di abbandonare il progetto, anche a causa della scarsità di tempo da dedicargli. Mi feci avanti io, dicendogli che avrei voluto continuare a sviluppare il suo software. Ecco come si giunge a EasyFR 2.0. Questa è la versione 2.1, un aggiornamento che contiene, oltre alla cor- rezione di alcuni piccoli, ma fastidiosi bug, anche alcune interessanti novità. `EasyFR' è un' utility pensata per semplificare il File-Request. Dato lo scopo del programma, va da sé che l'utente potenzialmente interessato dovrà: - avere un Amiga :-) - avere un modem - avere il sistema già configurato per un uso 'telematico' - avere (o essere?) un Point presso una BBS in caso contrario ci sono buone probabilità che il programma non interessi!... EasyFR ha bisogno di: - Kickstart 2.0 (per sfruttare la localizzazione è necessario comunque il Workbench 2.1); - @{"MUI" link "Magic User Interface" 0} 2.2 (o successive; cercate l'archivio mui##usr.lha nella vostra BBS preferita); - @{"xpkmaster.library" link "XPK libraries" 0} 2.4 - traplist.library 5.2 (meglio se 5.4) Queste Le caratteristiche salienti di EasyFR 2.1: - Permette di creare e manipolare i files con estensione .REQ da inviare (tramite un mailer come il TrapDoor) alla BBS che dovrà soddisfare la richiesta. - Consultazione di liste di files (FileList) con possibilità di copiare i nomi dei files desiderati direttamente nella lista del .REQ - Backup della lista di richiesta - Verifica dei programmi downlodati ed inserimento automatico nella list .REQ di quelli non disponibili - Possibilità di caricare direttamente Filelist compattate con le XPK libraries - Funzioni di ricerca automatica all'interno della FileList con Progress indicator - Utilizzo delle nodelist con visualizzazione dei dati in esse contenute - QuickList modificabile contenente i nodi di utilizzo più frequente - Gestione del download tramite chiamata al mailer (come 'TrapDoor') - Visualizzazione della directory INBOUND con possibilità di editing dei commenti associati ai files in essa presenti (magari appena downloadati) - Possibilità di interfacciamento con gli archivi in formato LhA ed LZX (listing ed estrazione). - Possibilità di eseguire associazioni fra un Node Address e una parti- colare FileList; in questo modo ogni volta che si richiama un dato nodo, viene automaticamente caricato in memoria la lista files associata. - L'interfaccia utente del programma completamente personalizzabile da parte dell'utente; il merito di ciò va principalmente a Stefan Stuntz ed al suo 'MUI' (@{"Magic User Interface" link "Magic User Interface" 0}). - Il programma è localizzato; al momento le uniche due lingue supportate sono l'inglese (default) e l'italiano. - Aiuto in linea; premendo il tasto HELP in qualunque momento si attiva la visualizzazione di questo documento AmigaGuide®. Nulla di particolarmente eclatante quindi, tuttavia questo programma è stato scritto perché, a quanto pare, pur essendoci altre utility di questo genere in ambiente Amiga, tutte sembrano mancare di qualcosa per un aspetto o per l'altro. Altri programmi provvedono a chiamare il TrapDoor per il download ma non hanno la gestione della FileList, né tantomeno della nodelist... `EasyFR' cerca di svolgere il compito di interfacciare un File Request, in maniera semplice e completa. @endnode @node "Magic User Interface" "EasyFR.guide/Magic User Interface" Nella programmazione di `EasyFR' è stato usato `MUI' v2.0 (© Stefan Stuntz). Ciò significa che: 1) E` indispensabile avere installato `MUI' nel proprio sistema per poter eseguire questo programma 2) E` necessario possedere almeno la versione v2.04 di AMIGA OS (v37.175) per poter installare `MUI'. Chi ancora non conosce `MUI' potrà storcere il naso al pensiero di dover occupare parte del proprio prezioso Hard-Disk con l' installazione di un ennesimo pacchetto. Posso assicurare che ne vale la pena! `MUI' fornisce molteplici servizi sia all' utente che al programmatore. Alcuni fra i vantaggi offerti sono: - Una GUI (Graphical User Interface) perfettamente aderente alle linee guida dettate dalla Commodore (User Interface Style Guide) - Tutte le applicazioni `MUI' sono dotate di una application icon (possono, cioé, essere ridotte ad icona) - L'intera interfaccia utente può essere gestita completamente da tastiera (in alternativa al 'solito' mouse) - Tutti gli elementi dell'interfaccia (gadget, testi, listview, ecc...) si adattano automaticamente alle dimensioni della window (quando questa e ridimensionabile) e dei font (che sono SEMPRE a scelta dell'utente). - Moltissimi parametri dell'interfaccia (font, colori, pattern, immagini di background, screen usato, ecc...) sono modificabili DIRETTAMENTE DALL'UTENTE semplicemente utilizzando l'apposito programma di gestione delle preferenze @{" MUI-Prefs " link "MUI-Prefs" 0} fornito con il pacchetto `MUI'. Mi fermo per motivi di spazio (prelevate `MUI' da qualunque BBS ben fornita e leggete l'abbondante documentazione acclusa); voglio solo aggiungere che non avere `MUI' significa anche precludersi la possibilità di usare tutti quei programmi che ne fanno uso (in continuo aumento) fra cui `EasyFR'! @endnode @node "How to install" "EasyFR.guide/Installazione" @next "Let's go!" @prev "About EasyFR" @{b} Installazione@{ub} 1) Installare @{" MUI " link "Magic User Interface" 0} nel vostro sistema. `EasyFR' NON FUNZIONA SENZA 'MUI'. 2) Copiare in una directory a vostra scelta i seguenti files: - EasyFR (eseguibile) - EasyFR.info (icona dell'eseguibile) - EasyFR.sleep.info (icona usata da EasyFR quando viene 'iconificato') - EasyFR.guide (help in linea, questo file: scegliete quello nella lingua desiderata) 3) Creare in questa directory una sottodirectory "C" e copiare al suo interno il file "mouse2" 4) Assegnare EasyFR: alla directory scelata (è consigliabile modificare anche il file s:user-startup) 5) Copiare il file catalog (locale/italiano/EasyFR.catalog) in Locale:Catalogs/Italiano. Notare che il supporto alla localizzazione è presente solo a partire dal Workbench 2.1. In mancanza di tale supporto la lingua usata è l'inglese. Inoltre, per un completo funzionamento, è consigliato l'installazione del pacchetto TrapDoor, o almeno della traplist.library; 'EasyFR' utilizza questa libreria per gestire tutte le informazioni dei nodi. L'installazione è completa. Potete in alternativa utilizzare gli script di installazione forniti con l'archivio... :-) EasyFR potrà essere mandato in esecuzione sia da shell digitando 'EasyFR' o 'run EasyFR >NIL: 16 caratteri - Corretto il display dell'indirizzo (spero): alcune volte stampava "½" - Ora stampa gli indirizzi in: se inserite "2:334/21" stampa "2:334/21.0" - EasyFR non salvava il file .REQ quando veniva ridotto ad Icona. Corretto - Tutte le allocazioni di memoria ora sono fatte con i Memory Pools - Se lanciato con un nodo senza una filelist associata, segnalava un messaggio di errore (Non posso aprire la filelist). Corretto - Aggiunto "Informazioni Filelist" nel menu Progetto - Added Riduci ad Icona nel menu Progetto - Aggiunto indicatore di progressione e pulsante di interruzione per la ricerca nella filelist - Aggiunti pulsanti Procedi e Annulla nella finestra Imposta Commento - Agginto supporto per LZX - Nuovo menu "Lista Richiesta". - Aggiunto Salva nel menu Lista Richiesta - Aggiunto Appendi Backup nel menu Lista Richiesta - Aggiunta preconfigurazione totale per la prima volta in cui il programma viene eseguito - Ora è possibile chiamare un nodo con una lista files da richiedere vuota (utile per le BBS multinodo) - Catalogo aggiornato Ulteriori release di questo programma dipendono dal vostro supporto. @endnode @node "Future" "EasyFR.guide/Futuro" @next "Acknowledgements" @prev "History" @{b}Per il futuro...@{ub} Per le prossime release di EasyFR ho intenzione di aggiungere le seguenti funzioni: - Argomenti di linea (per l'esecuzione da CLI); - Interfaccia ARexx completa, in grado di pilotare il programma comple- tamente; - La possibilità di inserire nella QuickList nodi non presenti nella Nodelist (con almeno il numero telefonico per permettere la chiamata al mailer); - La possibilità di effettuare una stima del tempo richiesto per i download; - L'implementazione di altri de-compattatori per la pagina di InBound; - Aggiornamento alla MUI 3.x Qualunque suggerimento è gradito. @endnode @node "Acknowledgements" "EasyFR.guide/Ringraziamenti" @prev "Future" @{b} Ringraziamenti@{ub} I seguenti nomi rappresentano o marchi di fabbrica o il lavoro delle persone o delle ditte elencate: * Amiga e AmigaDOS sono marchi di fabbrica di ESCOM AG * ARexx di William S. Hawes, Wishful Thinking Development Corp. * Fido e FidoNet sono marchi di fabbrica di Tom Jennings, Fido Software. * LhA è Copyright © 1991,92 Stefan Boberg * LZX è Copyright © 1995 Data Compression Technologies * MUI è © Copyright 1993-1994 by Stefan Stuntz * TrapDoor è un marchio di fabbrica registrato di Maximilian Hantsch e Martin Laubach. * TrapList e traplist.library di Maximilian Hantsch e Martin Laubach * XPK e xpkmaster.library © Urban Dominik Mueller e molti altri. Voglio innanzitutto ricordare e ringraziare Angelo Vizzarro per avermi voluto cedere i sorgenti e tutta la documentazione necessaria per continuare lo sviluppo di questo programma. Un sincero ringraziamento a (in ordine alfabetico): - Gino Casavecchia per il suo supporto morale; - Alex Garoli per gli importanti suggerimenti, consigli e chiarimenti; - Marco Losurdo per le Icone ed il Logo; ed ai miei beta tester (in odrine alfabetico): Danilo Aghemo, Fabrizio David, Andrea Vallinotto, Angelo Verdone e Amiga & Technology BBS. per i suggerimenti ed il supporto morale necessario per continuare lo sviluppo di EasyFR 2.1 Un particolare ringraziamento la traduzione francese del catalogo della versione 2.0 a Florent Montheilhet. Un grazie anche a tutti coloro che hanno creduto in me ed in questo mio programma e che si sono registrati Le parti sulla licenza, sulla garanzia e sulle smentite sono state ampiamente copiate dalla documentazione del TrapDoor. Grazie a tutti. EasyFR 2.1 è stato realizzato su Amiga2000/A2630, Kickstart 3.1 (versione 40.63), Workbench 3.1 (versione 40.42) utilizzando il SAS/C Develpment System 6.56. Un ringraziamento va alla SAS Institute per aver realizzato questo compilatore ed alla SAS Institute GmbH (distributori per l'Europa) per la celerità con la quale mi hanno spedito il pacchetto. Per la guida e il sorgente ed stato utilizzato GoldED3.1.3 ©1993-1995 Dietmar Eilert. Grazie anche a lui per il suo favoloso editor. Per la realizzazione della guida è stato ampiamente utilizzato Heddley 1.1 di Edd Dumbill. @endnode