=========================================================== == == == A m I n U p v1.0 == == == == (utility di aggiornamento di indici AmiNet) == == == == FREEWARE by Emanuele Bolognesi 1995 == == == =========================================================== AmInUp è FREEWARE, ma non potete distribuire questo programma senza la documentazione allegata, a meno che l'autore non vi abbia autorizzato. Il prodotto non comprende nessuna garanzia, l'autore si assume ogni responsabilità riguardo al suo uso. INTRODUZIONE Questa piccola utility si rivela in realtà molto utile, specialmente se siete soliti stampare i vostri INDICI di AmiNet. Infatti, supponiamo che abbiate scaricato un grosso indice (es. util/INDEX o game/INDEX) e l'abbiate stampato con la vostra favolosa stampante. Poi qualche settimana dopo scaricate di nuovo lo stesso indice, il quale ovviamente sarà stato aggiornato. Che fare? Stampare un'altra volta tutto l'indice, sprecando altro inchiostro e altra carta? Noooo!..... Usate AmInUp, aggiornando la vecchia stampa! USO: AmInUp [SAMEDIRS] [NOTITLE] AmInUp estrae da tutte le linee non presenti in . Così, stampando queste linee potete aggiungere alcune pagine al vecchio indice stampato e averne uno aggiornato! Sì, è vero, l'indice non è più perfettamente in ordine alfabetico, però avete risparmiato tempo e denaro. Ricordate però: AmInUp lavora solo con indici Aminet, non con tutti i file! NOTA PER PRINCIPIANTI: Se non l'avete ancora capito AmInUp va usato dalla CLI (o Shell). AmInUp scrive le linee estratte sullo StandardOutput (cioè le mostra nella finestra della Shell) ma potete ridirigere l'output aggiungendo un '>' alla fine della linea di comando. Esempi: "AmInUp NewIndex OldIndex >PRT:" --> Le linee vengono STAMPATE. "AmInUp NewIndex OldIndex >myfile" --> Viene creato un file (myfile) che contiene le linee estratte. OPZIONI: 1- Se specificate "SAMEDIRS", Aminup non estrae le linee riguardanti directory non elencate in . Ad esempio, se avete un indice di 'game' che elenca queste directories: game/2play, game/demo, game/gag ecc... e quello nuovo ha queste directories: game/2play, game/board, game/demo ecc... , non verrà estratta nessuna linea riguardante 'game/board'. L'utilità di questa opzione è quella di rendere possibile l'aggiornamento di un indice usando un indice più generale. Infatti se avete stampato, diciamo, 'game/shoot/INDEX' e poi avete scaricato un 'game/INDEX' più recente, potete vedere le aggiunte a 'game/shoot' con: AmInUp 'game_INDEX' 'game_shoot_INDEX' SAMEDIRS Solo le linee che contengono "game/shoot" vengono estratte dall'indice dei giochi, e ovviamente solo quelle che non erano nel vecchio indice. 2- Normalmente AmInUp mette una piccola intestazione all'inizio delle righe che scrive; specificando 'NOTITLE', l'intestazione verrà omessa. Come sapete, ogni indice Aminet inizia con due righe di intestazione: " | Contents of the directory 'DIRECTORY' : 'descrizione della directory' |--------------------------------------------------------------------- " L'intestazione di AmInUp è molto simile: " | UpDate of the directory 'DIRECTORY' Date: |--------------------------------------------------------------------- " dove 'DIRECTORY' è il nome della directory il cui indice è ed è presa dall'intestazione di questo file. (Ah! Se non lo sapete, 'update' significa 'aggiornamento'... almeno credo) La data non è scritta, perché AmInUp non può sapere quando avete scaricato il vostro nuovo indice. Se stampate direttamente potete scriverla a mano, oppure se create un file potete aggiungerla con un editor. IMPORTANTE: Come ho già detto AmInUp lavora solo con indici Aminet. La prima cosa che fa è controllare che all'inizio dei due file che gli passate sia presente l'intestazione Aminet (tutte e due le linee), altrimenti vi riporta un errore. L'intestazione che scrive AmInUp viene accettata (ecco il motivo per averla fatta così simile), quindi potete dare in pasto ad AmInUp un ag- giornamento prodotto da lui stesso, ma solo se è presente il titolo. Se vi siete chiesti a cosa può servire usare AmInUp su un aggiornamento, ve lo spiego: se avete stampato un indice del 1 Marzo, poi un aggiornamento fatto da AmInUp del 15 Marzo, e il 31 Marzo scaricate un nuovo indice, per aggiornare la stampa dovete fare 2 operazioni: 1) AmInUp indice_31-Mar indice_1-Mar >FileTemporaneo 2) AmInUp FileTemporaneo Aggiornam_15-Mar >Aggiornam_31-Mar Ovviamente se avete conservato l'indice del 15-Marzo questo non era necessa- rio, bastava fare "AmInUp indice_31-Mar indice_15-Mar". Bene, questo è veramente tutto. AmInUp è un piccolo e semplice programmino, ma io lo trovo molto utile, tant'è che lo uso regolarmente e mi fido ciecamente di lui (l'ho provato e testato, credetemi!). Se avete consigli o trovate dei bug (impossibile..) mandatemi una mail o scri- vetemi. Potete scrivermi anche per farmi i complimenti, ovviamente, o per rin- graziarmi per questo favoloso programma distribuito gratis... Ciao, e viva Amiga! === AUTORE: ===================================== EMANUELE BOLOGNESI indirizzo: Via Marzocco 45 57011 Castelnuovo M. (LI) ITALY e-mail: bolognes@cli.di.unipi.it =================================================