documentation/README-fi.md

   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 ## PIKAOPAS
  15
  16 Aja Winen lähdekoodin juurihakemistossa seuraavat komennot:
  17
  18 ```
  19 ./configure
  20 make
  21 ```
  22
  23 Sitten joko asenna Wine:
  24
  25 ```
  26 make install
  27 ```
  28
  29 Tai aja se käännöshakemistosta:
  30
  31 ```
  32 ./wine notepad
  33 ```
  34
  35 Ohjelmat ajetaan komennolla `wine ohjelma`. Lisätietoja sekä apua ongelmien
  36 ratkaisemiseen on jäljempänä tässä tiedostossa, Winen man-sivuilla sekä
  37 ennen kaikkea Internetissä osoitteessa https://www.winehq.org/.
  38
  39
  40 ## JÄRJESTELMÄVAATIMUKSET
  41
  42 Winen kääntämiseen tarvitaan jokin seuraavista:
  43
  44 - Linuxin versio 2.0.36 tai uudempi
  45 - FreeBSD 12.4 tai uudempi
  46 - Solaris x86 9 tai uudempi
  47 - NetBSD-current
  48 - Mac OS X 10.8 tai uudempi
  49
  50 Wine vaatii kerneliltä tuen säikeille. Tämän takia toistaiseksi vain yllä
  51 mainittuja käyttöjärjestelmiä tuetaan; tulevaisuudessa saatetaan lisätä tuki
  52 muillekin käyttöjärjestelmille, joissa on tarvittava tuki säikeille.
  53
  54 **Tietoa FreeBSD:lle**:
  55   Osoitteessa https://wiki.freebsd.org/Wine on lisätietoa.
  56
  57 **Tietoa Solarikselle**:
  58   Wine täytyy luultavasti kääntää GNU-työkaluilla (gcc, gas jne.).
  59   Varoitus: vaikka gas olisi asennettu, ei ole varmaa, että gcc käyttää sitä;
  60   voi olla tarpeen joko kääntää gcc uudestaan tai luoda symboliset linkit
  61   ohjelmista "cc", "as" ja "ld" vastaaviin GNU-työkaluihin.
  62
  63 **Tietoa NetBSD:lle**:
  64   USER_LDT, SYSVSHM, SYSVSEM ja SYSVMSG täytyy aktivoida kernelistä.
  65
  66 **Tietoa Mac OS X:lle**:
  67   Winen kääntämiseen tarvitaan Xcode Command Line Tools tai Apple cctools.
  68   Vähimmäisversiot ovat clang 3.8, MacOSX10.10.sdk ja mingw-w64 v8.
  69   MacOSX10.14.sdk ja myöhemmät sopivat vain wine64:n kääntämiseen.
  70
  71 **Tuetut tiedostojärjestelmät**:
  72   Wine toimii useimmilla tiedostojärjestelmillä, mutta Samban kanssa on
  73   ilmoitettu ilmenevän ongelmia. Myöskään NTFS ei tue kaikkia ominaisuuksia,
  74   joita jotkin ohjelmat vaativat. Natiivin Unix-tiedostojärjestelmän käyttö
  75   on suotavaa.
  76
  77 **Perusvaatimukset**:
  78   Koneella täytyy olla X11:n kehitystiedostot (Debianissa xorg-dev,
  79   Red Hatissa libX11-devel).
  80   Luonnollisesti myös make (yleensä GNU make) on tarpeen.
  81   Lisäksi tarvitaan flex 2.5.33 tai uudempi sekä bison.
  82
  83 **Valinnaisia tukikirjastoja**:
  84   configure-skripti näyttää varoituksia, kun valinnaisia kirjastoja puuttuu.
  85   Osoitteessa https://wiki.winehq.org/Recommended_Packages on tietoa, mitkä
  86   paketit ovat hyödyksi. 64-bittisissä järjestelmissä täytyy varmistaa, että
  87   kirjastoista on asennettu 32-bittiset versiot.
  88
  89
  90 ## KÄÄNTÄMINEN
  91
  92 Winen voi kääntää seuraavilla komennoilla:
  93
  94 ```
  95 ./configure
  96 make
  97 ```
  98
  99 Tämä kääntää ohjelman "wine" sekä lukuisia tukikirjastoja ja -ohjelmia.
 100 Ohjelma "wine" lataa ja käynnistää Windows-ohjelmia.
 101 Kirjastoa "libwine" ("Winelib") voidaan käyttää Windows-lähdekoodin
 102 kääntämiseen Unixissa.
 103
 104 Komento `./configure --help` näyttää asetuksia ja valintoja, joita
 105 käännösprosessiin voi lisätä.
 106
 107 Lisätietoja on osoitteessa https://wiki.winehq.org/Building_Wine
 108
 109
 110 ## ASENNUS
 111
 112 Kun Wine on käännetty, komento `make install` asentaa Winen sekä sen man-sivut
 113 ja joitakin muita hyödyllisiä tiedostoja.
 114
 115 Ennen asennusta pitää muistaa poistaa aiemmat Winen versiot. Poistamista
 116 voi yrittää komennolla `dpkg -r wine`, `rpm -e wine` tai `make uninstall`.
 117
 118 Kun Wine on asennettu, voidaan ajaa asetusohjelma `winecfg`. Sivustolla
 119 https://www.winehq.org/ kohdassa Support on englanninkielisiä lisäohjeita.
 120
 121
 122 ## OHJELMIEN AJAMINEN
 123
 124 Winelle voi antaa joko ohjelmatiedoston koko polun tai pelkän nimen.
 125
 126 Esimerkiksi Notepad eli Muistio voitaisiin ajaa näin:
 127
 128 ```
 129 wine notepad               (ohjelma yritetään löytää Winen
 130 wine notepad.exe            rekisterissä luetelluista paikoista)
 131
 132 wine c:\\windows\\notepad.exe  (kokonainen DOS-polku)
 133
 134 wine ~/.wine/drive_c/windows/notepad.exe  (kokonainen Unix-polku)
 135
 136 wine notepad.exe readme.txt  (ajetaan ohjelma parametrin kanssa)
 137 ```
 138
 139 Wine ei ole täydellinen, joten on mahdollista, että jotkin ohjelmat kaatuvat.
 140 Siinä tapauksessa komentoriville tulostuu virheloki, joka on syytä liittää
 141 mukaan, jos raportoi virheestä.
 142
 143
 144 ## LISÄTIETOJA
 145
 146 - **WWW**: Winestä on paljon tietoa WineHQ:ssa, https://www.winehq.org/.
 147         Oppaita, ohjelmatietokanta sekä Bugzilla vikojen listaamiseen.
 148         Täältä kannattaa yleensä aloittaa.
 149
 150 - **Kysymyksiä**:
 151         Sivulle https://www.winehq.org/FAQ on koottu kysymyksiä ja vastauksia.
 152
 153 - **Wiki**: Wine Wiki on osoitteessa https://wiki.winehq.org/.
 154
 155 - **Gitlab**: Winen kehitykseen voi osallistua sivustolla https://gitlab.winehq.org
 156
 157 - **Postituslistat**:
 158         Winen käyttäjille ja kehittäjille on joitakin postituslistoja,
 159         sivulla https://www.winehq.org/forums kerrotaan niistä lisää.
 160
 161 - **Virheet**:
 162         Ilmoita virheistä Winen Bugzillaan, https://bugs.winehq.org/.
 163         Katso kuitenkin ensin Bugzilla-tietokannasta, onko samasta asiasta
 164         ilmoitettu jo aiemmin.
 165
 166 - **IRC**: Online-apua voi saada kanavalta `#WineHQ` palvelimella irc.libera.chat.