Ticket #1540: README.it

File README.it, 5.2 KB (added by rian@…, 21 years ago)

italian readme

Line 
1COS'E` IL SISTEMA DARWINPORTS
2
3    DarwinPorts e` una infrastruttura per la compilazione e l'installazione
4di software e per la creazione di pacchetti, progettata per abbracciare le
5stesse funzionalita` dei Ports di FreeBSD, mantenendo allo stesso tempo una
6estensibilita` per possibili futuri perfezionamenti.
7
8    DarwinPorts attualmente compila e funziona su MacOS X 10.2 (Darwin 6.0)
9and MacOS X 10.3. Il sistema e` portabile ed e` scritto in TCL con un set
10limitato di estensioni in C.
11
12    La guida ufficiale "DarwinPorts User Guide" e` disponibile su:
13        http://www.opendarwin.org/projects/darwinports/guide/
14
15    Per una documentazione piu` dettagliata riguardo DarwinPorts ed i suoi
16processi interni si puo` consultare il file base/doc/INTERNALS.
17
18    E` bene ricordare che DarwinPorts e` diviso in due componenti.
19Il primo, "Infrastruttura di DarwinPorts", che risiede nella subdirectory base/
20e` l'unico componente base del sistema; il secondo e` "dports", nel quale sono
21incluse tutte le descrizioni del software attualmente portato. Quest'ultimo e`
22opzionale e lo si puo` prelevare su richiesta tramite rete o si puo` usare la
23copia locale (Vedi commenti sul file /etc/ports/sources.conf qui di seguito)
24
25INSTALLAZIONE
26
27        Per piattaforme specifiche leggere il file base/doc/README.platforms.
28
29    Passi:
30
31        1. cd base/
32           ./configure
33                Entrare nella directory base/ directory ed eseguire lo script
34                configure. I parametri opzionali possono essere passati allo
35                script.
36
37        2. make
38                Eseguire 'make' per compilare il software necessario.
39
40        3. sudo make install
41                Eseguire 'sudo make install' per installare DarwinPorts nel
42                proprio sistema.
43
44        4. [opzionale] edit /etc/ports/ports.conf
45                Il file /etc/ports/ports.conf definisce varie opzioni di
46                configurazione per l'infrastruttura DarwinPorts. Se si desidera
47                cambiare il percorso dell'installazione o la posizione nella
48                quale sono salvati i diversi dati dei ports basta modificare
49                le seguenti impostazioni:
50
51                portdbpath - Specifica il percorso dove il sistema dei ports
52                             salvera` i dati specifici.
53                prefix - Specifica la directory dove verra` installato  il nuovo
54                         software.
55
56        5. [opzionale] edit /etc/ports/sources.conf
57                Il file /etc/ports/sources.conf elenca la posizione locale e
58                remota delle gerarchie dei ports. Se l'argomento
59                --with-dports-dir=DIR non e` specificato sullo script
60                ./configure l'albero dei dports (darwinports/dports, la copia
61                dalla quale si installa) di default verra` aggiunto a tale file.
62
63    Tutto il codice necessario e il TCL saranno compilati ed installati come
64    segue:
65        [Mac OS X 10.2] /System/Library/Tcl/darwinports1.0
66        [Mac OS X 10.3] /Library/Tcl/darwinports1.0
67        [FreeBSD] /usr/local/lib/tcl8.3/darwinports1.0
68            - Libreria TCL di interfaccia per il Sistema DarwinPorts
69
70        PREFIX e` settato in /opt/local ma puo` essere cambiato andando nella
71        directory base/ ed eseguendo ./configure specificando manualmente
72        l'argomento --prefix
73
74        $PREFIX/bin/port
75            - Utility a riga di comando per la creazione del software
76        $PREFIX/share/darwinports/
77            - Librerie TCL interne a DarwinPorts
78
79        I file seguenti sono utilizzati per la personalizzazione del sistema:
80
81        /etc/ports/ports.conf
82            - Impostazioni personalizzabili per l'utente
83        /etc/ports/sources.conf
84            - Lista dei sorgenti dei ports (da dove prelevare i dati)
85
86
87USO DEL COMANDO PORT
88
89    Qualora non fosse stato ancora fatto, aggiungere /opt/local/bin al proprio
90path (o $PREFIX/bin nel caso si e` scelto di installare DarwinPorts in un altra
91destinazione)
92
93        Se non si conosce il modo per effettuare tale operazione e si sta usando
94Jaguar (OS X 10.2) basta aggiungere la seguente riga al proprio file ~/.cshrc
95(Si puo` applicare anche se si sta usando tcsh in Panther.)
96
97        set path=($path /opt/local/bin)
98       
99        Coloro che usano Panther (OS X 10.3) possono aggiungere la riga seguente
100al proprio file ~/.profile
101(Si puo` applicare anche se si sta usando bash in Jaguar.)
102
103        export PATH=$PATH:/opt/local/bin
104
105    I cambiamenti avranno effetto solo dopo aver aperto una nuova shell.
106
107    Questo comando crea ed installa un port:
108
109        port install <portname>
110
111    Per cercare un port specifico si può digitare "port search".
112
113        port search vi
114
115    Per una completa documentazione si puo` fare riferimento alle pagine di
116    manuale digitando "man port".
117
118    Usando il comando portall e` possibile prelevare e compilare tutti i ports
119    del sistema. Sostanzialmente possono essere specificati gli stessi
120    argomenti del comando, ma portall opera iterativamente in tutti i ports
121    della directory dports/. Ad esempio, quando si digitera` "make clean" da
122    questa directory, "portall clean" sara` chiamato per fare il clean.
123
124
125CREARE NUOVI PORTS
126
127    Un Ports e` formato da una directory che contiene il Portfile e altri files
128connessi. Al momento i soli files che sono inclusi nei ports sono file di patch
129e questi probabilmente saranno tenuti al minimo.
130
131    Un Portfile e` un file formato da codice TCL valutato da un interprete TCL
132inizializzato dal Sistema DarwinPorts. I Portfiles hanno una sintassi
133estremamente chiara e diretta, permettendo comunque all'autore di utilizzare
134tutte le funzionalita` del TCL dove necessario.
135
136    Un buon inizio e` leggere il file base/doc/exampleport oltre a consultare
137man portfile(7).