Update the instructions describing how to compile the conformance
[wine] / documentation / README.it
1 1. INTRODUZIONE
2
3 Wine è un programma che permette di eseguire programmi sviluppati per Microsoft
4 Windows (compresi eseguibili DOS, Windows 3.x e Win32) su Unix. E' costituito
5 da un caricatore di programma che carica ed esegue codice binario Microsoft
6 Windows, ed una libreria (chiamata Winelib) che implementa le chiamate alle API
7 Windows usando il loro equivalente Unix e X11. La libreria può essere usata
8 anche per portare codice Win32 in eseguibili Unix nativi.
9 Wine è un free software, rilasciato sotto GNU LGPL; leggi il file LICENSE per i
10 dettagli.
11
12 2. QUICK START
13
14 Ogni volta che si compila dal sorgente, è raccomandabile usare il Wine installer
15 per compilare e installare Wine. Dalla directory di principale del
16 sorgente Wine, esegui:
17
18 ./tools/wineinstall
19
20 Esegui i programmi con "wine [opzioni] programma". Per altre informazioni e
21 risoluzione di problemi, leggi il resto di questo file, la pagina Wine man, i
22 file nella directory documentazione del sorgente Wine (leggi "DOCUMENTAZIONE"),
23 ed in modo particolare la notevole quantità di informazioni che puoi trovare a
24 http://www.winehq.org.
25
26 3. REQUISITI MINIMI DI SISTEMA
27
28 Per compilare ed eseguire Wine, devi avere uno dei seguenti:
29
30         Linux versione 2.0.36 o superiore
31         FreeBSD 4.x o FreeBSD 5-CORRENTE o superiore
32         Solaris x86 2.5 o superiore
33         NetBSD-CORRENTE
34
35 poiché Wine richiede il supporto al Kernel-level thread per essere eseguito,
36 solo i sistemi operativi sopra menzionati sono supportati.
37 Altri sistemi operativi che supportano i kernel threads potranno essere
38 supportati in futuro.
39
40 Informazioni Linux:
41
42 Mentre Linux 2.2.x dovrebbe funzionare, Linux 2.0.x potrebbe funzionare
43 (versioni più vecchie della 2.0.x avevano crash collegati ai thread), è
44 consigliabile quindi avere una versione corrente del Kernel come la 2.4.x.
45
46 Informazioni FreeBSD:
47
48 Assicurati che le opzioni USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG siano abilitate nel
49 Kernel. Altre informazioni si trovano nel ports tree:
50 ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/
51
52 Informazioni Solaris:
53
54 Sarà necessario compilare Wine con l'insieme di tool GNU (gcc, gas, etc.).
55 Attenzione : installare gas *non* significa che questo sarà usato da gcc.
56 E' necessario ricompilare gcc dopo aver installato gas o symblinking cc, così
57 come lo è per ld delle gnu tools.
58
59 Informazioni NetBSD:
60
61 Assicurati che le opzioni USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG siano abilitate nel
62 Kernel.
63
64 File System supportati:
65 Wine dovrebbe poter essere eseguito sulla maggioranza dei file system. Tuttavia,
66 Wine potrebbe non partire se umsdos è usato per la directory /tmp. Alcuni
67 problemi di compatibilità sono stati riportati usando l'accesso ai file
68 attraverso Samba. Inoltre, poiché NTFS può essere usato in maniera sicura solo
69 con accesso di sola lettura per ora, sconsigliamo l'utilizzo del NTFS, poiché i
70 programmi Windows hanno bisogno di avere accesso in scrittura ovunque.
71 Nel caso  di file NTFS, questi vanno copiati in una locazione nella quale si ha
72 accesso in scrittura.
73
74 Requisiti base:
75
76 Deve essere installato anche l'X11 development inclusi i file (chiamato
77 xlib6g-dev in Debian e Xfree86-devel in RedHat).
78
79 Tool di compilazione necessari:
80
81 Su sistemi x86 è richiesta una versione gcc >= a 2.7.2.
82 Versioni più vecchie potrebbero avere dei problemi quando alcuni file vengono
83 compilati con l'ottimizzazione, a causa di problemi con la gestione degli header
84 dei file. Pgcc al momento non funziona con Wine. La causa di questo problema
85 è sconosciuta.
86
87 Chiaramente è necessario anche "make" (più precisamente GNU make).
88
89 E' necessario anche flex versione 2.5 o successiva e bison.
90 Se stai usando una RedHat o Debian, installa i pacchetti Flex e Bison.
91
92 Librerie per supporti opzionali:
93
94 Se vuoi il supporto alla stampa CUPS, installa i pacchetti sia cups che
95 cups-devel.
96
97 Per l'esecuzione automatica della suite di script test, avrai bisogno del
98 supporto della Libperl development header (pacchetto libperl-dev su Debian).
99
100 Nel caso in cui volessi compilare la documentazione da solo, leggi la sezione
101 "DOCUMENTAZIONE".
102
103 4. COMPILAZIONE
104
105 Nel caso in cui si scegliesse di non utilizzare Wineinstall, esegui i seguenti
106 comandi per compilare Wine:
107
108 ./configure
109 make depend
110 make
111
112 Questo compilerà il programma "wine" e numerose librerie e binari di supporto.
113 Il progrmma "wine" carica ed esegue gli eseguibili Windows.
114 La libreria "libwine" ("Winelib") può essere usata per compilare e linkare il
115 codice sorgente Windows sotto Unix.
116
117 Per vedere le opzioni della configurazione della compilazione, esegui
118 ./configure -help.
119
120 Per fare l'aggiornamento ad una nuova versione utilizzando una patch, prima entra
121 nella directory principale dei sorgenti (quella che contiene questo
122 file README). Quindi esegui "make distclean", ed applica la patch alla release con:
123
124         Gunzip -c patch-file | patch -p1
125
126 dove "patch-file" è il nome della patch (qualcosa come Wine-aammgg.diff.gz).
127 Puoi quindi rieseguire "./configure", e quindi eseguire "make depend && make".
128
129 5. SETUP
130
131 Una volta che Wine è stato compilato correttamente, puoi eseguire
132 "make install"; questo installerà gli eseguibili wine, la pagina Wine man, e
133 pochi altri file necessari.
134
135 Non dimenticarti di disinstallare qualsiasi precedente installazione di Wine in
136 conflitto. Prova sia "dpkg -r wine" o "rpm -e wine" o "make uninstall" prima di
137 installare.
138
139 Se vuoi leggere la documentazione fornita con il sorgente Wine, controlla la
140 sezione "DOCUMENTAZIONE".
141
142 Wine ha bisogno di un file di configurazione chiamato "config" nella tua
143 directory ~/.wine. Il formato di questo file è spiegato nella pagina config file
144 man (documentation/wine.conf.man).
145 Il file documentation/samples/config contiene un esempio di file di
146 configurazione che deve essere adattato e copiato nella locazione menzionata in
147 precedenza.
148
149 Controlla l'area Support su http://www.winehq.org/ per altri suggerimenti sulla
150 configurazione.
151
152 Nel caso di errori di caricamento delle librerie
153 (e.g. "Error while loading shared libraries: libntdll.so"), accertati di
154 aggiungere il percorso della directory a /etc/ld.so.conf ed esegui ldconfig come
155 root.
156
157 6. ESEGUIRE I PROGRAMMI
158
159 Quando si esegue Wine, si può specificare l'intero percorso dell'eseguibile o
160 solo il nome del file.
161
162 Per esempio: per eseguire Solitario:
163
164         wine sol        (Utilizzando il percorso di ricerca come specificato
165         wine sol.exe      nel file di configurazione per localizzare il file)
166
167         wine c:\\windows\\sol.exe (utilizzando la sintassi DOS)
168         wine /usr/windows/sol.exe (utilizzando la sintassi Unix)
169         wine sol.exe /parameter1 -parameter2 parameter3
170                                   (chiama il programma con dei parametri)
171
172 Nota: il percorso del file può essere aggiunto al percorso quando è fornito un
173 nome intero sulla commandline.
174
175 Wine non è ancora completo, quindi molti programmi potrebbero andare in crash. Se
176 winedbg è settato correttamente in accordo con la documentazione contenuta in
177 documentation/debugger.sgml, sarai mandato all'interno di un debugger così
178 potrai studiare e risolvere il problema.
179 Per maggiori informazioni su come fare ciò, per favore leggi il file
180 documentation/debugging.sgml.
181
182 Dovresti fare un backup di tutti i tuoi file importanti ai quali concedi
183 l'accesso da parte di Wine, oppure creane una speciale copia Wine, poiché si
184 sono verificati dei casi di utenti che hanno riportato la corruzione di file.
185 NON eseguire Explorer, ad esempio, se non hai un backup appropriato, perché a
186 volte rinomina/storpia diverse directory. Anche altre applicazioni MS non sono
187 sicure come ad esempio Messenger, visto che lanciano Explorer in un modo o
188 nell'altro. Queste particolari corruzioni (!$!$!$!$.pfr) possono essere
189 parzialmente corrette utilizzando
190 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
191
192 7. DOCUMENTAZIONE
193
194 Puoi trovare della documentazione (diverse guide per Wine etc.) nella directory
195 documentation/ (a parte quelle disponibili su WineHQ).
196
197 Se vuoi processare i file SGML, puoi eseguire "make doc" nella directory
198 documentation/.
199 Per fare ciò è richiesto il pacchetto di tool sgml (per db2html, db2ps, db2pdf)
200 chiamati:
201
202 Debian:         docbook-utils
203 Mandrake:       sgml-tools-A.B.C-DDmdk
204 SuSE:           docbktls-A.BB.C-DD
205
206 8. PER OTTENERE PIU' INFORMAZIONI
207
208 WWW:    Un gran quantitativo di informazioni messe a disposizione da WineHQ su Wine
209         è disponibile all'indirizzo http://www.winehq.org/: varie guide su Wine,
210         database, identificazione di bug. Questo è probabilmente il miglior punto di
211         partenza.
212
213 FAQ:    Le FAQ di Wine si trovano all'indirizzo http://www.winehq.org/FAQ
214
215 Usenet: Puoi discutere di argomenti collegati a Wine ed ottenere aiuto su
216         comp.emulators.ms-windows.wine.
217
218 Bugs:    Segnala i Bug su Wine Bugzilla all'indirizzo http://bugs.winehq.org
219         per favore cerca nel database di bugzilla per verificare che il tuo problema
220         non sia già stato trovato prima di postare un rapporto su un bug.
221         Puoi anche mandare le segnalazioni sui bug a comp.emulators.ms-windows.wine.
222         Per favore leggi il file documentation/bugs.sgml per verificare quali
223         informazioni sono richieste.
224
225 IRC:     Aiuto online è disponibile nel canale #winehq su irc.freenode.net.
226
227 CVS:    L'albero di sviluppo corrente di wine e' disponibile in CVS. Visita
228         http://www.winehq.org/cvs per ulteriori informazioni.
229
230 Mailing list:
231         Esistono diverse mailing list per gli sviluppatori di Wine; visita
232         http://www.winehq.org/forums per ulteriori informazioni.
233
234 Se aggiungi qualcosa, o correggi un bug, per favore manda una patch (nel formato
235 'diff -u') a wine-patches@winehq.org per essere farlo includere nella prossima release.
236
237 --
238 Alexandre Julliard
239 julliard@winehq.org
240
241 tradotto da:
242 Francesco Di Punzio
243 francesco_dipunzio@virgilio.it
244 se trovi errori nella traduzione per favore segnalali tramite e-mail. Grazie
245 Traduzione aggiornata il 18/01/2004 da Ivan Leo Puoti
246 Potete contatarmi all'indirizzo puoti@inwind.it