user32: Ignore the bitmap offset if it's not set.
[wine] / documentation / README.ja
1 1. はじめに
2
3 Wineは(DOS、Windows 3.x や Win32 実行可能ファイルを含む)Microsoft
4 WindowsプログラムをUnix上で実行できるようにするプログラムです。
5 Microsoft Windowsバイナリを読み込んで実行するプログラムローダと、
6 UnixやX11同等物を使ってWindows APIの呼び出しを実装する(Winelibと呼ばれる)
7 ライブラリから成ります。ライブラリはWin32のコードをネイティブな
8 Unix実行可能ファイルに移植するのにも使えます。
9
10 Wineはフリーソフトウェアで、GNU LGPLのもとでリリースされています。
11 詳細についてはLICENSEというファイルを参照してください。
12
13
14 2. クイックスタート
15
16 ソースからコンパイルするときにはいつでも、Wineをビルドしインストールするのに
17 Wine Installerを使うことが推奨されます。(このファイル[訳注: README.jaではなく
18 READMEというファイル]を含む)Wineソースのトップレベルディレクトリから、
19 以下を実行してください:
20
21 ./tools/wineinstall
22
23 "wine program"のようにプログラムを実行してください。更なる情報や
24 問題解決については、このファイルの残りの部分、Wineのmanページや、
25 特にhttp://www.winehq.orgで見つかる豊富な情報を読んでください。
26
27
28 3. 要件
29
30 Wineをコンパイルし実行するには、以下のうち一つを持っていなければなりません:
31
32   Linux バージョン2.0.36以上
33   FreeBSD 6.3以降
34   Solaris x86 9以降
35   NetBSD-current
36   Mac OS X 10.4以降
37
38 動作するためにWineにはカーネルレベルのスレッドのサポートが必要なので、
39 以上で触れたオペレーティングシステムだけがサポートされます。
40 カーネルスレッドをサポートする他のオペレーティングシステムは
41 将来サポートされるかもしれません。
42
43 Linux情報:
44   Linux 2.2.xでまだ動作するはずであり、Linux2.0.xでまだ動作する
45   かもしれないとはいえ(古い2.0.xバージョンにはスレッド関連のクラッシュが
46   あります)、2.4.xや2.6.xのような現在のカーネルを使うことが最適です。
47
48 FreeBSD情報:
49   FreeBSD 6.3や7.0より前のバージョン上でWineは次第に正しく動作しなくなるで
50   しょう。FreeBSD 6.3にはWineを実行できるようにするパッチが利用できます。
51   詳細については<http://wiki.freebsd.org/Wine>を参照してください。
52
53 Solaris情報:
54   GNUツールチェーン(gcc、gasなど)でWineをビルドする必要がある可能性が
55   最も高いでしょう。警告 : gccがgasを使うことが、gasをインストールすることに
56   よって保証されるわけでは*ありません*。gasのインストール後にgccを
57   再コンパイルするか、cc、asやldをgnuツールにシンボリックリンクすることが
58   必要だと言われています。
59
60 NetBSD情報:
61   USER_LDT、SYSVSHM、SYSVSEMやSYSVMSGオプションがカーネルで有効になっている
62   かどうかを確認してください。
63
64 Mac OS X情報:
65   x86上で正しくビルドするにはXcode 2.4以上が必要です。
66
67
68 サポートされたファイルシステム:
69   Wineはほとんどのファイルシステム上で動作するはずです。Sambaを通して
70   アクセスしたファイルを使っていくつかの互換性問題が報告されています。同様に、
71   NTFSはいくつかのアプリケーションで必要なすべてのファイルシステム情報を
72   提供しません。ext3のようなネイティブなLinuxファイルシステムを使うことが
73   推奨されます。
74
75 基本的な要件:
76   X11開発includeファイルをインストールする必要があります。
77   (Debianではxlib6g-devでRed HatではXFree86-develと呼ばれます。[訳注: 最近の
78     ディストリビューションでは別のパッケージで置き換えられています])
79
80   もちろん"make"も必要です(大概はGNU make)。
81
82   flexバージョン2.5以降とbisonも必要です。
83
84 オプションのサポートライブラリ:
85   オプションのライブラリがシステム上に見つからなかったときに情報を表示します。
86   インストールすべきパッケージについてのヒントについては
87   http://wiki.winehq.org/Recommended_Packagesを参照してください。
88
89   64ビットプラットフォーム上では、これらのライブラリの32ビットバージョンを
90   インストールするようにしなければなりません; 詳細については
91   http://wiki.winehq.org/WineOn64bitを参照してください。
92
93 4. コンパイル
94
95 wineinstallを使わないことを選択した場合、Wineをビルドするには以下のコマンドを
96 実行してください:
97
98 ./configure
99 make depend
100 make
101
102 これによって"wine"というプログラムと多数のサポートライブラリやバイナリが
103 ビルドされます。"wine"というプログラムはWindows実行可能ファイルを読み込み
104 実行します。"libwine" ("Winelib") というライブラリはUnixのもとでWindowsの
105 ソースコードをコンパイルしリンクするのに使えます。
106
107 コンパイル設定オプションを見るには、./configure --helpを行なってください。
108
109 パッチファイルを使うことで新しいリリースにアップグレードするには、
110 はじめにリリースのトップレベルディレクトリ(このREADME
111 [訳注: README.jaではなくREADME]を含むディレクトリ)にcdしてください。
112 そして"make clean"を行ない、以下のようにしてリリースにパッチを当ててください:
113
114     bunzip2 -c patch-file | patch -p1
115
116 ここで"patch-file"は(wine-1.0.x.diff.bz2のような)パッチファイルの名前です。
117 そうすると"./configure"を再実行でき、"make depend && make"を行なえます。
118
119
120 5. 設定
121
122 いったんWineが正しくビルドされると、"make install"を行なえます。
123 これによりwine実行可能ファイル、Wine manページやいくつかの必要なファイルが
124 インストールされます。
125
126 まず、衝突するあらゆる前のWineインストールをアンインストールするのを
127 忘れないでください。インストール前に"dpkg -r wine"または"rpm -e wine"
128 または"make uninstall"を試してください。
129
130 いったんインストールされると、"winecfg"設定ツールを実行できます。
131 設定のヒントについてはhttp://www.winehq.org/におけるサポート領域を
132 参照してください。
133
134
135 6. プログラムの実行
136
137 Wineを起動するとき、実行可能ファイルのパス全体またはファイル名のみを
138 指定できます。
139
140 例えば、メモ帳を実行するには:
141
142         wine notepad               (設定ファイルで指定された、ファイルを検索
143         wine notepad.exe             するための検索パスを使う)
144
145         wine c:\\windows\\notepad.exe  (DOSファイル名の文法を使う)
146
147         wine ~/.wine/drive_c/windows/notepad.exe  (Unixファイル名の文法を使う)
148
149         wine notepad.exe /parameter1 -parameter2 parameter3
150                                    (パラメータを付けてプログラムを呼ぶ)
151
152 Wineはまだ完成していないので、いくつかのプログラムはクラッシュする
153 かもしれません。そのようなクラッシュでは、問題を調査して修正できるように
154 デバッガに放り込むことになるでしょう。これのやりかたについて詳しくは
155 Wine Developer's Guide(Wine開発者のガイド)のデバッグの節を調べてください。
156
157
158 7. 更なる情報の取得
159
160 WWW:    Wineについてのたくさんの情報がhttp://www.winehq.org/にある
161         WineHQから入手できます。多様なWineガイド、アプリケーションデータベース、
162         バグ追跡。これはおそらく最良の出発点です。
163
164 FAQ:    Wine FAQはhttp://www.winehq.org/FAQにあります
165
166 Usenet: comp.emulators.ms-windows.wine上でWine関連の問題を議論し助けを
167         得られます。
168
169 バグ: http://bugs.winehq.orgにあるWine Bugzillaでバグを報告してください。
170         バグ報告を投稿する前に問題がすでにあるのかどうかを調べるために
171         bugzillaデータベースを検索してください。comp.emulators.ms-windows.wineに
172         バグを投稿することもできます。
173
174 IRC:    irc.freenode.net上のチャンネル#WineHQでオンラインヘルプを利用できます。
175
176 Git:    現在のWine開発ツリーはGitを通して入手できます。
177         詳細についてはhttp://www.winehq.org/site/gitに行ってください。
178
179 メーリングリスト:
180         Wineユーザと開発者のためのいくつかのメーリングリストがあります。
181         詳細についてはhttp://www.winehq.org/forumsを参照してください。
182
183 Wiki:   Wine Wikiはhttp://wiki.winehq.orgにあります
184
185 何かを追加するか、バグを修正するならば、次のリリースに含めるために
186 ('diff -u'形式で)パッチをwine-patches@winehq.orgのリストに送ってください。
187
188 --
189 Alexandre Julliard
190 julliard@winehq.org