Ticket #2987: README.it.diff

--- README.it   Wed Apr 27 14:31:13 2005
+++ README.it.new       Wed Apr 27 23:50:10 2005
@@ -6,148 +6,137 @@
 estensibilita` per possibili futuri perfezionamenti.
 
     DarwinPorts attualmente compila e funziona su MacOS X 10.2 (Darwin 6.0)
-and MacOS X 10.3. Il sistema e` portabile ed e` scritto in TCL con un set
-limitato di estensioni in C.
+and MacOS X 10.3 (Darwin 7.0). Il sistema e` portabile ed e` scritto in TCL 
+con un set limitato di estensioni in C.
 
     La guida ufficiale "DarwinPorts User Guide" e` disponibile su:
-        http://www.opendarwin.org/projects/darwinports/guide/
+       http://www.opendarwin.org/projects/darwinports/guide/
 
-    Per una documentazione piu` dettagliata riguardo DarwinPorts ed i suoi
-processi interni si puo` consultare il file base/doc/INTERNALS.
+    Per una documentazione piu` dettagliata riguardo i processi interni 
+all'architettura del sistema dei ports, consulta il file base/doc/INTERNALS.
 
-    E` bene ricordare che DarwinPorts e` diviso in due componenti.
-Il primo, "Infrastruttura di DarwinPorts", che risiede nella subdirectory 
-base/
-e` l'unico componente base del sistema; il secondo e` "dports", nel quale 
-sono
-incluse tutte le descrizioni del software attualmente portato. 
-Quest'ultimo e`
-opzionale e lo si puo` prelevare su richiesta tramite rete o si puo` 
-usare la
-copia locale (Vedi commenti sul file /etc/ports/sources.conf qui di seguito)
+    E` bene ricordare che DarwinPorts e` diviso in due componenti: la 
+"darwin" ports infrastructure", che risiede nella subdirectory base/ ed e`
+l'unica componente necessaria del sistema, e la directory "dports", nella 
+quale sono incluse tutte le descrizioni del software attualmente portato. 
+Quest'ultima componente e` opzionale e la si puo` prelevare su richiesta 
+tramite rete o si puo` usare la copia locale. (Leggi la documentazione su 
+${prefix}/etc/ports/sources.conf qui di seguito).
 
 INSTALLAZIONE
 
-        Per piattaforme specifiche leggere il file base/doc/README.platforms.
+       Le istruzioni per l'installazione su piattaforme specifiche sono 
+riportate in base/doc/README.platforms .
 
-    Passi:
+    Passi dell'installzione:
 
-        1. cd base/
+       1. cd base/
            ./configure
-                Entrare nella directory base/ directory ed eseguire lo script
-                configure. I parametri opzionali possono essere passati allo
-                script.
-
-        2. make
-                Eseguire 'make' per compilare il software necessario.
-
-        3. sudo make install
-                Eseguire 'sudo make install' per installare DarwinPorts nel
-                proprio sistema.
-
-        4. [opzionale] edit /etc/ports/ports.conf
-                Il file /etc/ports/ports.conf definisce varie opzioni di
-                configurazione per l'infrastruttura DarwinPorts. Se si 
-desidera
-                cambiare il percorso dell'installazione o la posizione nella
-                quale sono salvati i diversi dati dei ports basta modificare
-                le seguenti impostazioni:
-
-                portdbpath - Specifica il percorso dove il sistema dei ports
-                             salvera` i dati specifici.
-                prefix - Specifica la directory dove verra` installato  
-il nuovo
-                         software.
-
-        5. [opzionale] edit /etc/ports/sources.conf
-                Il file /etc/ports/sources.conf elenca la posizione 
-locale e
-                remota delle gerarchie dei ports. Se l'argomento
-                --with-dports-dir=DIR non e` specificato sullo script
-                ./configure l'albero dei dports (darwinports/dports, la copia
-                dalla quale si installa) di default verra` aggiunto a 
-tale file.
+               Entra nella directory base/ ed esegui lo script di 
+               configurazione. Puoi passare anche dei parametri opzionali 
+               (leggi sotto).
+
+       2. make
+                Esegui 'make' per compilare il software necessario.
+
+       3. sudo make install
+                Esegui 'sudo make install' per installare DarwinPorts nel
+               sistema.
+
+       4. [opzionale] edit ${prefix}/etc/ports/ports.conf
+                Nel file ${prefix}/etc/ports/ports.conf sono definite varie 
+               opzioni di configurazione per l'infrastruttura DarwinPorts. 
+               Se desideri cambiare i percorsi di installazione oppure la 
+               posizione dove sono contenuti i dati specifici dei vari 
+               ports, modifica le seguenti impostazioni: 
+
+               portdbpath      Specifica il percorso contenente i dati
+                               specifici dei ports. 
+               prefix          Specifica la directory di installazione dei
+                               ports.
+  
+       5. [opzionale] edit ${prefix}/etc/ports/sources.conf
+               Il file ${prefix}/etc/ports/sources.conf elenca la posizione 
+               e locale e remota delle gerarchie dei ports. Se l'argomento
+               --with-dports-dir=DIR non e` stato specificato allo script di
+               configurazione l'albero default dei dports (darwinports/dports, 
+               la copia dalla quale installi) verra` aggiunto a tale file.
 
-    Tutto il codice necessario e il TCL saranno compilati ed installati come
+    Tutto il codice necessario ed il TCL saranno compilati ed installati come
     segue:
-        [Mac OS X 10.2] /System/Library/Tcl/darwinports1.0
-        [Mac OS X 10.3] /Library/Tcl/darwinports1.0
-        [FreeBSD] /usr/local/lib/tcl8.3/darwinports1.0
-            - Libreria TCL di interfaccia per il Sistema DarwinPorts
-
-        PREFIX e` settato in /opt/local ma puo` essere cambiato andando nella
-        directory base/ ed eseguendo ./configure specificando manualmente
-        l'argomento --prefix
-
-        $PREFIX/bin/port
-            - Utility a riga di comando per la creazione del software
-        $PREFIX/share/darwinports/
-            - Librerie TCL interne a DarwinPorts
-
-        I file seguenti sono utilizzati per la personalizzazione del sistema:
-
-        /etc/ports/ports.conf
-            - Impostazioni personalizzabili per l'utente
-        /etc/ports/sources.conf
-            - Lista dei sorgenti dei ports (da dove prelevare i dati)
+       [Mac OS X 10.3] /Library/Tcl/darwinports1.0
+       [Mac OS X 10.2] /System/Library/Tcl/darwinports1.0
+       [FreeBSD] /usr/local/lib/tcl8.3/darwinports1.0
+            - Libreria TCL per l'interfaccia con il Sistema DarwinPorts
+
+       ${prefix} e` settato in /opt/local ma puo` essere cambiato 
+       posizionandosi nella directory base/ ed eseguendo ./configure 
+       specificando manualmente l'argomento --prefix
+
+       ${prefix}/bin/port
+           - Utility a riga di comando per costruire i ports
+       ${prefix}/share/darwinports/
+           - Librerie TCL interne al sistema DarwinPorts
+
+       I file seguenti sono utilizzati per la personalizzazione del sistema:
+
+       ${prefix}/etc/ports/ports.conf
+           - Impostazioni personalizzabili per l'utente
+       ${prefix}/etc/ports/sources.conf
+           - Lista dei sorgenti dei ports (luoghi da dove prelevare i dati)
 
 
 USO DEL COMANDO PORT
 
-    Qualora non fosse stato ancora fatto, aggiungere /opt/local/bin al 
-proprio
-path (o $PREFIX/bin nel caso si e` scelto di installare DarwinPorts in un 
-altra
-destinazione)
-
-        Se non si conosce il modo per effettuare tale operazione e si sta 
-usando
-Jaguar (OS X 10.2) basta aggiungere la seguente riga al proprio file ~/.cshrc
-(Si puo` applicare anche se si sta usando tcsh in Panther.)
+    Se non l'hai ancora fatto, aggiungi /opt/local/bin al tuo path (oppure 
+${prefix}/bin nel caso in cui hai scelto di installare DarwinPorts in un'altra
+destinazione).
+
+       Se non sai come effettuare questa operazione e stai utilizzando 
+Panther (OS X 10.3), aggiungi la seguente riga al file ~/.profile . Se il file 
+non esiste, crealo. (Questa modifica e` necessaria anche se stai utilizzando
+una bourne shell su Jaguar.)
+
+       export PATH=$PATH:/opt/local/bin
+
+       Se invece stai utilizzando Jaguar (OS X 10.2), aggiungi la seguente
+riga al file ~/.cshrc . Se il file non esiste, crealo. (Questa modifica e`
+necessaria anche se stai utilizzando tcsh su Panther.)   
 
-        set path=($path /opt/local/bin)
+       set path=($path /opt/local/bin)
         
-        Coloro che usano Panther (OS X 10.3) possono aggiungere la riga 
-seguente
-al proprio file ~/.profile
-(Si puo` applicare anche se si sta usando bash in Jaguar.)
-
-        export PATH=$PATH:/opt/local/bin
-
     I cambiamenti avranno effetto solo dopo aver aperto una nuova shell.
 
-    Questo comando crea ed installa un port:
+    Il seguente comando crea ed installa un port:
 
-        port install <portname>
+       port install <portname>
 
-    Per cercare un port specifico si puo` digitare "port search".
+    Per cercare un port specifico puoi digitare "port search".
 
         port search vi
 
-    Per una completa documentazione si puo` fare riferimento alle pagine di
-    manuale digitando "man port".
+    Per una completa documentazione puoi fare riferimento alle pagine di
+manuale del comando port(1).
 
-    Usando il comando portall e` possibile prelevare e compilare tutti i 
-ports
-    del sistema. Sostanzialmente possono essere specificati gli stessi
-    argomenti del comando, ma portall opera iterativamente in tutti i ports
-    della directory dports/. Ad esempio, quando si digitera` "make clean" da
-    questa directory, "portall clean" sara` chiamato per fare il clean.
+    E` anche possibile effettuare operazioni su tutti i ports presenti nel
+sistema utilizzando il comando portall. Sostanzialmente possono essere 
+specificati gli stessi argomenti del comando port, ma portall opera 
+ricorsivamente su tutti i ports presenti in dports/ .
 
 
 CREARE NUOVI PORTS
 
-    Un Ports e` formato da una directory che contiene il Portfile e altri 
-files
-connessi. Al momento i soli files che sono inclusi nei ports sono file di 
-patch
-e questi probabilmente saranno tenuti al minimo.
-
-    Un Portfile e` un file formato da codice TCL valutato da un 
-interprete TCL
-inizializzato dal Sistema DarwinPorts. I Portfiles hanno una sintassi
-estremamente chiara e diretta, permettendo comunque all'autore di utilizzare
-tutte le funzionalita` del TCL dove necessario.
-
-    Un buon inizio e` leggere il file base/doc/exampleport oltre a consultare
-man portfile(7).
+    Un Port e` formato da una directory che contiene un Portfile e altri 
+files associati ad esso. Al momento i soli files che sono inclusi nei ports 
+sono files di patch, i quali saranno sempre mantenuti in modo tale da non 
+occupare troppo spazio.
+
+    Un Portfile e` un file di codice TCL, valutato da un interprete TCL
+inizializzato dal sistema DarwinPorts. I Portfiles hanno una sintassi
+estremamente chiara e diretta, composta da coppie di chiave/valore, che
+permette all'autore di utilizzare tutte le funzionalita` del TCL dove
+necessario.
+
+    Un buon inizio e` leggere il file base/doc/exampleport e consultare le
+pagine di manuale di portfile(7), oppure la Guida a DarwinPorts all'indirizzo
+http://darwinports.opendarwin.org/docs .