<!DOCTYPE linuxdoc PUBLIC "-//XFree86//DTD linuxdoc//EN">

<article>
<!--
<title>README for XFree86 on OS/2
-->
<title>OS/2 における XFree86 に関する README
<author>Holger Veit
<Date>Last modified on: December 12th, 1999
<trans>The X Japanese Documentation Project
<tdate>Last modified on: December 21th, 1999

<toc>

<!--
<sect>Introductory Note about the release 3.3.6
-->
<sect>リリース 3.3.6 に関する最初の注意
<p>

<!--
Before looking into this file, please check for any LATEST.OS2 files
that may come with the binary distribution. Please also check out the
following XFree86/OS2 WWW pages:
-->
このファイルを読む前に、バイナリ配布物に付属している LATEST.OS2 を全て
確認してください。問題があったと騒ぐ前には、以下の XFree86/OS2 の WWW
ページもチェックしてください:
<itemize>
<item><htmlurl name="http://ais.gmd.de/~veit/os2/xf86os2.html" url="http://ais.gmd.de/~veit/os2/xf86os2.html"> 
<item><htmlurl name="http://ais.gmd.de/~veit/os2/xf86bugs.html" url="http://ais.gmd.de/~veit/os2/xf86bugs.html"> 
<item><htmlurl name="http://ais.gmd.de/~veit/os2/x11os2faq.html" url="http://ais.gmd.de/~veit/os2/x11os2faq.html"> 
</itemize>
<!--
before you claim to have found any problems.
-->

<!--
This version of the code is called XFree86/OS2 3.3.6. This is a
bugfix release for 3.3.5 and previous versions which again adds 
hardware support for some newer cards, including AGP 
boards. XFree86-3.3.6 contains all security fixes that were released 
for earlier versions. See the RELNOTES document for details. 
-->
このバージョンのコードは XFree86/OS2 3.3.6 と呼ばれます。これは 
3.3.5 以前のバージョンのバグ修正リリースであり、AGP ボードを含むいくつ
かの新しいカードに対するハードウェアサポートがさらに追加されたものです。
XFree86-3.3.6 は以前のバージョンに対してリリースされたセキュリティ関連
の修正も全て含んでいます。詳しくは RELNOTES ドキュメントを参照してください。

<!--
XFree86/OS2-3.3.6 is a full, unrestricted version which does not
expire, and for which the complete  source code is available. In
contrast to beta versions, we consider this  code as sufficiently
stable for use by an end user. Since there  have been numerous
bugfixes, we recommend this version, even if you had  XFree86/OS2 3.3.x
before and it worked satisfyingly with your hardware. By the time
3.3.6 is released, the older version 3.3 will be withdrawn, and
archives will be updated to this version. There may still be
references  to 3.3 or 3.3.x still in documents; these apply 
to 3.3.6 as well, unless otherwise noted.
-->
XFree86/OS2-3.3.6 は全ての機能を持ち、制限も無く、古くなっていないバー
ジョンで、ソースコードも全て入手可能です。ベータ版とは異なり、このコー
ドはエンドユーザが使う分には十分安定していると考えています。バグがたく
さん修正されているので、今まで XFree86/OS2 3.3.x を使っていて、それが
お使いのハードウェア上でうまく動いていたとしても、このバージョンに移行
することをお勧めします。
3.3.6 がリリースがリリースされたことにより、3.3 系の古いバージョンは引っ
込められ、アーカイブはこのバージョンに更新されるでしょう。このドキュメ
ント中にはまだ 3.3 や 3.3.x についての言及があるかもしれませんが、特に
注意書きが無ければ、これらは 3.3.6 にも当てはまります。

<!--
Previous versions have been tested in a large number of configurations
and have been found to be working, with some bugs left, rather flawlessly.
-->
前のバージョンは多くの機器構成でテストされており、いくつかバグは残って
いますが、ほぼ問題無く動作することがわかっています。

<!--
This release is almost complete (with a few exceptions) regarding
the X11R6.3 ``core'' distribution. A subset of the ``contrib'' distribution
is available from the ported software page 
<htmlurl name="http://ais.gmd.de/~veit/os2/xf86ported.html" url="http://ais.gmd.de/~veit/os2/xf86ported.html"> 
-->
X11R6.3 の「core」配布という点では、このリリースは(例外が少しあります
が)ほぼ完全です。「contrib」配布の一部は移植版ソフトウェアのページ
<htmlurl name="http://ais.gmd.de/~veit/os2/xf86ported.html" url="http://ais.gmd.de/~veit/os2/xf86ported.html"> 
から入手することができます。

<!--
In the past beta testing, it has been found that the software itself
is rather stable and does not damage hardware - provided the user
does not try to push the builtin limits and change certain
configuration parameters which could operate the video hardware out
of specs.
-->
過去のベータテストで、ソフトウェアそのものは比較的安定で、ハードウェア
を壊すことはないことが分かっています。ただし、これはユーザが組み込みの
制限値を越えようとしたり、ビデオハードウェアの仕様外の操作ができる特定
の設定パラメータを変更したりしない場合の話です。

<!--
However,
-->
しかし、
<itemize>
<!--
<item>even with a code we consider stable there is no explicit or implicit 
       warranty that certain code works correctly or works at all
-->
<item>我々が安定と考えているコードについても、あるコードが正しく動作し
たり全て動作するという明示的あるいは暗黙の保証はありません。
<!--
<item>although no damage reports are known, it does not mean that it is
       impossible to damage hardware with this code; some deeply hidden
       bugs may still be present in the software.
-->
<item>マシンを壊したという報告を受けたことはありませんが、これはこのコー
ドでハードウェアを壊すことはありえないということではありません。深くに
潜んだバグがまだソフトウェアに残っているかもしれません。
</itemize>

<!--
It is recommended that you backup essential data of your system before
installing this software, but this should be your general precautions 
before ANY installation. No reports exist that a crashing X server itself
actively destroys or modifies data, but it is possible in rare cases
that the system is left in an unusable state (video display mode garbled
or system unresponsive, not reacting to mouse or keyboard actions).
If you then hard reset or switch off the system, file caches of the operating
system might not be written correctly back to disk, thus causing data loss.
-->
このソフトウェアをインストールする前には、重要なデータをバックアップす
ることをお勧めしますが、これは何をインストールする前にでも一般的に言え
る注意のはずです。X サーバがクラッシュすること自体がデータを壊したり内
容を変えたりしたという報告はありませんが、まれにシステムが不安定な状態
になることがありえます(ビデオ表示モードが壊れたり、システムが反応しな
くなったり、マウスやキーボードの動作に反応しなくなる)。このような場合
にシステムをハードリセットしたり電源を切ると、オペレーティングシステム
のファイルのキャッシュが正しくディスクに書き戻されずに、データが無くなっ
てしまうことがあります。

<!--
<sect>What and Where is XFree86?
-->
<sect>XFree86 とその入手方法について

<p>
<!--
XFree86 is a port of X11R6.3 that supports several versions of
Intel-based Unix.  It is derived from X386 1.2, which was the X server
distributed with X11R5.  This release consists of many new features
and performance improvements as well as many bug fixes.  The release
is available as source patches against the X Consortium X11R6 code, as
well as binary distributions for many architectures.
-->
XFree86 は X11R6.3 を Intel ベースの Unix のいくつかに移植したものです。
XFree86 は元々、 X386 1.2 という X11R5 と一緒に配布されていた X サーバ
でした。このリリースでは新しい機能がたくさん追加され、性能も改善されて
いますし、バグもたくさん修正されています。リリースは X コンソーシアム
の X11R6.3 のソースへのパッチの形でも入手できますし、多くのアーキテク
チャ用のバイナリの形でも入手できます。
<!--
<p>XFree86/OS2 is the name of the implementation of XFree86
on OS/2 based systems.
-->
<p>XFree86/OS2 は OS/2 ベースのシステム用の XFree86 の実装の名前です。

<!--
See the <htmlurl url="COPYRIGHT.html" name="Copyright Notice">.
-->
<htmlurl url="COPYRIGHT.html" name="著作権表示">には目を通しておいてく
ださい。

<!-- 原文でコメントアウト
The sources for XFree86/OS2 are available by anonymous ftp from:

<htmlurl name="ftp.XFree86.org:/pub/XFree86/3.3.6/source"
url="ftp://ftp.XFree86.org/pub/XFree86/3.3.6/source">
--> <!--
XFree86/OS2 のソースは以下の場所から anonymous ftp で入手することがで
きます:

<htmlurl name="ftp.XFree86.org:/pub/XFree86/3.3.6/source"
url="ftp://ftp.XFree86.org/pub/XFree86/3.3.6/source">
-->

<!--
Binaries for OS/2 Warp, Merlin, and Aurora are available from:
<htmlurl name="ftp.XFree86.org:/pub/XFree86/3.3.6/OS2"
url="ftp://ftp.XFree86.org/pub/XFree86/3.3.6/OS2">
-->
OS/2 Warp, Merlin, Aurora 用のバイナリは以下の場所から入手できます:
<htmlurl name="ftp.XFree86.org:/pub/XFree86/3.3.6/OS2"
url="ftp://ftp.XFree86.org/pub/XFree86/3.3.6/OS2">
<p>
<!--
The WWW page
<htmlurl name="http://borneo.gmd.de/~veit/os2/xf86os2.html"
url="http://borneo.gmd.de/~veit/os2/xf86os2.html"> will
usually show more references to FTP or WWW sites to retrieve
sources or binaries.
-->
WWW ページ
<htmlurl name="http://borneo.gmd.de/~veit/os2/xf86os2.html"
url="http://borneo.gmd.de/~veit/os2/xf86os2.html"> には通常、
ソースやバイナリを入手できる FTP サイトや WWW サイトへのリンクがもっと
あるでしょう。
<p>

<!--
Other versions:
-->
他のバージョン:

<!--
XFree86/OS2 will run on all dialects of Warp 3, including Warp "red spine box",
Warp "blue spine box", Warp Connect, Warp Server, and Warp 4.
-->
XFree86/OS2 は Warp 3 の変種全てで動作します。これには
Warp "red spine box", Warp "blue spine box", Warp Connect, Warp
Server, Warp 4 が含まれます。

<!--
For Warp 3 installing fixpack level 17 or later is strongly recommended.
There have been a few reports that the installation of FP26 causes XFree86 
no longer to work, but I am not sure about a real reason. Current fixpacks 
for Warp 3, like FP36, seem to work well also.
-->
Warp 3 の場合、修正パックレベル 17 以降をインストールすることを強くお
勧めします。修正パック 26 をインストールすると XFree86 が動作しなくなっ
てしまうという報告が何件かありますが、本当の理由は確かではありません。
Warp 3 用の最近の修正パック(36 等)では動作するようです。

<!--
Warp 4 may be used with or without the recent public fixpack.
-->
Warp 4 は最近の公式修正パックを使っても使わなくても使えるようです。

<!--
Please check in all cases a LATEST.OS2 file.
-->
いずれの場合も LATEST.OS2 ファイルを確認してください。

<!--
OS/2 2.11 is not supported any longer with this release, due to lack
of a working test environment. Consequently, OS/2 SMP 2.11 is not supported 
either. Warp Server SMP is supported, but SMP does not give significant
advantage, other than the general speedup because of multiple processors 
working. OS/2 versions 1.X are definitely not supported and will never be.
-->
今回のバージョンではもう OS/2 2.11 はサポートされていません。これは動
作テスト環境が無いためです。したがって、OS/2 SMP 2.11 もサポートされて
いません。Warp Server SMP はサポートされていますが、複数のプロセッサが
動作することによる一般的な速度向上以外には、SMP には大きな利点はありま
せん。OS/2 のバージョン 1.X は全くサポートしていませんし、これからサポー
トされることもないでしょう。

<!--
It is possible to build XFree86/OS2 from the sources.  Read about this
in the document OS2.NOTES.
-->
XFree86/OS2 をソースから構築することもできます。こちらについては、
ドキュメント OS2.NOTES をご覧ください。

<!--
<sect>Bug Reports for This Document
-->
<sect>本ドキュメントに対するバグ報告

<p>
<!--
Send email to <em/Holger.Veit@gmd.de/ (Holger Veit) or
<em/XFree86@XFree86.org/ if you have comments or suggestions about
this file and we'll revise it.
-->
このファイルに対するコメントや提案があれば、<em/Holger.Veit@gmd.de/
(Holger Veit) あるいは <em/XFree86@XFree86.org/ まで電子メールを送って
ください井。文書を改訂します。

<!--
<sect>Hardware and Software Requirements
-->
<sect>必要なハードウェアとソフトウェア

<p>
<!--
<sect1>Supported, Required, and Recommended Hardware
-->
<sect1>サポートされているハードウェアと、必要あるいは推奨のハードウェア
<p>
<itemize>
<!--
<item>At least a 486DX33 with 16MB RAM is required. A Pentium or Pentium Pro
       and more main memory is recommended. A 386 or a system with 8MB or less
       memory is an insufficient configuration.
-->
<item>RAM を 16MB 積んだ 486DX33 が少なくとも必要です。メモリをもっと
積んだ Pentium や Pentium Pro が推奨されます。386 やメモリが 8MB 未満
というのは、機器構成としては不十分です。
<!--
<item>There are no specific requirements concerning network cards, disk types,
       or CD ROM equipment; of course the more powerful, the better.
-->
<item>ネットワークカード、ディスクの種類、CD-ROM に関する特別な要件は
ありません。当然ながら、性能は高ければ高いほど良いです。
<!--
<item>Depending on the packages installed, a disk space of 20-55MB on a
       HPFS formatted partition (or a JFS, NFS or ext2fs partition natively 
       allowing long filenames) is required. XFree86/OS2 will not run on FAT partitions.
-->
<item>インストールしているパッケージによって、フォーマット済の HPFS パー
ティション(またはロングファイルネームをネイティブに利用できる
JFS, NFS, ext2fs パーティション)に 20〜55MB のディスク領域が必要です。
XFree86/OS2 は FAT パーティション上では動作しません。
<!--
<item>You need a video card that is supported by XFree86. Refer to the general
       README document for a list of supported cards. Note that the sets
       of video cards supported by XFree86 on one hand and OS/2 on the other 
       hand overlap, but do not match exactly, i.e. the fact that your card
       is supported by OS/2 does not mean it works with XFree86 as well, and
       vice versa. XFree86 does not use the video services of the OS/2
       operating system.
-->
<item>XFree86 がサポートしているビデオカードが必要です。サポートされて
いるカードについては、一般の README を参照してください。注意すべき点と
して、XFree86 がサポートしているビデオカードがあり、OS/2 がサポートし
ているビデオカードがありますが、両者はちょうど一致しているわけではあり
ません。つまり、お使いのカードが OS/2 でサポートされていても、XFree86
でも動作するわけではないということです。その逆も言えます。XFree86 は
OS/2 オペレーティングシステムのビデオサービスを使いません。
</itemize>

<!--
<sect1>Required Software
-->
<sect1>必要なソフトウェア

<p>
<itemize>
<!--
<item>Any version of Warp 3 with at least fixpack 17, or Warp 4 is required
-->
<item>少なくとも修正パック 17 が当たっている全てのバージョンの Warp3
あるいは Warp 4 が必要です。
<!--
<item>XFree86/OS2-3.3.6 may use a local named-pipe connection or a TCP/IP 
       based network connection.
-->
<item>XFree86/OS2-3.3.6 はローカルの名前付きパイプ接続か TCP/IP ベース
のネットワーク接続を使うことがあります。
       <enum>
<!--
       <item>Warp comes with the Internet Access Kit (IAK), which is
              sufficient. Warp Connect and Warp Server come with a full
              version of TCP/IP (3.0). Use of this software is preferred over
              IAK then.
-->
<item>Warp は Internet Access Kit (IAK) が付属しています。これがあれば
       大丈夫です。Warp Connect と Warp Server には完全なバージョンの
       TCP/IP (3.0) が付属しています。IAK よりはこちらのソフトウェアを
       使うほうが良いでしょう。
<!--
       <item>Warp 4 comes with TCP/IP 4.0 which should also work.
-->
<item>Warp 4 には TCP/IP 4.0 が付属しており、これも動作するはずです。
<!--
       <item>There are reports that with EMX 0.9 fix 4, you can also use
              the new 32 bit IBM TCP/IP 4.1 product.
-->
<item>EMX 0.9 fix 4 を使うと、新しい 32 ビットの IBM TCP/IP 4.1 という
       製品も使えるという報告があります。
<!--
       <item>The old IBM TCP/IP 2.0, that comes with the IBM PMX product
              may be used with Warp as well, although it is no longer supported
	      by IBM. Please ensure that you have the latest CSDs installed.
-->
<item>IBM の PMX という製品に付属している古い IBM TCP/IP 2.0 も Warp
       で使えるかもしれませんが、IBM はもうこれをサポートしていません。
       最新の CSD がインストールされていることを確認してください。
       </enum>
<!--
       Other versions of TCP/IP, such as FTP's, DEC's, or Hummingbird's 
       TCP/IP versions, as well as IBM TCP/IP 1.X are not supported. Nor does
       any networking support from DOS (packet drivers, winsock), Netware,
       or NetBIOS work, and I won't to provide support for that in the future.
-->
FTP や DEC, Hummingbird 版の TCP/IP など他のバージョンの TCP/IP や IBM
       TCP/IP 1.X はサポートされていません。DOS(パケットドライバや
       winsock), Netware, NetBIOS からのネットワークサポートも動作しま
       せん。作者は将来的にもこれをサポートするつもりはありません。
<!--
<item>If you want to write or port applications for XFree86, you are
       encouraged to do so. You will need a complete installation of
       EMX/gcc 0.9C fix4 or later for doing so. Neither the second (obsolete)
       implementation of gcc, nor any commercial package, including
       Cset/2, VAC++, Borland C++/OS2, Watcom C++, Metaware C, and others,
       is suitable for porting, because various parts of the X DLLs rely
       on certain features only present with EMX.
-->
<item>XFree86 用にアプリケーションを作成・移植しようと考えていれば、ぜ
       ひそうしてください。これを行うには EMX/gcc 0.9C fix4 以降を完全
       にインストールする必要があるでしょう。2番目の(古い)gcc の実装や、
       Cset/2, VAC++, Borland C++/OS2, Watcom C++, Metaware C 等を含む
       商用パッケージはいずれも移植には向いていません。なぜなら、X の
       DLL には、EMX だけが持っている特定の機能に依存している部分が色々
       あるからです。
</itemize>

<!--
<sect>Installing the System
-->
<sect>システムのインストール

<p>
<!--
The binary distribution is composed of a number of zip archives
which are the executables, servers, fonts, libraries, include files,
man pages, and config files.  The full distribution requires about 
40-55MB of disk space.  
-->
バイナリ配布物は、実行ファイル、サーバ、フォント、ライブラリ、インクルー
ドファイル、オンラインマニュアル、設定ファイルが入っているたくさんの
zip アーカイブから構成されています。配布物全体では、ディスク容量を約
40〜50MB 必要とします。

<!--
All archives of this alpha version are packed with the <tt/info-zip/ utility, 
which is available under the name <tt/UNZ512X2.EXE/ (or a later version)
from many OS/2 archives. Please obtain a native OS/2 version of this unpacker.
DOS <tt/PKUNZIP/ does not work, because it cannot unpack long file names and
extended attributes.
-->
このαバージョンの全てのアーカイブは <tt/info-zip/ ユーティリティで圧
縮されています。これは OS/2 のアーカイブの多くから <tt/UNZ512X2.EXE/
(あるいはもっと新しいバージョン)という名前で入手することができます。こ
の展開プログラムは、OS/2 ネイティブのバージョンを入手してください。DOS
版の <tt/PKUNZIP/ は長いファイル名や拡張属性を展開できないため、正しく
動作しません。

<!--
At this moment, the distribution covers only the ``core'' distribution
which somewhat reduces the usability. Refer to WWW sites and archives listed 
in the XFree86/OS2 FAQ and elsewhere to obtain pre-built X clients which
were ported to XFree86.
-->
現時点では、配布物は「コア」配布物だけを対象にしていますが、これだけで
はあまり使いものになりません。XFree86 に移植された構築済の X クライア
ントを入手するには、XFree86/OS2 FAQ で挙げられている WWW サイトやアー
カイブ等を参照してください。

<!--
    The contents of the packages are:
-->
    パッケージの内容を以下に示します:

<descrip>
<!--
<tag/REQUIRED:/
-->
<tag/必須:/
    <descrip>
<!--
    <tag/Xbase/	A special device driver and the SuperProbe program
                <em/Note:/ In order to fix a problem occurring with 
		WSeB (Aurora), you must install the most recent version
		of the xf86sup.sys driver that comes with this file.
		Older versions won't work.
    <tag/Xdoc/	READMEs and XFree86 specific man pages.
    <tag/Xbin/	all of the executable X client applications and shared libs
    <tag/Xfnts/	the misc and 75dpi fonts
    <tag/emxrt/         Runtime libraries of EMX
-->
    <tag/Xbase/	特殊なデバイスドライバと SuperProbe プログラム
<em/注意:/ WSeB (Aurora) で起こる問題を避けるためには、このファイルに
付属している最新バージョンの xf86sup.sys をインストールしなければなり
ません。古いバージョンでは動作しません。
    <tag/Xdoc/	README と XFree86 固有のオンラインマニュアル
    <tag/Xbin/	実行可能な X クライアントアプリケーションと共有ライブラリ全て
    <tag/Xfnts/	misc フォントと 75dpi フォント
    <tag/emxrt/         EMX のランタイムライブラリ
    </descrip>

<!--
    Choose at least one of the following to match your hardware:
-->
    以下の中からハードウェアにあったものを少なくとも 1 つ選択します:

    <descrip>
<!--
    <tag/X8514/	the X server for IBM 8514/A and compatible boards
    <tag/XAGX/	the X server for AGX boards
    <tag/XGlnt/	the X server for Permedia / GLINT boards
    <tag/XI128/	the X server for &num;9 Imagination 128 boards
    <tag/XMa32/	the X server for ATI Mach32 graphics boards
    <tag/XMa64/	the X server for ATI Mach64 graphics boards
    <tag/XMa8/	the X server for ATI Mach8 graphics boards
    <tag/XMono/	the Monochrome X Server
    <tag/XP9K/	the X server for P9000 based boards
    <tag/XS3/ 	the X server for S3 based boards (excluding S3 ViRGE)
    <tag/XS3V/ 	the X server for S3 ViRGE based boards
    <tag/XSVGA/	the 8-bit pseudo-color X server for Super VGA cards
    <tag/XVG16/	the 4-bit pseudo-color X server for VGA &amp; SVGA cards.
    <tag/XW32/	the X server for et4000w32 based boards
-->
    <tag/X8514/	IBM 8514/A とその互換ボード用の X サーバ
    <tag/XAGX/	AGX ボード用の X サーバ
    <tag/XGlnt/	Permedia / GLINT ボード用の X サーバ
    <tag/XI128/	&num;9 Imagination 128 ボード用の X サーバ
    <tag/XMa32/	ATI Mach32 グラフィックスボード用の X サーバ
    <tag/XMa64/	ATI Mach64 グラフィックスボード用の X サーバ
    <tag/XMa8/	ATI Mach8 グラフィックスボード用の X サーバ
    <tag/XMono/	白黒 X サーバ
    <tag/XP9K/	P9000 ベースのボード用の X サーバ
    <tag/XS3/ 	S3 ベースのボード(S3 ViRGE を除く)用の X サーバ
    <tag/XS3V/ 	S3 ViRGE ベースのボード用の X サーバ
    <tag/XSVGA/	Super VGA カード用の 8 ビット pseudo-color X サーバ
    <tag/XVG16/	VGA &amp; SVGA カード用の 4 ビット pseudo-color X サーバ
    <tag/XW32/	et4000w32 ベースのボード用の X サーバ
    </descrip>

<!--
<tag/OPTIONAL:/
-->
<tag/無くても良いもの:/

    <descrip>
<!--
    <tag/Xman/ 	pre-formatted man pages for the X11 interface and clients
    <tag/Xf100/	100dpi fonts
    <tag/Xfscl/	Speedo and Type1 fonts
    <tag/Xfnon/ Japanese, Chinese and other fonts
    <tag/Xfcyr/	Cyrillic fonts
    <tag/Xfsrv/	the font server with man pages.
    <tag/Xprog/	the X11 header files and programmer's utilities
		for compiling other X applications
    <tag/Xpex/	PEX fonts and libraries required for PEX applications
-->
    <tag/Xman/ 	X11 のインタフェースとクライアントに関するフォー
		マット済のオンラインマニュアル
    <tag/Xf100/	100dpi フォント
    <tag/Xfscl/	Speedo フォントと Type1 フォント
    <tag/Xfnon/ 日本語、中国語などのフォント
    <tag/Xfcyr/	キリル文字フォント
    <tag/Xfsrv/	フォントサーバと、そのオンラインマニュアル
    <tag/Xprog/	他の Xアプリケーションをコンパイルするための
		X11 のヘッダファイルとプログラマ向けのユーティリティ
    <tag/Xpex/	PEX アプリケーションに必要な PEX のフォントとライブラリ
    </descrip>
</descrip>

<!--
In order to save space on your disk and reduce net bandwidth, choose the
software to obtain carefully. Each X server is an archive of about 1.2MB
and occupies 3.0MB on the disk. You won't normally need more than the
single Xserver tailored to your video card.
-->
ディスク容量を節約し、ネットワーク転送に必要なバンド幅を減らすため、取
得するソフトウェアは注意深く決めてください。それぞれの X サーバはアー
カイブのサイズは 1.2MB で、ディスク上では 3.0MB の容量を必要とします。
通常は、ビデオボードにあった X サーバ 1 つ以外は必要無いはずです。

<!--
If it is your first time install, get the <tt/Xbase/ archive before any
of the other packages. This package contains a driver and a test program,
which analyzes your video hardware. If this program fails or reports an
incompatible hardware, it makes no sense to obtain the other packages in
the hope that they would magically work.
-->
インストールを初めて行う場合には、他のどのパッケージよりも先に
<tt/Xbase/ アーカイブを入手してください。このパッケージにはドライバ
と、ビデオハードウェアを解析するテストプログラムが入っています。このプ
ログラムが動作しない場合や、利用できないハードウェアであると報告した場
合、奇跡的に動くことを期待して他のパッケージを入手しても無意味です。

<!--
<sect>Troubleshooting
-->
<sect>トラブルシューティング

<p>
<!--
Surprised to see this section directly in the beginning? We have put it here
because chances are best here not to overlook it. This does not mean that
you will necessarily encounter trouble when installing XFree86, but be warned:
the following sections are <bf/IMPORTANT/ and neglecting one or more things
out of impatience or sloppiness will leave you with a non-working X11
system and us with unnecessary problems.
-->
どうしていきなりこのセクションを見ているんですか? これをここに書いてい
るのは、ここならば見落とされない可能性が最も高いからです。XFree86 をイ
ンストールするとあなた必ずトラブルに出会うと言っているわけではないので
すが、警告はしておきます: 以下のセクションは<bf/重要/であり、あわてた
り手を抜いたために怠っていることがあると、あなたにとっては X11 システ
ムが動かないことになりますし、我々にとっては余計な面倒がかかることにな
ります。

<!--
Still, due to the incredibly large number of hardware configurations, there 
may be some special situations and configurations where the below description
is not successful. If this happens, read - I repeat <bf/READ/ - the list
of ``frequently asked questions'' (FAQ) which has meanwhile evolved to
a troubleshooting guide. The latest version is always at
<htmlurl name="http://ais.gmd.de/~veit/os2/x11os2faq.html" url="http://ais.gmd.de/~veit/os2/x11os2faq.html"> .
-->
しかし、信じられないくらいの数の機器構成があるため、以下の説明ではうま
く行かない特殊な状況や機器構成もあると思います。そういう場合には、いつ
の間にかトラブル対処ガイドに発展した「よく聞かれる質問(Frequently
Asked Questions, FAQ)」のリストを読んでください。繰り返しますが、<bf/
必ず読んで/ください。最新版は常に
<htmlurl name="http://ais.gmd.de/~veit/os2/x11os2faq.html" url="http://ais.gmd.de/~veit/os2/x11os2faq.html">
にあります。

<!--
Maybe - but we found you must be very creative - you find a bug. Consult the
page <htmlurl name="http://ais.gmd.de/~veit/os2/xf86bugs.html" url="http://ais.gmd.de/~veit/os2/xf86bugs.html"> 
whether it is already known. If not, you have a case and should report it
to XFree86 (<em/xfree86@xfree86.org/). Please refer to the FAQ about the
information to be provided for a complete problem report.
-->
もしかすると、あなたがバグを見つけたのかもしれません(きっとあなたの想
像力がたくましすぎただけだと思いますが)。その場合には
<htmlurl name="http://ais.gmd.de/~veit/os2/xf86bugs.html" url="http://ais.gmd.de/~veit/os2/xf86bugs.html"> 
を見て、それが既知のものかどうか調べてください。これで見つからなければ、
新しい問題に出会っていることになるので、これを 
XFree86(<em/xfree86@xfree86.org/)に報告してください。ちゃんとした問題
報告を書くための情報が FAQ に用意されているので、これを参照してください。

<!--
The recommended newsgroup for setup questions is <em/comp.os.os2.setup.misc/.
I read this group, so it won't speed up the process or enforce anything if
you post to other groups, or forward the report to my mail address as well
or to xfree86@xfree86.org.
-->
ニュースグループで設定の質問をする時は <em/comp.os.os2.setup.misc/ を
利用してください。筆者はこのニュースグループを読んでいるので、他のニュー
スグループに投稿したり、報告を筆者のメールアドレスや
xfree86@xfree86.org に転送しても、処理は早くなりませんし筆者に何かを強
制できるわけでもありません。

<!--
So, not to discourage you completely, the setup section begins:
-->
さて、あまり読者の皆さんを意気消沈させるわけにもいかないので、設定のセ
クションを始めしょう:

<!--
<sect>Checking Compatibility of Video Hardware
-->
<sect>ビデオハードウェアの互換性のチェック

<p>
<!--
In the following, we assume that you want to install XFree86/OS2 on a disk
drive with the letter Y: (which you probably don't have). Change the letter
in all commands accordingly.
-->
以下の説明では、ドライブレターが Y: (たぶん使っていないと思いますが)で
あるディスクドライブにXFree86/OS2 をインストールしようとしているものと
します。コマンド全てについて、ドライブレターは適切に変更してください。

<enum>
<!--
<item>Obtain the package <tt/Xbase/ and install it from the root directory
       of the Y: drive, by entering the following commands:
-->
<item>パッケージ <tt/Xbase/ を入手し、Y: ドライブのルートディレクト
リからインストールします。インストールでは以下のコマンドを入力します:
<tscreen><verb>
[C:\] Y:
[Y:\] cd \
[Y:\] unzip \path_of_package\Xbase.zip
</verb></tscreen>

<!--
<item>Edit your CONFIG.SYS file to contain the following line somewhere:
-->
<item>CONFIG.SYS ファイルを編集し、以下の行をどこかに追加します:
<tscreen><verb>
DEVICE=Y:\XFree86\lib\xf86sup.sys
</verb></tscreen>
<!--
       Of course replace ``Y:'' with the correct drive letter.
-->
       当然ながら、``Y:'' は正しいドライブレターに置き換えてください。


<!--
<item>At this point, you may consider to add the variables required for
       XFree86/OS2 as well, which will save you from one additional reboot.
       Refer to section <ref id="envvar" name="Adding Variables to CONFIG.SYS">
       below.
-->
<item>この時点で、XFree86/OS2 に必要な環境変数の追加も考えておくとよい
でしょう。これにより余計な再起動の手間が省けます。後述の
<ref id="envvar" name="CONFIG.SYS への環境変数の追加"> セクションを参
照してください。

<!--
<item>After adding the device driver entry to the CONFIG.SYS file, you must
       reboot to install the driver. XFree86/OS2 will not work without this
       driver.
-->
<item>CONFIG.SYS ファイルにデバイスドライバのエントリを追加した後は、
ドライバをインストールするために再起動しなければなりません。
XFree86/OS2 はこのドライバ無しでは動作しません。

<!--
<item>Start a full screen OS/2 CMD session and enter the following
       command:
-->
<item>フルスクリーンの OS/2 CMD セッションを起動し、以下のコマンドを入
力します:
<tscreen><verb>
[C:\] Y:\XFree86\bin\SuperProbe
</verb></tscreen>

<!--
<item>This command will (normally) report important information about your
       video configuration, i.e. the type of chipset, the available video
       memory and the RAMDAC circuit available. Please write this down or
       redirect the output of ``SuperProbe'' into a file by entering:
-->
<item>このコマンドは(通常)ビデオ機器構成に関する重要な情報を報告します。
この情報とは、チップセットの種類、利用可能なビデオメモリ、利用可能な
RAMDAC 回路です。この情報はメモするか、以下のように入力して
``SuperProbe'' の出力をファイルにリダイレクトするかしてください:
<tscreen><verb>
[C:\] Y:\XFree86\bin\SuperProbe >filename
</verb></tscreen>

<!--
<item>SuperProbe can identify many more video cards than are supported by
       XFree86. In some cases, SuperProbe unfortunately detects a wrong
       card, often it claims to have seen a MCGA card which is some sort of
       a fallback. Generally, if it is approximately right, there are only
       few reasons for doubts; if it is totally off (e.g. saying it has
       seen a ET4000, and you have a Cirrus card), you should report a
       mis-detection as a bug to the given address. In all cases, please
       take the few minutes and check the accompanying README.* files to
       check for special precautions, options, or features of the card.
-->
<item>SuperProbe は XFree86 がサポートしているよりもずっと多くのビデオ
カードを識別することができます。しかし残念ながら、SuperProbe がカードを
間違って検出し、フォールバック値の一種である MCGA カードを見つけたと言
うことが時々あります。一般的には、だいたい正しそうならば疑う理由はほと
んどありません。ですが明らかにおかしい場合(Cirrus のカードを使っている
のに ET4000 があると言われる場合など)には、検出ミスを後述のアドレスま
でバグとして報告してください。どんな場合であれ、ちゃんと時間を取って付
属の README.* ファイルを調べ、特別な予備注意、オプション、カードの機能
を確認してください。
<!--
<item>If the README files tell you that your hardware is supported, please
       obtain the rest of the software.
-->
<item>お使いのハードウェアがサポートされていると README ファイルに書か
れていれば、残りのソフトウェアを入手してください。

</enum>

<!--
<sect>Installing the packages
-->
<sect>パッケージのインストール

<p>
<!--
XFree86/OS2 assumes a directory hierarchy starting from <tt>drive:&bsol;XFree86</tt>.
This can be changed, but is strictly discouraged.
-->
XFree86/OS2 は <tt>drive:&bsol;XFree86</tt> から始まるディレクトリ階層
を想定しています。これを変えることもできますが、そうしないことを強くお
勧めします。

<enum>
<!--
<item>Choose a HPFS partition with sufficient free space.
-->
<item>十分な空き容量がある HPFS パーティションを選びます。
<!--
<item>For each package to install, go to the root directory of this
       drive, and type:
-->
<item>インストールするパッケージのそれぞれについて、このドライブのルー
トディレクトリに移動し、以下のコマンドを入力します:
<!--
<tscreen><verb>
drive:> cd \
drive:> unzip \path_of_packages\Xxxxx.zip
</verb></tscreen>
-->
<tscreen><verb>
drive:> cd \
drive:> unzip \パッケージのパス名\Xxxxx.zip
</verb></tscreen>
<!--
<item>You might encounter that some packages report duplicate files, e.g.
the X server packages install corresponding README files, which are also
in the Xdoc package. This is okay, the files are the same. Let unzip
replace the files.
-->
<item>一部のパッケージではファイルが重なっていると報告されるかもしれま
せん。例えば、X サーバのパッケージは対応する README ファイルをインストー
ルしますが、これは Xdoc パッケージにも入っています。これは問題あり
ません。ファイルは同じものです。unzip にファイルを上書きさせてください。
<!--
<item>No special sequence to unpack the files is required.
-->
<item>ファイルを展開するための特別な手順は必要ありません。
</enum>

<!--
<sect>Adding Variables to CONFIG.SYS <label id="envvar">
-->
<sect>CONFIG.SYS への環境変数の追加 <label id="envvar">

<p>
<!--
XFree86/OS2 requires a number of settings in the CONFIG.SYS file to work
correctly. Please add the following settings, and in particular take
care to set forward versus backward slashes correctly:
-->
XFree86/OS2 を正しく動作させるために CONFIG.SYS に必要な設定がたくさん
あります。以下の設定を追加してください。特にスラッシュとバックスラッシュ
は正しく設定するように注意してください:
<descrip>
<tag/TERM/
<!--
	Set the preferred terminal type for the xterm or editor to be used.
	Some programs need this setting. I have my type set to
-->
xterm や使用するエディタに合わせて端末のタイプを設定します。この設定が
必要なプログラムがいくつかあります。筆者は次のように設定しています:
<tscreen><verb>SET TERM=ansi</verb></tscreen>
<!--
	<tt>&bsol;XFree86&bsol;lib&bsol;X11&bsol;etc&bsol;termcap.x11</tt>
	contains a suitable termcap which
	can be used in place of termcap files that come with EMX, EMACS, or
	other ported software.
-->
<tt>&bsol;XFree86&bsol;lib&bsol;X11&bsol;etc&bsol;termcap.x11</tt>
EMX, EMACS やその他の移植ソフトウェアに付属している termcap ファイルの
代わりに使うことができる適切な termcap が入っています。
<tag/TERMCAP/
<!--
	This variable must be set to the location where the termcap file
	used for the above <tt/TERM/ variable is searched. My setting, for
	instance, is:
-->
この変数には、前項の <tt/TERM/ 環境変数が検索される termcap ファイルの
位置を設定しなければなりません。例えば、筆者の設定は以下のようになって
います:
<tscreen><verb>SET TERMCAP=D:/EMX/ETC/TERMCAP.X11</verb></tscreen>
<!--
	Note that forward ``/'' is used as a directory separator.
-->
ディレクトリの区切りにはバックスラッシュではなく普通の ``/'' を使う点
に注意してください。
<tag/ETC/
<!--
	Set to an ETC directory. Normally, this is already set to the ETC
        directory of the TCP/IP code, such as
-->
ETC ディレクトリを設定します。通常、これは以下のように TCP/IP コードの
ETC ディレクトリに設定されています:
<tscreen><verb>SET ETC=C:&bsol;TCPIP&bsol;ETC</verb></tscreen>
<!--
	For Warp 4 and later, this may point to the <tt/&bsol;MPTN&bsol;/
	directory. This is okay.
-->
Warp 4 以降では、これは <tt/&bsol;MPTN&bsol;/ ディレクトリを指していて
も構いません。これでOKです。
<tag/TMP/
<!--
	Set to an TMP directory which should reside on a HPFS drive
	(or other filesystem that has real long names). Often, 
	this variable is already set to the TMP directory of the 
	TCP/IP code, such as
-->
TMP ディレクトリを設定します。TMP ディレクトリは HPFS ドライブ(または
本物のロングファイルネームが使えるファイルシステム)上になければなりま
せん。多くの場合、これは既に以下のように TCP/IP コードの TMP ディレク
トリに設定されています:
<tscreen><verb>SET TMP=C:&bsol;TCPIP&bsol;TMP</verb></tscreen>
<!--
	If you have installed additional software, like VisualAge for C++,
	it might be that this variable points to some directory <tt/&bsol;ibmcpp&bsol;tmp/ .
-->
VisualAge for C++ といったソフトウェアを追加インストールしている場合に
は、この変数は <tt/&bsol;ibmcpp&bsol;tmp/ 等のディレクトリを指している
かもしれません。
<tag/HOSTNAME/
<!--
	Set to the internet hostname. Normally, this is already set by the
	TCP/IP installation program, such as
-->
インターネットのホスト名を設定します。通常は TCP/IP のインストールプロ
グラムが既に以下のように設定しています。
<tscreen><verb>SET HOSTNAME=myhost</verb></tscreen>
<!--
	With IAK, you would normally run a loopback configuration 
	<ref id="loopback" name="Network configuration"> and would then
	set this to
-->
IAK では、通常はループバック設定(<ref id="loopback" name="Network configuration">
を参照)で実行されるので、設定は以下のようにします:
<tscreen><verb>SET HOSTNAME=localhost</verb></tscreen>
<tag/USER/

<tag/LOGNAME/
<!--
	Set both to a username. Currently, they are there just to make some
	programs happy; in the future, this variable might be set by a
	login shell of a multiuser configuration. My variable, for instance,
	is set to
-->
両方にユーザ名を設定します。現在のところは、これを行うと一部のプログラ
ムで嬉しいことがあります。将来的には、この変数はマルチユーザ設定のログ
インシェルで設定できるようになるかもしれません。例えば、筆者の設定は以
下のようになっています:
<tscreen><verb>
        SET USER=holger
        SET LOGNAME=holger
</verb></tscreen>
<tag/HOME/
<!--
	Set this to an existing directory that is supposed to be a home directory
	of a user. Some utilities place temporary and init files here. This
	is also future investment for a multiuser configuration, but must still
	be there. For instance, this variable might be set to
-->
この変数には、ユーザのホームディレクトリと考えられている既存のディレク
トリを設定します。一部のユーティリティはテンポラリファイルや初期化ファ
イルをここに置きます。これもマルチユーザ設定向けの将来の開発項目ですが、
その時でも残っているはずです。例えば、この変数は以下のように設定します:
<tscreen><verb>SET HOME=H:&bsol;user&bsol;holger</verb></tscreen>
<tag/X11ROOT/
<!--
	This is one of the most important settings, it determines the root
	of the XFree86 directory tree. Normally, you will set this to the
	drive letter of the partition where the &bsol;XFree86 tree resides,
	such as in
-->
これは最も重要な設定の 1 つであり、XFree86 のディレクトリツリーのルー
トを決めます。通常は、この変数は &bsol;XFree86 があるパーティションのド
ライブレターが以下のように設定されます:
<tscreen><verb>SET X11ROOT=Y:</verb></tscreen>
<!--
	You may try to move the tree to another subdirectory, e.g. to
	<tt>K:&bsol;OS2&bsol;X11&bsol;XFree86...</tt> and would then have
	to change this to
-->
ツリーを別のサブディレクトリ
(<tt>K:&bsol;OS2&bsol;X11&bsol;XFree86...</tt>)に移そうとすることがあ
るかもしれませんが、その場合には以下のように変更しなければなりません:
<tscreen><verb>SET X11ROOT=K:/OS2/X11</verb></tscreen>,
<!--
	but this is discouraged, since some utilities might not accept this.
	Note the forward ``/'' as a directory separator here.
-->
しかし、この変更はしないことをお勧めします。というのも、一部のユーティ
リティは変更を受け付けないからです。この設定ではディレクトリの区切り文
字に普通の ``/'' を使う点に注意してください。
<tag/DISPLAY/
<!--
	This variable may be set to the display to be used for displaying
	clients. Normally you will set this variable to the same value as
	the <tt/HOSTNAME/ variable and simply add a <tt/:0.0/ after it, such as
-->
この変数には、画面表示を行うクライアントが使うディスプレイを設定します。
通常この変数には <tt/HOSTNAME/ の後に単に <tt/:0.0/ を追加した値を設定
します。例えば以下のようになります:
<tscreen><verb>SET DISPLAY=myhost:0.0</verb></tscreen>
<!--
	Read the X11 man page on the exact meaning of these postfixes and
	other options.
-->
これらのポストフィックスと他のオプションの意味については、X11 のオンラ
インマニュアルを読んでください。
<tag/XSERVER/
<!--
	Set this to the executable name of the X server to be used. This
	must be a complete path. My setting, for instance, looks as follows:
-->
この変数には、使用する X サーバの実行ファイル名を設定します。これは完
全パスでなければなりません。例えば、筆者は以下のように設定しています:
<tscreen><verb>SET XSERVER=D:/XFree86/bin/XF86_Mach64.exe</verb></tscreen>
<tag/PATH/
<!--
	Add the binary directory for the X11 utilities to your search PATH.
	This is normally the directory (adjust the letter)
-->
X11 ユーティリティ用のバイナリディレクトリを検索パスに追加してください。
これは通常、ディレクトリです(ドライブレターを調整してください)。
<tscreen><verb>Y:&bsol;XFree86&bsol;bin</verb></tscreen>
<!--
	It is possible to move the binaries to another directory in the
	search path; for maintenance reasons and clarity of the structure, this
	is not recommended, though. You might, of course, use a software like
	TVFS to redirect these files to elsewhere.
-->
これらのバイナリを検索パスに含まれる他のディレクトリに移動させることは
可能です。しかし、これはメンテナンス上の理由や構成のわかりやすさの面か
らお勧めできません。もちろん、TVFS 等のソフトウェアを使ってこれらの
ファイルを別の場所にリダイレクトしても構いません。
<tag/LIBPATH/
<!--
	Add the DLL directory for the X11 utilities to the LIBPATH.
	This is normally the directory (adjust the letter)
-->
X11 ユーティリティ用の DLL ディレクトリを LIBPATH に追加してください。
通常、これはディレクトリです(ドライブレターを調整してください)。
<tscreen><verb>Y:&bsol;XFree86&bsol;lib</verb></tscreen>
<!--
	It is possible to move the DLLs to another directory in the
	library path; for maintenance reasons and clarity of the structure, 
	this is not recommended, though. Note that
	<tt>Y:&bsol;XFree86&bsol;lib</tt>
	has several other subdirectories; these may not be moved elsewhere,
	rather they must stay there, because most utilities form a path to
	these directories by using <tt>%X11ROOT%&bsol;XFree86&bsol;lib</tt>
	as a base.
-->
DLL をライブラリパスに含まれる他のディレクトリに移動させることは可能で
す。しかし、メンテナンス上の理由や構造のわかりやすさの面から、これはお
勧めできません。<tt>Y:&bsol;XFree86&bsol;lib</tt> にはサブディレクトリ
がいくつかある点に注意してください。これらはどこに動かすこともできず、
ずっとそこになければいけません。というのも、大部分のユーティリティは
<tt>%X11ROOT%&bsol;XFree86&bsol;lib</tt> をベース値として使ってディレ
クトリへのパスを作っているからです。
<tscreen><verb>SET MANPATH=Y:&bsol;XFree86&bsol;man;Y:&bsol;EMX&bsol;man</verb></tscreen>
<!--
	Note: xman alone might not be sufficient to display arbitrary Unix
	man pages correctly. You might have to install the <tt/GROFF/ formatter
	tool as well. See FAQ for more details.
-->
注意: xman 単体では全ての Unix のオンラインマニュアルを正しく表示する
ことはできません。<tt/GROFF/ という整形ツールもインストールしなければ
ならないでしょう。詳しくは FAQ を見てください。
<tag/OS2_SHELL/
<tag/COMSPEC/
<tag/SHELL/
<tag/X11SHELL/
<!--
	Some scripts in XFree86 rely on a shell that is compatible to the
	standard CMD.EXE. CMD.EXE has some essential properties that allows
	it to work correctly in an xterm. Third party shells may not been
	developed with running in an environment that, like xterm.  accept
	input and output from the stdin/stdout file channels, but access
	keyboard and video services directly. The above variables allow
	reconfiguration of your system in order to run any favorite shell
	outside XFree86 and still have XFree86 use CMD.EXE. See the FAQ
	for more details.
-->
XFree86 に入っているスクリプトの一部は、標準の CMD.EXE に互換なシェル
を前提としています。CMD.EXE には、xterm 内で正常に動作するための重要な
機能がいくつかあります。他で作られたシェルは、入出力は標準入力/標準出
力のファイルチャネルから受け取るけれど、キーボードとビデオのサービスは
直接アクセスするといった xterm のような環境で動作するように開発されて
いません。上記の変数を使うと、XFree86 の外では好きなシェルを使い、
XFree86 の中だけでは CMD.EXE を使うようにシステムを再設定できます。
詳しくは FAQ を見てください。
</descrip>

<!--
The recent version of XFree86/OS2 has a REXX script named <tt/checkinstall.cmd/
which you can (and should) use to check whether you have entered most things
correctly. This is not bullet-proof, but prevents the most obvious 
setup problems. Also, the X server itself will do some checking and will
refuse to start if something is wrong.
-->
最近のバージョンの XFree86/OS2  には <tt/checkinstall.cmd/ という名前
の REXX スクリプトが含まれています。このスクリプトを使って、項目のほと
んどを正しく入力したかどうかチェックを行うことができます(行うべきです)。
これは弾避けではありませんが、明らかな設定ミスの大部分を防ぐことができ
ます。
<!--
bullet-proof はナイスな訳語を聞いたことがある気がするが…忘れた。
-->
また X サーバ自身も同じチェックを行い、設定が誤っている場合には X サー
バは起動しません。
<!--
<sect>Remarks on the Network Configuration
-->
<sect>ネットワーク設定に関する注意

<p>
<!--
It is beyond the scope of this document to even give an introduction about
the correct installation of the TCP/IP networking system. You must do this
yourself or seek assistance elsewhere. It is only possible to say here that
a PC working well in a TCP/IP based LAN network will also work with 
XFree86/OS2 (when all other prerequisites are matched as well). 
-->
TCP/IP ネットワークシステムの正しいインストールについての手引きさえ、
本ドキュメントの範囲を越えています。この作業は読者の皆さん自身が行うか、
どこかから手伝ってくれる人を探してくるしかありません。ここで言えること
は、TCP/IP ベースの LAN ネットワーク上でうまく動作している PC は、
XFree86/OS2 もうまく動作するだろうということだけです(他の必須の条件も
満たされている場合)。
<!--
「LAN ネットワーク」というのはアレな気がするが。
-->

<!--
<label id="loopback">With IAK, there is a special configuration necessary,
unless you want to use XFree86/OS2 only during a hot link to your Internet
provider, the so called ``localhost'' or ``loopback'' configuration. This is
a local network interface which ``loops'' back to the same host. The following
settings are necessary for this:
-->
<label id="loopback">IAK を使っている場合には、インターネットプロバイ
ダに接続している間だけ XFree86/OS2 を使いたいのでなければ、特別な設定
が必要です。この設定はいわゆる「ローカルホスト」や「ループバック」と言
われる設定です。これはローカルのネットワークインタフェースで、同じホス
トに「ループして」戻ってくるものです。この場合には以下の設定が必要です:

<enum>
<!--
<item>Create a file <tt>&bsol;tcpip&bsol;etc&bsol;hosts</tt> with the
	following content:
-->
<item>以下の内容を持つ <tt>&bsol;tcpip&bsol;etc&bsol;hosts</tt> という
ファイルを作成します:
<tscreen><verb>127.0.0.1  localhost</verb></tscreen>
<!--
<item>Add the following line to your
	<tt>&bsol;tcpip&bsol;bin&bsol;tcpstart.cmd</tt>:
-->
<item>以下の行を <tt>&bsol;tcpip&bsol;bin&bsol;tcpstart.cmd</tt> に追
加します:
<tscreen><verb>ifconfig lo 127.0.0.1 up</verb></tscreen>
<!--
      If you don't have such a tcpstart.cmd file (Warp 4 calls this file
<tt>&bsol;MPTN&bsol;BIN&bsol;MPTSTART.CMD</tt>), create one, and add a line
like the following to your config.sys file:
-->
このような tcpstart.cmd ファイルが無い場合(Warp 4 では、このファイルは
<tt>&bsol;MPTN&bsol;BIN&bsol;MPTSTART.CMD</tt> と呼ばれます)には、この
ファイルを作成し、以下のような行を CONFIG.SYS ファイルに追加してくださ
い:
	<tt>CALL=C:&bsol;OS2&bsol;CMD.EXE /Q /C	C:&bsol;tcpip&bsol;bin&bsol;tcpstart.cmd &gt;NUL</tt>:
<!--
(implying that your bootdrive is C:).
-->
(起動ドライブは C: であるものとしています。)
<!--
<item>Set the HOSTNAME environment variable to <tt/localhost/ as described
       in the last section.
-->
<item>前のセクションで説明した通り、HOSTNAME 環境変数に <tt/localhost/ 
を設定します。
<!--
<item>Add the following line to CONFIG.SYS:
-->
<item>以下の行を CONFIG.SYS に追加します:
<tscreen><verb>SET USE_HOSTS_FIRST=1</verb></tscreen>
<!--
<item>After rebooting, verify that the following command works:
-->
<item>再起動後、以下のコマンドが動作するか確認します:
<tscreen><verb>[C:&bsol;] ping localhost</verb></tscreen>
</enum>

<!--
You don't need this ``loopback'' interface if your PC is connected to a LAN
(either directly or through SLIP/PPP).
-->
PC が LAN に接続されている場合(直接でも、SLIP/PPP 経由でも)には、この
「ループバック」インタフェースは必要ありません。

<!--
In case of a SLIP/PPP line, you have to establish this connection BEFORE
you start XFree86. See the next section for more details.
-->
SLIP/PPP 回線の場合には、XFree86 を起動する<em/前/に、この接続を確立し
なければなりません。詳しくは次の節を見てください。

<!--
Note that the ability to use host names, for instance in the <tt/DISPLAY/
variable, correlates with the existance of a name resolver. If you don't
have a LAN-based DNS server available, you have to add the relevant hostnames
to your <tt>HOSTS/ file. The TCP/IP configuration dialogue in your system 
configuration folder allows you to edit this file.
-->
ホスト名を使う(例えば <tt/DISPLAY/ 変数内での使用)機能は、
ホスト名解決機構と関係する点に注意してください。LAN ベースの DNS サー
バを利用できないのであれば、関係するホスト名を<tt/HOSTS/ ファイルに追
加しなければなりません。システムの設定フォルダの TCP/IP 設定ダイアログ
を使えば、このファイルを編集できます。

<!--
The <tt/checkinstall.cmd/ script coming with XFree86/OS2 gives some advice
on the configuration as well.
-->
XFree86/OS2 に付属している <tt/checkinstall.cmd/ スクリプトは、設定に
関するアドバイスもいくらかしてくれます。

<!--
If you have problems to get this or other basic networking things running,
seek assistance in the FAQ, the <htmlurl name="xf86os2 mailing list" url="http://ais.gmd.de/~veit/os2/xf86mail.html">
or the <htmlurl name="mailing list archive" url="http://ais.gmd.de/~veit/os2/xf86search.html">.
-->
これやや他の基本的なネットワーク関係のツールを動作させる際に問題が起こっ
たら、FAQ
(<htmlurl name="xf86os2 mailing list" url="http://ais.gmd.de/~veit/os2/xf86mail.html">)
を調べるか、
<htmlurl name="メーリングリストのアーカイブ" url="http://ais.gmd.de/~veit/os2/xf86search.html">
を調べてください。

<!--
<sect>Dynamic IP Considerations
-->
<sect>動的な IP の考慮

<!--
Generally, the whole stuff works best, if your machine has a fixed IP address.
The localhost address, and also fixed (non-routable) local addresses
(10.x.x.x, 192.168.x.x, 172.16.x.x-172.31.x.x) work fine. A problem occurs
on both sides of such an X connection if there are dynamic IP addresses
involved, for instance in case of a PPP line to an ISP. Unfortunately, the
XFree86/OS2 net community hasn't come up with a set of helpful scripts yet
(which I would integrate), so there are here only some hints what the problem
really is: The X server listens for X protocol packets on some defined 
host/port socket. It gets the information about the socket from either the
command line or the resolved hostname (which it gets from the <tt/HOSTS/ file
or the DNS server). Here the <tt/HOSTNAME/ variable comes into play. Once the
server is running, a change in the IP/HOSTNAME configuration won't be
recognized any more. Thus, the general approach for X over a dynamic IP line
is: build the connection to the ISP first, then start the server. The
relevant script that is responsible for starting the server is the startx.cmd
script which executes (indirectly) the &bsol;XFree86&bsol;lib&bsol;X11&bsol;xinit&bsol;xinitrc.cmd
script. You have to modify these scripts in order to set the <tt/HOSTNAME/ and
<tt/DISPLAY/ variables correctly and start the server with the right IP address.
The X server log shows, right to the beginning, at which IP address it is
listening, for debug purposes.
-->
<p>
一般的には、マシンの IP が固定であれば全体が最もうまく動作します。
ローカルホストアドレスと(ルーティングされない)固定のローカルアドレス
(10.x.x.x, 192.168.x.x, 172.16.x.x-172.31.x.x)でもうまく動作します。
X 接続などの両端で問題が起こるのは、動的な IP アドレスが含まれている場
合です。これは例えば、ISP に PPP 接続している場合などです。残念ながら、
XFree86/OS2 のネットコミュニティはこれに役立つスクリプト群をまだ用意で
きていないので(筆者がまとめるつもりです)、ここでは実際に問題になってい
ることについてヒントをいくつか出すだけにします: X サーバは定義された何
らかの値を持つホスト/ポート番号のソケットで X プロトコルのパケットを
監視します。X サーバはソケットに関する情報をコマンドラインまたは解決さ
れたホスト名(ホスト名は <tt/HOSTS/ ファイルまたは DNS サーバから取得し
ます)から得ます。ここで <tt/HOSTNAME/ 変数が出てきます。一度サーバが動
き出すと、IP/ホスト名の設定変更はもはや認識されません。したがって、動
的に IP が割り当てられる接続上で X を使うための一般的なアプローチは以
下のようになります: ISP への接続をまず確立し、それから X サーバを起動
します。X サーバの起動を行う関連スクリプトは startx.cmd です。このスク
リプトは(間接的に) &bsol;XFree86&bsol;lib&bsol;X11&bsol;xinit&bsol;xinitrc.cmd
スクリプトを実行します。したがって、これらのスクリプトを修正して、
<tt/HOSTNAME/ 変数と <tt/DISPLAY/ 変数を正しく設定し、正しい IP アドレ
スを使って X サーバを起動しなければなりません。X サーバのログの一番初
めのあたりには、監視している IP アドレスがデバッグ目的のために出力され
ています。

<!--
<sect>Configuring X for Your Hardware
-->
<sect>ハードウェアに合わせた X の設定

<p>
<!--
After you have added the required settings and setup a working network,
run the <tt/xf86config/ program to create a standard configuration file
in <tt>Y:&bsol;XFree86&bsol;lib&bsol;X11&bsol;XF86Config</tt> from a windowed
or full screen OS/2 text session:
-->
必要な設定を追加し、ネットワーク動作の設定を終えた後、ウィンドウセッショ
ンか、全画面の OS/2 テキストセッションから <tt/xf86config/ プログラム
を実行し、<tt>Y:&bsol;XFree86&bsol;lib&bsol;X11&bsol;XF86Config</tt> 
に標準設定ファイルを作成してください:
<tscreen><verb>[C:&bsol;] xf86config</verb></tscreen>

<!--
The <tt/xf86config/ program will ask a number of questions. You will need 
the information obtained from the SuperProbe program here. The program should 
be self explanatory; if you have problems to understand something though, seek
assistance in the newsgroups.
-->
<tt/xf86config/ プログラムは質問をたくさんしてきます。ここで 
SuperProbe プログラムから得た情報が必要になるでしょう。このプログラム
は自己説明的なはずです。しかし、何かを理解できないことがあれば、ニュー
スグループで助けを求めてください。

<!--
It is possible, but strongly discouraged for the non-expert, to edit the
<tt/XF86Config/ file with a text editor. In a few situations as described in
the FAQ, however, this might even be mandatory. This file is not a hacker's area,
such as the Win95 registry, but it has in common with it that you can
easily cause damage.
-->
<tt/XF86Config/ ファイルをテキストエディタで編集することも可能ですが、
エキスパートでない方はまず後込みしてしまうでしょう。しかし FAQ で説明
されている一部の場合では、必ずこれをしなければならないこともあります。
このファイルは Win95 のレジストリのようなハッカーの領域ではありません
が、簡単に破壊をもたらしかねない点は同じです。
<!--
fujiwara: 私の理解では Win95 のレジストリは OS をぶち壊して、
XF86Config はハードを飛ばすということで、あまり似ているようには思えな
いんすけど。
-->

<!--
For details about the <tt/XF86Config/ file format, refer to the
<em>XF86Config(4/5)</em> manual page.
-->
<tt/XF86Config/ ファイルの詳しいフォーマットについては、オンラインマニュ
アルの <em>XF86Config(4/5)</em> を参照してください。

<!--
If you know the configuration process from Linux or other XFree86 platform, 
you will encounter a few differences:
-->
Linux や他の XFree86 のプラットフォームにおける設定手順を知っているな
らば、いくつかの相違点を見つけることでしょう:

<itemize>
<!--
<item>There is no configuration for the mouse type or device. The mouse
       device name is fixed to OSMOUSE, and this cannot be changed.
       If you have a three-button-mouse, install the correct OS/2 driver 
       for it, such as
-->
<item>マウスの種類やデバイスに関する設定はありません。マウスのデバイス
名は OSMOUSE に固定されており、変更することはできません。3 ボタンマウ
スを持っている場合には、3 ボタンマウス用の正しい OS/2 用ドライバをイン
ストールしてください。例えば MouseSystems 互換のマウスの場合には以下の
ようになります:
<tscreen><verb>
DEVICE=D:&bsol;OS2&bsol;BOOT&bsol;PCLOGIC.SYS SERIAL=COM1
DEVICE=D:&bsol;OS2&bsol;BOOT&bsol;MOUSE.SYS TYPE=PCLOGIC$
</verb></tscreen>
<!--
       for a MouseSystems compatible mouse, for instance.
-->
<!--
<item>The X server does not read the native OS/2 keyboard map, but the new XKB
       server extension might already give you a correct keyboard layout,
       provided your language was selectable in the <tt/xf86config/ program. If you
       encounter incorrect settings, please send a mail to <tt/XFree86@XFree86.org/
       describing in detail what is wrong. Even with XKB, you have the option
       to replace some key settings with a xmodmap file. See the man page
       for xmodmap for details (or use some available xmodmap file from Linux -
       they are the same).
-->
<item>X サーバは OS/2 ネイティブのキーボードマップを読みませんが、
<tt/xf86config/ プログラムで言語が選択可能であれば、新しい XKB サーバ
拡張が既に正しいキーボード配列を与えていると思います。誤った設定に出会っ
たら、間違っている所を詳しく説明した電子メールを 
<tt/XFree86@XFree86.org/ まで送ってください。XKB を使っていても、一部
のキー設定を xmodmap ファイルで置き換えることはできます。詳しくは 
xmodmap のオンラインマニュアルを参照してください(あるいは Linux などで
利用可能な xmodmap ファイルを使ってください――これらは同じものです)。
<!--
<item>There is no support for the Wacom and Elographics input devices yet.
-->
<item>Wacom や Elographics の入力デバイスはまだサポートされていません。
</itemize>

<!--
In most cases, an existing <tt/XF86Config/ file for the same XFree86 version
from Linux or another platform may be used without changes. There are two
prominent exceptions: some S3 805 based VLB cards put their video memory
in odd locations, and there seems to be an unresolvable PM driver 
inconsistency with Matrox cards. 
-->
大抵の場合、Linux や他のプラットフォームの同じバージョンの XFree86 用
の既存の <tt/XF86Config/ を変更無しで使えると思います。ただし、よく知
られた例外が 2 つあります: S3 805 ベースの VLB カードの一部はビデオメ
モリをおかしな位置に配置します。また、Matrox のカードでは PM ドライバ
が解決できない矛盾を起こすようです。

<!--
For S3 VLB cards, the X server can search for this memory by experimentally 
mapping and unmapping possible memory regions. However, in XFree86/OS2, 
the OS may run out of memory tiles during this process. If this happens,
you must find out the location of the memory yourself
and add it as an option
-->
S3 VLB カードの場合、X サーバは可能性のあるメモリ領域を実験的にマップ
やアンマップすることで、このメモリを探すことができます。しかし、
XFree86/OS2 ではこの処理の途中で OS がメモリタイルを使い果たすことがあ
ります。こうなった場合、メモリの位置を自分で見つけ、オプション
<tscreen><verb>
	MemBase 0x12345678
</verb></tscreen>
<!--
to the section "Device" of your XF86Config file.
-->
を XF86Config ファイルの "Device" セクションに追加しなくてはなりません。

<!--
For Matrox cards, the X server may fail to detect the PCI ID of the card
correctly, as the PM driver and Matrox BIOS may have reprogrammed the card's
PCI configuration in a non-standard way. The server will then fall into a
VGA compatible mode at 320x200 resolution. To prevent this, add a
-->
Matrox のカードの場合には、X サーバがカードの PCI ID を正しく検出でき
ず、そのために PM ドライバと Matrox BIOS がカードの PCI 設定をおかしな
風に再プログラムするかもしれません。こうなるとサーバは VGA 互換で解像
度が 320x200 のモードに陥ります。これを防ぐには、
<tscreen><verb>
	PCIProbe2
</verb></tscreen>
<!--
to the section "ServerFlags" of your XF86Config file.
-->
を XF86Config ファイルの "ServerFlags" セクションに追加します。

<!--
Once you've set up a XF86Config file, you can fine tune the video
modes with the <tt>xvidtune</tt> utility. Note this is an X11 program which
has to be executed in a local xterm window of a running X server, not in
a PM window.
-->
一度 XF86Config ファイルが設定できれば、<tt>xvidtune</tt> ユーティリティ
を使ってビデオモードを良い設定にチューニングすることができます。
これは PM ウィンドウの中からではなく、動作中の X サーバのローカルの 
xterm のウィンドウの中から実行しなければならない X11 プログラムである
ことに注意してください。

<!--
<sect>Running X
-->
<sect>X の実行

<p>
<!--
16mb of memory is a recommended minimum for running the network software,
X and the presentation manager in parallel.  The server, window manager and 
an xterm take about 4-6 Mb of memory themselves.  X will start up on a
system with 8MB or less, but the performance will severely suffer from
heavy disk swapping. Your mileage may vary, though, so some people might
consider this still tolerable. 
-->
ネットワークソフトウェア、 X, プレゼンテーションマネージャを同時に実行
するには、メモリは最低 16MB は欲しいところです。サーバ、ウィンドウマネー
ジャ、xterm 1 つでメモリをだいたい 4〜6MB 使います。X は 8MB 以下のメ
モリでも起動しますが、激しいスワップが起きて、性能は非常に悪くなります。
しかし、考え方は人それぞれなので、これでも我慢できると思う人もいるかも
しれません。

<!--
Some more on resource requirements: With the arrival of complex desktops like
WindowMaker, KDE, Gnome, Enlightment, etc. which add a lot of graphical
features, resource requirements grow. The X server will cache used fonts and
resource settings internally, and depending on the number of windows (backing-
store) it may require much more memory and swapspace than the mentioned
few MBs. Also take into consideration that X runs in parallel to PM which
also takes its share. My own system, albeit meanwhile rather outdated,
is a PII-233 with 128MB, however, it is a development system. 64 MB are 
meanwhile standard, and okay for the purpose, and my laptop runs Aurora
with XFree86 in 32MB, as well.
-->
リソースに関する要求は他にもいくつかあります: WindowMaker, KDE, Gnome,
Enlightenment 等の複雑なデスクトップ環境が登場したことにより、非常に多
くのグラフィックスフィーチャが追加され、必要なリソースは大きくなりました。
X サーバは使われたフォントやリソース設定を内部的にキャッシュするので、
ウィンドウ(バッキングストア)の数によっては、先に述べた量よりもずっと多
くのメモリとスワップ領域が必要となります。また、X は PM と同時に動作し
て資源を共有することも考慮してください。筆者のシステムは比較的強力な 
PII-233、メモリ 128M のマシンですが、これは開発システムです。
64MB がだいたい標準で、普通の目的ではこれで十分です。筆者のラップトッ
プ機では、メモリ 32MB でも Aurora と XFree86 が一緒に動いています。

<!--
The easiest way for new users to start X windows is to type: 
<tscreen><verb>startx</verb></tscreen> in a PM CMD window. People have
reported problems when starting this in a fullscreen session or through
a remote telnet session, so don't try it.
-->
初めてのユーザが X ウィンドウを起動するための最も簡単な方法は、
<tscreen><verb>startx</verb></tscreen>
を PM の CMD ウィンドウから実行することです。このコマンドを
フルスクリーンのセッションやリモートの telnet セッションから実行すると
問題が起きることが報告されているので、これを行ってはいけません。

<!--
To get out of X windows, type: ``<tt/exit/'' in the console xterm.
You can customize your X by creating <tt/.xinitrc/, <tt/.xserverrc/,
and <tt/.twmrc/ files in the directory that the <tt/HOME/ environment 
variable points to. These files are described in the xinit and startx
man pages.
-->
X ウィンドウから抜け出すには、コンソールになっている xterm で
``<tt/exit/'' を入力してください。<tt/.xinitrc/, <tt/.xserverrc/,
<tt/.twmrc/ ファイルを <tt/HOME/ 環境変数が指しているディレクトリに作
成することで、X をカスタマイズすることができます。これらのファイルにつ
いては xinit と startx のオンラインマニュアルで説明されています。

<!--
By default, the systemwide <tt/xinitrc/ file (in <tt>Y:/XFree86/lib/X11/xinit/xinitrc.cmd</tt>)
installs the rather simplistic <tt/twm/ window manager. You can find better
window managers on the ported software page at 
<htmlurl name="http://ais.gmd.de/~veit/os2/xf86ported.html" url="http://ais.gmd.de/~veit/os2/xf86ported.html"> .
-->
デフォルトでは、システム全体の <tt/xinitrc/ ファイル
(<tt>Y:/XFree86/lib/X11/xinit/xinitrc.cmd</tt>)は
かなり作りが簡単である <tt/twm/ ウィンドウマネージャをインストールしま
す。
<htmlurl name="http://ais.gmd.de/~veit/os2/xf86ported.html" url="http://ais.gmd.de/~veit/os2/xf86ported.html">
にある移植ソフトウェアのページで、もっと良いウィンドウマネージャを見つ
けることができるでしょう。

<!--
<sect>Rebuilding the XFree86 Distribution
-->
<sect>XFree86 配布物の再構築

<p>
<!--
Do you really want to rebuild XFree86/OS2 from source? Read the file
<htmlurl name=OS2.Notes url=OS2Notes.html>
on details to recompile XFree86/OS2 from scratch.
-->
本当に XFree86/OS2 をソースからコンパイルしたいんですか? 最初から 
XFree86/OS2 を再コンパイルするための詳しい手順については、
「<htmlurl name=OS2.Notes url=OS2Notes.html>」ファイル
を読んでください。

<!--
<sect>Building New X Clients
-->
<sect>新しい X クライアントの構築

<p>
<!--
The easiest way to build a new client (X application) is to use
<tt/xmkmf/ if an <tt/Imakefile/ is included in the sources.  Type
``<tt/xmkmf -a/'' to create the Makefiles, check the configuration if
necessary and type ``<tt/xmake/''. ``<tt/xmake/'' is a wrapper for the
GNU make program which defeats the improper SHELL setting typically found
in a Makefile generated from an Imakefile. Also see the XFree86/OS2 FAQ 
for more hints about porting X clients.
-->
新しいクライアント(X アプリケーション)を構築するための最も簡単な方法は、
<tt/Imakefile/ がソースに付属していれば、<tt/xmkmf/ を使うことです。
``<tt/xmkmf -a/'' を実行して Makefile を生成し、必要に応じて設定をチェッ
クし、``<tt/xmake/'' を実行してください。``<tt/xmake/'' は GNU make プ
ログラムのためのラッパであり、Imakefile から生成された Makefile 中に決っ
て入っている誤った SHELL の設定を潰します。X クライアントの移植につい
ての詳しいヒントについては、XFree86/OS2 FAQ もご覧ください。

<!--
<sect>Acknowledgements
-->
謝辞

<p>
<!--
Many thanks to:
-->
以下の方々に感謝します:
<itemize>
<!--
<item><bf/Sebastien Marineau/ for his great work on getting the server code
debugged
-->
<item>サーバのコードのデバッグに関して大きく貢献された <bf/Sebastien Marineau/ さん。
<!--
<item><bf/Eberhard Mattes/ for the wonderful base platform EMX which this
port heavily relies on
-->
<item>この移植が大きく依存している素晴らしい基本プラットフォームである 
EMX を作成された <bf/Eberhard Mattes/ さん
<!--
<item><bf/ME/ - no, no, forget this: I won't praise myself :-)
-->
<item><bf/わたし/ - いやいや、これは忘れてください。自分を誉める気はありません :-)
</itemize>

<verb>
$XFree86: xc/programs/Xserver/hw/xfree86/doc/Japanese/sgml/OS2.sgml,v 1.1.2.3 1999/12/28 12:13:54 hohndel Exp $







$XConsortium: OS2.sgml /main/4 1996/03/11 10:46:06 kaleb $
</verb>

<sect>日本語訳について<p>
日本語訳は X Japanese Documentation Project が行いました
(翻訳: 藤原輝嘉 <url url="mailto:fujiwara@linux.or.jp"
name="&lt;fujiwara@linux.or.jp&gt;">)。
問題点の指摘やご意見は藤原まで御連絡ください。原文の著作権は XFree86 
プロジェクト社にあり、日本語訳に伴う権利は X Japanese Documentation
Project にあります。

</article>
