documentation/README.fi

   1 1. JOHDANTO
   2
   3 Wine on ohjelma, jonka avulla Windows-ohjelmia (mukaan luettuna DOS-,
   4 Windows 3.x, Win32 ja Win64 -ohjelmat) voi ajaa Unix-järjestelmissä.
   5 Wine koostuu ohjelmanlataajasta, joka lataa ja käynnistää Windowsin
   6 ohjelmatiedostoja, sekä kirjastosta nimeltä Winelib, joka toteuttaa
   7 Windowsin API-kutsuja niiden Unix- ja X11-vastineiden avulla. Kirjaston
   8 avulla voidaan myös kääntää Windows-koodia natiiveiksi Unix-ohjelmiksi.
   9
  10 Wine on vapaa ohjelma, ja se on julkaistu GNU LGPL:n alaisena; lisätietoja
  11 lisenssistä on englanniksi tiedostossa LICENSE.
  12
  13
  14 2. PIKAOPAS
  15
  16 Aja Winen lähdekoodin juurihakemistossa seuraavat komennot:
  17
  18 ./configure
  19 make
  20
  21 Ohjelmat ajetaan komennolla "wine ohjelma". Lisätietoja sekä apua ongelmien
  22 ratkaisemiseen on jäljempänä tässä tiedostossa, Winen man-sivuilla sekä
  23 ennen kaikkea Internetissä osoitteessa http://www.winehq.org/.
  24
  25
  26 3. JÄRJESTELMÄVAATIMUKSET
  27
  28 Winen kääntämiseen tarvitaan jokin seuraavista:
  29
  30   Linuxin versio 2.0.36 tai uudempi
  31   FreeBSD 8.0 tai uudempi
  32   Solaris x86 9 tai uudempi
  33   NetBSD-current
  34   Mac OS X 10.5 tai uudempi
  35
  36 Wine vaatii kerneliltä tuen säikeille. Tämän takia toistaiseksi vain yllä
  37 mainittuja käyttöjärjestelmiä tuetaan; tulevaisuudessa saatetaan lisätä tuki
  38 muillekin käyttöjärjestelmille, joissa on tarvittava tuki säikeille.
  39
  40 Tietoa FreeBSD:lle:
  41   Pääsääntöisesti Wine ei toimi vanhemmilla versioilla kuin FreeBSD 8.0.
  42   Osoitteessa http://wiki.freebsd.org/Wine kerrotaan tästä lisää.
  43
  44 Tietoa Solarikselle:
  45   Wine täytyy luultavasti kääntää GNU-työkaluilla (gcc, gas jne.).
  46   Varoitus: vaikka gas olisi asennettu, ei ole varmaa, että gcc käyttää sitä;
  47   voi olla tarpeen joko kääntää gcc uudestaan tai luoda symboliset linkit
  48   ohjelmista "cc", "as" ja "ld" vastaaviin GNU-työkaluihin.
  49
  50 Tietoa NetBSD:lle:
  51   USER_LDT, SYSVSHM, SYSVSEM ja SYSVMSG täytyy aktivoida kernelistä.
  52
  53 Tietoa Mac OS X:lle:
  54   Winen onnistuneeseen kääntämiseen x86:lla tarvitaan Xcode 2.4 tai uudempi.
  55   Mac-ajuri vaatii OS X 10.6:n tai uudemman, ja sitä ei käännetä 10.5:ssä.
  56
  57
  58 Tuetut tiedostojärjestelmät:
  59   Wine toimii useimmilla tiedostojärjestelmillä, mutta Samban kanssa on
  60   ilmoitettu ilmenevän ongelmia. Myöskään NTFS ei tue kaikkia ominaisuuksia,
  61   joita jotkin ohjelmat vaativat. Natiivin Unix-tiedostojärjestelmän käyttö
  62   on suotavaa.
  63
  64 Perusvaatimukset:
  65   Koneella täytyy olla X11:n kehitystiedostot (Debianissa xlib6g-dev,
  66   Red Hatissa XFree86-devel).
  67
  68   Luonnollisesti myös make (yleensä GNU make) on tarpeen.
  69
  70   Lisäksi tarvitaan flex 2.5.33 tai uudempi sekä bison.
  71
  72 Valinnaisia tukikirjastoja:
  73   configure-skripti näyttää varoituksia, kun valinnaisia kirjastoja puuttuu.
  74   Osoitteessa http://wiki.winehq.org/Recommended_Packages on tietoa, mitkä
  75   paketit ovat hyödyksi. 64-bittisissä järjestelmissä täytyy varmistaa, että
  76   kirjastoista on asennettu 32-bittiset versiot.
  77
  78
  79 4. KÄÄNTÄMINEN
  80
  81 Winen voi kääntää seuraavilla komennoilla:
  82
  83 ./configure
  84 make
  85
  86 Tämä kääntää ohjelman "wine" sekä lukuisia tukikirjastoja ja -ohjelmia.
  87 Ohjelma "wine" lataa ja käynnistää Windows-ohjelmia.
  88 Kirjastoa "libwine" ("Winelib") voidaan käyttää Windows-lähdekoodin
  89 kääntämiseen Unixissa.
  90
  91 Komento './configure --help' näyttää asetuksia ja valintoja, joita
  92 käännösprosessiin voi lisätä.
  93
  94 Lisätietoja on osoitteessa https://wiki.winehq.org/Building_Wine
  95
  96
  97 5. ASENNUS
  98
  99 Kun Wine on käännetty, komento "make install" asentaa Winen sekä sen man-sivut
 100 ja joitakin muita hyödyllisiä tiedostoja.
 101
 102 Ennen asennusta pitää muistaa poistaa aiemmat Winen versiot. Poistamista
 103 voi yrittää komennolla "dpkg -r wine", "rpm -e wine" tai "make uninstall".
 104
 105 Kun Wine on asennettu, voidaan ajaa asetusohjelma "winecfg". Sivustolla
 106 http://www.winehq.org/ kohdassa Support on englanninkielisiä lisäohjeita.
 107
 108
 109 6. OHJELMIEN AJAMINEN
 110
 111 Winelle voi antaa joko ohjelmatiedoston koko polun tai pelkän nimen.
 112
 113 Esimerkiksi Notepad eli Muistio voitaisiin ajaa näin:
 114
 115         wine notepad               (ohjelma yritetään löytää Winen
 116         wine notepad.exe            rekisterissä luetelluista paikoista)
 117
 118         wine c:\\windows\\notepad.exe  (kokonainen DOS-polku)
 119
 120         wine ~/.wine/drive_c/windows/notepad.exe  (kokonainen Unix-polku)
 121
 122         wine notepad.exe readme.txt  (ajetaan ohjelma parametrin kanssa)
 123
 124 Wine ei ole täydellinen, joten on mahdollista, että jotkin ohjelmat kaatuvat.
 125 Siinä tapauksessa komentoriville tulostuu virheloki, joka on syytä liittää
 126 mukaan, jos raportoi virheestä.
 127
 128
 129 7. LISÄTIETOJA
 130
 131 WWW:    Winestä on paljon tietoa WineHQ:ssa, http://www.winehq.org/.
 132         Oppaita, ohjelmatietokanta sekä Bugzilla vikojen listaamiseen.
 133         Täältä kannattaa yleensä aloittaa.
 134
 135 Kysymyksiä:
 136         Sivulle http://www.winehq.org/FAQ on koottu kysymyksiä ja vastauksia.
 137
 138 Wiki:   Wine Wiki on osoitteessa http://wiki.winehq.org/.
 139
 140 Postituslistat:
 141         Winen käyttäjille ja kehittäjille on joitakin postituslistoja,
 142         sivulla http://www.winehq.org/forums kerrotaan niistä lisää.
 143
 144 Virheet:
 145         Ilmoita virheistä Winen Bugzillaan, http://bugs.winehq.org/.
 146         Katso kuitenkin ensin Bugzilla-tietokannasta, onko samasta asiasta
 147         ilmoitettu jo aiemmin.
 148
 149 IRC:    Online-apua voi saada kanavalta #WineHQ palvelimella irc.freenode.net.
 150
 151 Git:    Winen tämänhetkinen kehitysversio on jaossa Git-järjestelmän kautta.
 152         Sivulla http://www.winehq.org/git kerrotaan tästä lisää.
 153
 154
 155 Jos lisäät jotain tai korjaat jonkin virheen, lähetä toki muutoksesi
 156 (mieluiten komennon git-format-patch avulla) listalle wine-patches@winehq.org,
 157 jotta se voidaan lisätä Winen seuraavaan versioon.
 158
 159 --
 160 Alkuperäisen version tekstistä on kirjoittanut
 161 Alexandre Julliard
 162 julliard@winehq.org
 163
 164 Suomeksi kääntänyt
 165 Lauri Kenttä
 166 lauri.kentta@gmail.com