Store the windows and system directories as long path names.
[wine.git] / documentation / README.it
blobfa81d8e8a2b56277a8e3f1742c87f708d288deb7
1 1. INTRODUZIONE
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.
12 2. QUICK START
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:
18 ./tools/wineinstall
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.
26 3. REQUISITI MINIMI DI SISTEMA
28 Per compilare ed eseguire Wine, devi avere uno dei seguenti:
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
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.
40 Informazioni Linux:
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.
46 Informazioni FreeBSD:
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/
52 Informazioni Solaris:
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.
59 Informazioni NetBSD:
61 Assicurati che le opzioni USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG siano abilitate nel
62 Kernel.
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.
74 Requisiti base:
76 Deve essere installato anche l'X11 development inclusi i file (chiamato
77 xlib6g-dev in Debian e Xfree86-devel in RedHat).
79 Tool di compilazione necessari:
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.
87 Chiaramente è necessario anche "make" (più precisamente GNU make).
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.
92 Librerie per supporti opzionali:
94 Se vuoi il supporto alla stampa CUPS, installa i pacchetti sia cups che
95 cups-devel.
97 Per l'esecuzione automatica della suite di script test, avrai bisogno del
98 supporto della Libperl development header (pacchetto libperl-dev su Debian).
100 Nel caso in cui volessi compilare la documentazione da solo, leggi la sezione
101 "DOCUMENTAZIONE".
103 4. COMPILAZIONE
105 Nel caso in cui si scegliesse di non utilizzare Wineinstall, esegui i seguenti
106 comandi per compilare Wine:
108 ./configure
109 make depend
110 make
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.
117 Per vedere le opzioni della configurazione della compilazione, esegui
118 ./configure -help.
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:
124         Gunzip -c patch-file | patch -p1
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".
129 5. SETUP
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.
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.
139 Se vuoi leggere la documentazione fornita con il sorgente Wine, controlla la
140 sezione "DOCUMENTAZIONE".
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.
149 Non dimenticarti di aggiungere chiavi di registro vitali applicando winedefault.reg
150 con programs/regedit/. Controlla la directory documentation/ per i dettagli.
152 Controlla l'area Support su http://www.winehq.org/ per altri suggerimenti sulla
153 configurazione.
155 Nel caso di errori di caricamento delle librerie
156 (e.g. "Error while loading shared libraries: libntdll.so"), accertati di
157 aggiungere il percorso della directory a /etc/ld.so.conf ed esegui ldconfig come
158 root.
160 Per verificare la correttezza dell'ambiente di cui hai bisogno per eseguire Wine
161 con successo, puoi eseguire "./tools/winecheck | less".
162 Otterrai un punteggio percentuale che indica la "Correttezza della
163 configurazione di Wine".
164 poiché questo programma è una alpha, anche se non esegue un vero test completo
165 ancora, può essere utilizzato come un primo step di verifica.
167 Controlla la pagina wine.conf man su come passare alla modalità solo testuale
168 se lo desideri.
170 6. ESEGUIRE I PROGRAMMI
172 Quando si esegue Wine, si può specificare l'intero percorso dell'eseguibile o
173 solo il nome del file.
175 Per esempio: per eseguire Solitario:
177         wine sol        (Utilizzando il percorso di ricerca come specificato
178         wine sol.exe      nel file di configurazione per localizzare il file)
180         wine c:\\windows\\sol.exe (utilizzando la sintassi DOS)
181         wine /usr/windows/sol.exe (utilizzando la sintassi Unix)
182         wine - sol.exe /parameter1 -parameter2 parameter3
183                                   (chiama il programma con dei parametri)
185 Nota: il percorso del file può essere aggiunto al percorso quando è fornito un
186 nome intero sulla commandline.
188 Wine non è ancora completo, quindi molti programmi potrebbero andare in crash. Se
189 winedbg è settato correttamente in accordo con la documentazione contenuta in
190 documentation/debugger.sgml, sarai mandato all'interno di un debugger così
191 potrai studiare e risolvere il problema.
192 Per maggiori informazioni su come fare ciò, per favore leggi il file
193 documentation/debugging.sgml.
195 Dovresti fare un backup di tutti i tuoi file importanti ai quali concedi
196 l'accesso da parte di Wine, oppure creane una speciale copia Wine, poiché si
197 sono verificati dei casi di utenti che hanno riportato la corruzione di file.
198 NON eseguire Explorer, ad esempio, se non hai un backup appropriato, perché a
199 volte rinomina/storpia diverse directory. Anche altre applicazioni MS non sono
200 sicure come ad esempio Messenger, visto che lanciano Explorer in un modo o
201 nell'altro. Queste particolari corruzioni (!$!$!$!$.pfr) possono essere
202 parzialmente corrette utilizzando
203 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
205 7. DOCUMENTAZIONE
207 Puoi trovare della documentazione (diverse guide per Wine etc.) nella directory
208 documentation/ (a parte quelle disponibili su WineHQ).
210 Se vuoi processare i file SGML, puoi eseguire "make doc" nella directory
211 documentation/.
212 Per fare ciò è richiesto il pacchetto di tool sgml (per db2html, db2ps, db2pdf)
213 chiamati:
215 Debian:         docbook-utils
216 Mandrake:       sgml-tools-A.B.C-DDmdk
217 SuSE:           docbktls-A.BB.C-DD
219 8. PER OTTENERE PIU' INFORMAZIONI
221 WWW:    Un gran quantitativo di informazioni messe a disposizione da WineHQ su Wine
222         è disponibile all'indirizzo http://www.winehq.org/: varie guide su Wine,
223         database, identificazione di bug. Questo è probabilmente il miglior punto di
224         partenza.
226 FAQ:    Le FAQ di Wine si trovano all'indirizzo http://www.winehq.org/FAQ
228 Usenet: Puoi discutere di argomenti collegati a Wine ed ottenere aiuto su
229         comp.emulators.ms-windows.wine.
231 Bugs:    Segnala i Bug su Wine Bugzilla all'indirizzo http://bugs.winehq.org
232         per favore cerca nel database di bugzilla per verificare che il tuo problema
233         non sia già stato trovato prima di postare un rapporto su un bug.
234         Puoi anche mandare le segnalazioni sui bug a comp.emulators.ms-windows.wine.
235         Per favore leggi il file documentation/bugs.sgml per verificare quali
236         informazioni sono richieste.
238 IRC:     Aiuto online è disponibile nel canale #winehq su irc.freenode.net.
240 CVS:    L'albero di sviluppo corrente di wine e' disponibile in CVS. Visita
241         http://www.winehq.org/cvs per ulteriori informazioni.
243 Mailing list:
244         Esistono diverse mailing list per gli sviluppatori di Wine; visita
245         http://www.winehq.org/forums per ulteriori informazioni.
247 Se aggiungi qualcosa, o correggi un bug, per favore manda una patch (nel formato
248 'diff -u') a wine-patches@winehq.org per essere farlo includere nella prossima release.
251 Alexandre Julliard
252 julliard@winehq.org
254 tradotto da:
255 Francesco Di Punzio
256 francesco_dipunzio@virgilio.it
257 se trovi errori nella traduzione per favore segnalali tramite e-mail. Grazie
258 Traduzione aggiornata il 18/01/2004 da Ivan Leo Murray-Smith
259 Potete contatarmi all'indirizzo puoti@inwind.it