@database Scegli.guide
@$VER: Scegli.guide 39.10 (18.1.99)
@(c) Copyright 1998 Matteo Beccati
@smartwrap
@tab 8

@macro _ipar "@{lindent 4}@{par}"
@macro _opar "@{lindent 0}@{par}"


@node "MAIN" "Scegli.guide"
@{_ipar}
@{b}@{u}Scegli 39.10@{uu}@{ub}@{par}

Copyright © 1998 Matteo Beccati@{par}

Data di rilascio: 18-01-1999@{par}

@{"Introduzione" LINK "Introduzione"}@{line}
@{"Caratteristiche" LINK "Caratteristiche"}@{line}
@{"Informazioni legali" LINK "Informazioni"}@{line}
@{"Richieste di Sistema" LINK "Richieste"}@{line}
@{"Installazione" LINK "Installazione"}@{par}

@{"Uso" LINK "Uso"}@{line}
@{"Configurazione" LINK "Configurazione"}@{par}

@{"Il Futuro" LINK "Futuro"}@{line}
@{"Autore" LINK "Autore"}@{line}
@{"Program history" LINK "History"}@{_opar}

@{i}Nota: @{ui}Questo manuale necessita di AmigaGuide version 40 o più recente
per essere visualizzata correttamente. Il manuale dovrebbe comunque essere leggibile anche
con versioni precedenti.@{par}
@ENDNODE

@NODE "Introduzione" "Scegli.guide/Introduzione"
@{_ipar}
@{b}@{u}Introduzione@{uu}@{ub}@{_opar}

Vi starete chiedendo perché ho deciso di creare un bootmenu visto che ce ne sono
così tanti disponibili? Semplicemente perché non sono come li volevo io...@{par}

Parecchio tempo fa usavo due programmi all'avvio della startup-sequence: un programma,
di cui non ricordo il nome, che testava i tasti del mouse, e uno chiamato @{i}The
Choice @{ui} che faceva apparire una schermata molto simile a quella di @{i}Scegli @{ui}
per scegliere lo script da lanciare.@{par}

Allora ho deciso di creare un programma che integrasse entrambi le funzioni suddette.
Ora però @{i}Scegli @{ui}ha molte @{"caratteristiche" LINK "Caratteristiche"} in più di quante
ne potessi desiderare all'inizio! :-)@{par}
@ENDNODE

@NODE "Caratteristiche" "Scegli.guide/Caratteristiche"
@{_ipar}
@{b}@{u}Caratteristiche@{uu}@{ub}@{_opar}

@{i}Scegli @{ui}è nato per essere usato come bootmenu che appare solo alla pressione
del tasto sinistro del mouse e per caricare una startup-sequence alternativa alla pressione
del tasto destro, ma nulla vieta di usarlo anche a sistema operativo caricato perché:@{line}
 - la funzione di controllo del mouse è opzionale;@{line}
 - può usare il file di configurazione desiderato in ogni momento;@{line}
 - può essere lanciato da Workbench ed è configurabile via tooltype.@{par}

Il bootmenu di @{i}Scegli @{ui}può contenere una schermata intera di pulsanti, ma, per rendere 
più leggibile il tutto, può essere diviso in varie categorie con un nome a scelta.
Ad esempio: Giochi, Grafica, Startup...@{par}

Lo schermo del bootmenu può essere aperto in qualsiasi modo video (PAL, dblPAL, CyberGFX...).@{par}

E' possibile anche scegliere il carattere dello schermo e dei pulsanti.@{par}

Per entrambe le funzioni è possibile far apparire un requester standard ASL per effettuare la scelta.@{par}

Può lanciare sia script che comandi e può essere configurato in modo da ritornare al menu al termine
dell'operazione scelta.@{par}

Infine @{i}Scegli @{ui}è completamente localizzato, anche se usato prima dell'inizializzazione del sistema.@{par}
@ENDNODE

@NODE "Informazioni" "Scegli.guide/Informazioni Legali"
@{_ipar}
@{b}@{u}Informazioni Legali@{uu}@{ub}@{_opar}

@{i}Scegli @{ui} è distribuito tramite il concetto di Freeware. Ciò vuol dire che
è possibile redistribuire copie dell'archivio solo se esso è completo
e ha subito modifiche. Lo scompattamento e il ricompattamento con un
altro programma di archiviazione non è considerato modificazione solo se
tutti i file, compresi i nomi sono lasciati intatti.@{par}

@{i}Scegli @{ui} è distribuito senza alcuna garanzia. L'autore declina ogni responsabiltà
sui danni di qualsiasi tipo causati dall'uso dello stesso. Chi usa questo
programma lo fa a proprio rischio e pericolo.@{par}

@ENDNODE

@NODE "Richieste" "Scegli.guide/Richieste di Sistema"
@{_ipar}
@{b}@{u}Richieste di Sistema@{uu}@{ub}@{_opar}

@{i}Scegli @{ui} necessita di Kickstart 3.0 o superiore per funzionare, quindi utilizza alcune
le risorse disponibili nel Workbench 3.0 (o superiore), come 'asl.library' e 'diskfont.library'.@{par}

E' consigliabile inoltre un avere un disco rigido, anche perché non avrebbe
molto senso usarlo altrimenti...@{par}
@ENDNODE

@NODE "Installazione" "Scegli.guide/Installazione"
@{_ipar}
@{b}@{u}Installazione@{uu}@{ub}@{_opar}

Ancora non esiste uno script di installazione (se lo volete @{"contattatemi" LINK "Autore"} via email).
L'installazione è comunque semplicissima:@{par}

@{u}Per l'uso da Shell:@{uu}@{_ipar}

- Copiare il file 'Scegli' in 'C:';@{line}
- Creare il file 'S:Scegli.config' di @{"configurazione" LINK "Configurazione"};@{line}
- Copiare la directory Catalogs in 'LOCALE:'.@{line}
- Aggiungere la riga 'C:Scegli MOUSE QUIET' (vedi @{"Uso" LINK "Uso"}) prima di 'SetPatch'@{line}
  in 'S:startup-sequence'.@{_opar}

@{u}Per l'uso da Workbench:@{uu}@{_ipar}

- Copiare la directory di @{i}Scegli @{ui}ovunque si voglia.@{_opar}

@{u}Note:@{uu}@{_ipar}
Se si desidera utilizzare @{i}Scegli @{ui}come bootmenu, occorre un ulteriore accorgimento.
Poiché al momento del lancio di @{i}Scegli @{ui}al boot i settaggi e gli assegnamenti non sono ancora
stati fatti, in teoria la localizzazione non sarebbe possibile. Nella versione 39.10 ho implementato
una nuova funzione per ovviare a questo inconveniente; l'unico requisito di cui @{i}Scegli @{ui}ha
bisogno è la variabile 'ENVARC:Language'. Essa dovrebbe esistere a partire dal Workbench 3.1, ma
per chi non avesse il WB 3.1 o non dovesse avere questo file nella propria configurazione, è molto
semplice crearlo da Shell con questi comandi:@{par}

- SetEnv Language "<lingua desiderata>"@{line}
  dove <lingua desiderata> è italiano, english, deutsch etc...@{line}
- Copy ENV:Language ENVARC:@{_opar}

@ENDNODE

@NODE "Uso" "Scegli.guide/Uso"
@{_ipar}
@{b}@{u}Uso@{uu}@{ub}@{_opar}

@{i}Scegli @{ui} può essere lanciato da Shell o da Workbench.@{par}

In caso di lancio da Workbench non tutti gli argomenti possono essere specificati.@{_ipar}

@{b}Argomenti stringa:@{ub}@{line}
@{"CONFIG" LINK "arg_config"}            File di configurazione.@{line}
@{"FONT" LINK "arg_font"}              Nome del font da utilizzare.@{line}
@{"MODEID" LINK "arg_modeid"}            Modo video da utilizzare.@{line}
@{"RMOUSE" LINK "arg_rmouse"}            Script da lanciare se è premuto il tasto destro del mouse.@{par}

@{b}Argomenti numerici:@{ub}@{line}
@{"FONTSIZE" LINK "arg_fontsize"}          Dimensione del font da utilizzare.@{par}

@{b}Argomenti switch:@{ub}@{line}
@{"MOUSE" LINK "arg_mouse"}             Rileva la pressione dei pulsanti del mouse.@{line}
@{"NOEXIT" LINK "arg_noexit"}            Riappare il menu al termine dello script (o comando).@{line}
@{"QUIET" LINK "arg_quiet"}             Disattiva l'output degli errori.@{line}
@{"TOBLACK" LINK "arg_toblack"}           Schermo nero durante l'esecuzione dello script.@{_opar}

Nella mia startup-sequence ad esempio è lanciato così:@{par}

C:Scegli @{"QUIET" LINK "arg_quiet"} @{"RMOUSE" LINK "arg_rmouse"}=SYS:g/ShapeShifter @{"FONT" LINK "arg_font"}=dgsansserif @{"FONTSIZE" LINK "arg_fontsize"}=8 @{"MODEID" LINK "arg_modeid"}=167936@{par}

@ENDNODE

@NODE "Configurazione" "Scegli.guide/Configurazione"
@{_ipar}
@{b}@{u}Configurazione@{uu}@{ub}@{_opar}

Nell'archivio è incluso un esempio di file di configurazione.@{par}

Il simbolo '#' all'inizio di una riga crea una categoria, e deve 
essere tassativamente inserito nella prima riga del file.@{par}

La riga successiva contiene il nome del primo pulsante e quella dopo
ancora lo script da eseguire; se il primo carattere di questa riga è un '+',
@{i}Scegli @{ui} lo eseguirà come comando. Si possono inserire tanti pulsanti quanti
se ne vuole e lo stesso dicasi per le categorie.@{par}

   Esempio:@{par}

<----------------------- INIZIO DEL FILE --------------------------------->@{line}
   #Giochi                    <- Prima riga con categoria (obbligatoria)@{line}
   Alien Breed                <- Primo pulsante@{line}
   Games:AlienBreed/Start     <- Script associato al primo pulsante@{line}
   Zak McCracken              <- Secondo pulsante@{line}
   +Games:Zak/StartZak        <- Comando associato@{line}
   ...                           ecc..@{line}
   ...@{line}
   #Programmi                 <- Seconda categoria@{line}
   LightWave                  <- Primo pulsante della seconda categoria@{line}
   SYS:s/StartLW              <- Script associato@{line}
	...                           ecc...@{line}
<------------------------ FINE DEL FILE ---------------------------------->@{par}

@ENDNODE

@NODE "Futuro" "Scegli.guide/Il Futuro"
@{_ipar}
@{b}@{u}Il Futuro@{uu}@{ub}@{_opar}

Se avete qualche suggerimento non esitate a @{"contattarmi" LINK "Autore"}!@{par}

@ENDNODE

@NODE "Autore" "Scegli.guide/Autore"
@{_ipar}
@{b}@{u}Autore@{uu}@{ub}@{_opar}

Se vuoi contattarmi per qualsiasi motivo (bug report, idee nuove, regali, CyberstormPPC... :) usa
questi indirizzi:@{_ipar}

Matteo Beccati@{line}
Via del Castagno, 8@{line}
44100 Ferrara (FE)@{line}
Italy@{par}

email:  ciaccia@writeme.com@{_opar}

@ENDNODE

@NODE "History" "Scegli.guide/Program History"
@{_ipar}
@{b}@{u}Program History@{uu}@{ub}@{_opar}

Scegli 39.10:    - Aggiunta opzione TOBLACK;@{line}
                 - Aggiunta localizzazione anche se usato prima dell'assegna-@{line}
                   mento di LOCALE: e del lancio di iPrefs;@{line}
                 - Eliminata la richiesta dell'assegnamento ENV: se non@{line}
                   disponibile;@{par}

Scegli 39.9:     - Prima release pubblica.@{par}

@ENDNODE

@NODE arg_config "Scegli.config/Uso/CONFIG"
@{_ipar}
@{b}@{u}Config@{uu}@{ub}@{_opar}

Qui puoi specificare la @{"configurazione" LINK "Configurazione"} da utilizzare.
La parola chiave @{b}CONFIG@{ub} è opzionale.@{par}

Di default è 'S:Scegli.config'.@{par}

@ENDNODE

@NODE arg_font "Scegli.config/Uso/FONT"
@{_ipar}
@{b}@{u}Font@{uu}@{ub}@{_opar}

Qui puoi specificare il nome del font da utilizzare (senza l'estensione '.font').@{par}

Di default è quello utilizzato dal Workbench.@{par}

@{u}Note:@{uu}@{_ipar}
Se non è specificato anche il parametro @{b}FONTSIZE@{ub} viene utilizzata la dimensione minore
esistente per il font.@{_opar}

Vedi anche:@{_ipar}
@{"FONTSIZE" LINK "arg_fontsize"}

@ENDNODE

@NODE arg_modeid "Scegli.config/Uso/MODEID"
@{_ipar}
@{b}@{u}ModeID@{uu}@{ub}@{_opar}

Qui puoi specificare il modo video da utlizzare per lo schermo di @{i}Scegli@{ui}.@{par}

Può essere:@{_ipar}
- un numero intero;@{line}
- un numero esadecimale (se preceduto dal prefisso '$' o '0x');@{line}
- un '?' per aprire il requester dei modi video.@{par}

Di default è quella utilizzata dal Workbench.@{_opar}

@{u}Note:@{uu}@{_ipar}
Si consiglia di utilizzare il prgramma @{i}GetModeID @{ui}di M. Holmgren per
avere i numeri dei modi video.@{_opar}

@ENDNODE

@NODE arg_rmouse "Scegli.config/Uso/RMOUSE"
@{_ipar}
@{b}@{u}RMouse@{uu}@{ub}@{_opar}

Qui puoi specificare uno script da lanciare se il tasto destro del mouse è premuto
all'avvio del programma.@{par}

Di default non viene lanciato alcuno script.@{_opar}

@{u}Note:@{uu}@{_ipar}
Se è specificato, viene abilitata automaticamente l'opzione @{b}MOUSE@{ub}.@{par}
Non può essere specificato da Workbench.@{_opar}

Vedi anche:@{_ipar}
@{"MOUSE" LINK "arg_mouse"}

@ENDNODE

@NODE arg_fontsize "Scegli.config/Uso/FONTSIZE"
@{_ipar}
@{b}@{u}Fontsize@{uu}@{ub}@{_opar}

Qui puoi specificare la dimensione del font da utlizzare.@{par}

Di default è quella utilizzata dal Workbench.@{par}

@{u}Note:@{uu}@{_ipar}
Se non è specificato anche il parametro @{b}FONT@{ub} non ha alcun effetto.@{_opar}

Vedi anche:@{_ipar}
@{"FONT" LINK "arg_font"}

@ENDNODE

@NODE arg_mouse "Scegli.config/Uso/MOUSE"
@{_ipar}
@{b}@{u}Mouse@{uu}@{ub}@{_opar}

Se l'opzione è stata specificata, @{i}Scegli @{ui}mostra il menu solo se il tasto sinistro del mouse è premuto
all'avvio del programma.@{par}

@{u}Note:@{uu}@{_ipar}
Non può essere specificato da Workbench.@{_opar}

Vedi anche:@{_ipar}
@{"RMOUSE" LINK "arg_rmouse"}

@ENDNODE

@NODE arg_noexit "Scegli.config/Uso/NOEXIT"
@{_ipar}
@{b}@{u}NoExit@{uu}@{ub}@{_opar}

Se l'opzione è stata specificata, @{i}Scegli @{ui}ritorna al menu al termine dell'esecuzione dello
script o del comando.@{par}

@ENDNODE

@NODE arg_quiet "Scegli.config/Uso/QUIET"
@{_ipar}
@{b}@{u}Quiet@{uu}@{ub}@{_opar}

Se l'opzione è stata specificata, @{i}Scegli @{ui}non produce output per i messaggi d'errore.@{par}

@{u}Note:@{uu}@{_ipar}
Questo vale anche per gli script e i comandi lanciati (se @{i}Scegli @{ui}è invocato da Shell).@{par}

@ENDNODE

@NODE arg_toblack "Scegli.config/Uso/TOBLACK"
@{_ipar}
@{b}@{u}ToBlack@{uu}@{ub}@{_opar}

Se l'opzione è stata specificata, lo schermo diventa nero dopo la pressione di un pulsante;
così si evita di mostrare l'antiestetico schermo Workbench durante il boot.@{par}

@{u}Note:@{uu}@{_ipar}
Ovviamente @{i}Scegli@{ui}, così facendo, rimane in memoria per tutta l'esecuzione dello script o del
comando.@{par}
Non può essere specificato da Workbench.@{_opar}

@ENDNODE