<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<article>

  <artheader>
    <title>Second Mouse in X mini-HOWTO</title>
    <author>
      <firstname>Greg</firstname>
      <surname>Wierzchowski</surname>
      <affiliation>
        <address><email>greg.wierzchowski@usa.net</email></address>
      </affiliation>
    </author>
<othercredit>
<firstname>かねこ (JF Project)</firstname>
<surname></surname>
<contrib>日本語訳</contrib>
 <affiliation>
  <address>skaneko@a2.mbn.or.jp (JF@linux.or.jp)</address>
 </affiliation>
</othercredit>

    <pubdate>2001-07-18</pubdate>
    <abstract>
       <PARA><!--Quick instructions to enable a second mouse in X.-->
       概要: X で二個のマウスを使うための、手っ取り早い説明です。</para>
    </abstract>

    <revhistory>
       <revision>
         <revnumber>1.2</revnumber>
         <date>2001-11-17</date>
         <authorinitials>GW</authorinitials>
         <revremark><!--Corrected for the Wheel Mouse in XFree 3.x.-->
           XFree 3.x でのホイールマウスの設定の修正</revremark>
      </revision>
       <revision>
         <revnumber>1.1</revnumber>
         <date>2001-07-21</date>
         <authorinitials>GW</authorinitials>
         <!--<revremark>Added "Alternatives" section.</revremark>-->
         <revremark>"Alternatives" 節の追加</revremark>
      </revision>
       <revision>
         <revnumber>1.0</revnumber>
         <date>2001-07-18</date>
         <authorinitials>GW</authorinitials>
         <!--<revremark>Initial Release.</revremark>-->
         <revremark>初版</revremark>
      </revision>
    </revhistory>

<keywordset>
 <keyword>
  XFree
 </keyword>
 <keyword>
  mouse
 </keyword>
</keywordset>

  </artheader>

<section id="intro"><title><!--Introduction-->はじめに</title>

<PARA><!--
This mini-HOWTO was created by gathering the information already available on
the internet, in newsgroups and other HOWTOs. I needed to hook up an USB mouse
in addition to the built-in trackpoint on my Thinkpad laptop.
-->
この mini-HOWTO は、ニュースグループやこのほかの HOWTO
など、既にインターネット上にある情報をかき集めて作成したものです。
これを書いたのは、私の Thinkpad ノート PC に組み込まれた trackpoint に加えて
USB マウスをつけたかったためでした。
</PARA>
<PARA><!--
Examples in this mini-HOWTO pertain to my particular hardware configuration,
which is PS/2 mouse as a primary pointer and USB wheel mouse as an additional
one. It should be pretty straightforward to implement another combination, say,
a PS/2 and a serial mice. Two things that would have to be changed are the
<emphasis>mouse
protocol</emphasis> and the <emphasis>mouse device</emphasis>. Wherever
possible, I try to provide appropriate examle.
-->
この mini-HOWTO に記載されている例は、特に私の持っているハードウェア (PS2
マウスが主ポインタで、USB ホイールマウスを追加した場合) のための物です。
設定自体はかなりわかりやすいため、他の組み合わせ、例えば PS/2
とシリアルマウスを使うような設定もかなり容易でしょう。
変更しなければならない点は、<emphasis>マウスプロトコル</emphasis>
と <emphasis>マウスデバイス</emphasis> の二点です。
この文書では、必要な箇所には適切な例を示すように努めています。
</PARA>
<PARA><!--
The instructions for X are divided into two sections, one for XFree version 3 and one
for XFree 4. The format of the XF86Config file has significantly changed between
versions and requires slightly different approach. In XFree 3.x, the second
mouse has to appear in an <emphasis>Xinput</emphasis> section, which has
slightly different syntax than the regular <emphasis>Pointer</emphasis> section.
In XFree 4.x, it's just another pointer.
-->
X の設定法は、XFree バージョン 3 向け、及び XFree 4 向けの二つの別々の節に分けて書いています。
XF86Config ファイルのフォーマットはバージョン間で大きく変更されており、多少異なったアプローチが必要になるためです。
XFree 3.x では二個目のマウスは <emphasis>Xinput</emphasis>
セクションに書く必要があり、またそのセクションでの書式は通常の
<emphasis>Pointer</emphasis> での記載法と多少異なっています。XFree 4.x
では、二個目のマウスは単なるもう一つのポインタデバイスとして扱われます。
</PARA>
</section>
<section id="copyright"><title>Copyright and License</title>
      <PARA>This document is copyright 2001 by Greg Wierzchowski and is released under
      the terms of the GNU Free Documentation License, which is hereby incorporated
      by reference. Send feedback to
      <ulink url="mailto:greg.wierzchowski@usa.net"><citetitle>greg.wierzchowski@usa.net</citetitle></ulink>.
</PARA><PARA>
      この文書は Greg Wierzchowski が著作権 (c) 2001 を有しており、GNU
      フリードキュメントライセンス (リンクによる参照により添付扱いとします)
      の元で公開されています。フィードバックは
      <ulink url="mailto:greg.wierzchowski@usa.net"><citetitle>greg.wierzchowski@usa.net</citetitle></ulink>
      へお願いします。
</PARA>
<PARA>
【訳注:このアドレスでは既に作者に届かなくなっている模様なので、何かあれば JF@linux.or.jp にお願いします。】
</PARA>
    </section>

<section id="protocol"><title><!--Mouse Protocols-->マウスプロトコル</title>
<PARA><!--Two most important parameters in the <filename>XF86Config</filename> file, ones that are crucial to the mouse working properly are the <emphasis>Protocol</emphasis> and <emphasis>Device</emphasis>.
-->
マウスを正しく動くようにするために必須となる、<filename>XF86Config</filename>
ファイル中の二つの最重要パラメータは <emphasis>Protocol</emphasis> と
<emphasis>Device</emphasis> です。
</PARA>
<PARA><!--
As far as <emphasis>Protocol</emphasis> is concerned, it seems that
<emphasis>gpm</emphasis> uses compatible protocol names, so please look there
for the detailed information. Here is the excerpt taken from the gpm info page
(just the few most commont types):
-->
<emphasis>Protocol (プロトコル)</emphasis> については、<emphasis>gpm</emphasis>
が互換のプロトコル名を用いていますので、詳細はそちらを参考にしてください。
以下は gpm の info ページからの抜粋 (もっとも普及しているものから数種) です。
<table frame="all">
   <!--<title>Most Common Mouse Protocols in X</title>-->
   <title>X でのもっともありふれたマウスプロトコル</title>
   <tgroup cols="2">
     <colspec colname="column1">
     <colspec colname="column2">
      <thead>
       <row>
         <entry><!--Protocol Name-->プロトコル名</entry>
         <entry><!--Description-->説明</entry>
       </row>
     </thead>
        <tbody>
       <row>
         <entry>Microsoft</entry>
         <entry><!--Standard Microsoft mice.-->標準マイクロソフトマウス</entry>
       </row>
       <row>
         <entry>MouseSystems</entry>
         <entry><!--This is the standard protocol for three-button serial devices.-->
               これは三ボタンシリアルマウスの標準プロトコルです。</entry>
       </row>
       <row>
         <entry>MMSeries</entry>
      <entry><!--Title says it all.  This mouse decoder accepts standard serial
      options, although they should not be needed.-->
      タイトル通りです。このマウスデコーダは標準シリアルオプションも受け付けますが、通常は必要ありません。</entry>
       </row>
       <row>
         <entry>Logitech</entry>
	 <entry><!--This is the protocol used by old serial Logitech mice.-->
	 これは古いタイプのシリアル Logitech
	 社マウスで使われていたプロトコルです。</entry>
       </row>
       <row>
         <entry><!--BusMouse-->バスマウス</entry>
	 <entry><!--Some bus devices use this protocol, including those produced by
      Logitech.-->
         一部のバスデバイスがこのプロトコルを使用しています。例えば Logitech
         社製のものが該当します。</entry>
       </row>
       <row>
         <entry>PS/2</entry>
	 <entry><!--The protocol used by most busmice.-->
	  殆どのバスマウスで使われているプロトコルです。</entry>
       </row>
       <row>
         <entry>IMPS/2</entry>
	 <entry><!--"IntelliMouse" on the ps/2 port. <emphasis>Also works with USB
	 mice</emphasis>-->
	 PS/2 ポート向けの "IntelliMouse" 用です。<emphasis>USB
	 マウスでもこれで動作します。</emphasis>
	 </entry>
       </row>
         </tbody>
   </tgroup>
</TABLE>
</PARA>
</section>

<section id="xfree3"><title>XFree 3.x</title>
<PARA><!--
In XFree 3.x, additional pointing devices, like mice or tablets, are defined
through the use of an <emphasis>Xinput</emphasis> section. The primary mouse is
defined as usual:
-->
XFree 3.x では追加のポインティングデバイス、例えばマウスやタブレットは
<emphasis>Xinput</emphasis> セクションの記述で定義します。
一個目のマウスは通常通り
<PROGRAMLISTING>
Section "Pointer"
    Protocol    "PS/2"
    Device      "/dev/mouse"
EndSection
</programlisting>
として定義します。<!--
In the case above, it's a regular three-button PS/2 mouse, which works for the
trackpoint as well. Now, for the USB mouse:
-->
上記の例では、通常の三つボタン PS/2 マウスです。
この設定はトラックポイントでも動作します。さて、USB マウスですが、
<PROGRAMLISTING>
    Section "Xinput"
  SubSection "Mouse"
    DeviceName "USB Mice"
    Protocol "IMPS/2"
    ZAxisMapping 4 5
    Port "/dev/input/mice"
    Alwayscore
  EndSubSection
EndSection
</programlisting>
とします。<!--
My mouse is a wheel mouse, thus the protocol is <emphasis>IMPS/2</emphasis>. ZAxisMapping line is also needed for the wheel to work.
I also want the mouse to always work alongside the other one, and this is achieved
through the <emphasis>AlwaysCore</emphasis> option. If. for example, this was
a serial mouse, the <emphasis>Port</emphasis> would read
<command>"/dev/ttyS0"</command> for <command>COM1</command>.
-->
私のマウスはホイールマウスなので、プロトコルは <emphasis>IMPS/2</emphasis>
になります。ホイールマウスを動作させるには、ZAxisMapping の行も必要です。
私はこのマウスをもう一つのマウスと常時両方使うようにしています。
このように使うための設定が、<emphasis>AlwaysCore</emphasis>
オプションです。例えば、<command>COM1</command>
につながっているシリアルマウスの場合なら、<emphasis>Port</emphasis> の所を
<command>"/dev/ttyS0"</command> と書き換えます。
</PARA>

</section>

<section id="xfree4"><title>XFree 4.x</title>
<PARA><!--
With XFree 4.x the task is even easier. First, the primary mouse, usually present in the config file already:
-->
XFree 4.x では作業はずっと容易です。まず、一つ目のマウスは (次のように)
既に設定ファイル中に記載されているでしょう。
<PROGRAMLISTING>
Section "InputDevice"
        Identifier  "Mouse0"
        Driver      "mouse"
        Option      "Device" "/dev/mouse"
        Option      "Protocol" "PS/2"
        Option      "Emulate3Buttons" "off"
        Option      "ZAxisMapping" "4 5"
EndSection
</programlisting><!--
To add another mouse just copy the above section and modify it, so that it reads:
-->
別のマウスを付けるには、上の部分をコピーし、そちらの方も読むように変更するだけです。
<PROGRAMLISTING>
Section "InputDevice"
        Identifier  "Mouse1"
        Driver      "mouse"
        Option      "Device" "/dev/input/mice"
        Option      "Protocol" "IMPS/2"
        Option      "Emulate3Buttons" "off"
        Option      "ZAxisMapping" "4 5"
EndSection
</programlisting><!--
Well, this way you can define as many additional pointers as you wish, and the same applies to joysticks and tablets.
-->
つまり、このようにして好きなだけの追加のポインタを定義できます。
ジョイスティックやタブレットについても同様です。
</PARA>
<PARA><!--
To make both mice work together, there's one more change to be made to the <filename>XF86Config</filename> file.
There is a section called <emphasis>ServerLayout</emphasis> where all the components are specified. Here's how it looks <emphasis>before</emphasis> adding a second mouse:
-->
両方のマウスを同時に使えるようにするためには、<filename>XF86Config</filename>
にもう一カ所変更が必要です。<emphasis>ServerLayout</emphasis>
というセクションがあって、全ての構成部品の定義はここでされています。二個目のマウスを付けるよう
<emphasis>変更する前</emphasis> には、以下のようになっています。
<PROGRAMLISTING>
Section "ServerLayout"
        Identifier "XFree86 Configured"
        Screen      0  "Screen0" 0 0
        InputDevice    "Mouse0" "CorePointer"
        InputDevice    "Keyboard0" "CoreKeyboard"
EndSection
</programlisting><!--
And <emphasis>after</emphasis> adding the second mouse:
-->
それでは、二個目のマウスを付けましょう。
<PROGRAMLISTING>
Section "ServerLayout"
        Identifier "XFree86 Configured"
        Screen      0  "Screen0" 0 0
        InputDevice    "Mouse0" "CorePointer"
        InputDevice    "Mouse1" "AlwaysCore"
        InputDevice    "Keyboard0" "CoreKeyboard"
EndSection
</programlisting>
</PARA>
</section>

<section id="alternatives"><title><!--Alternatives-->別法</title>
<PARA><!--
Another way to use two (or more) mice at the same time time is to use a program such as <emphasis>MultiMouse</emphasis> by Takashi Manabe. It's a daemon multiplexing several mice and making them available through the special device <filename>/dev/mumse</filename> as a MouseSystems compatible mouse.
-->
同時に二個 (またはそれ以上) のマウスを使うには、プログラムを使うという別法もあります。
プログラムの例として、真鍋敬士さんの <emphasis>MultiMouse</emphasis>
があります。これは幾つかのシリアルマウスを束ねてそれを一つのスペシャルデバイス
<filename>/dev/mumse</filename> から MouseSystems 互換マウスとして使えるようにするデーモンです。
</PARA><PARA><!-- According to the author: <quote>This program allows you to use multiple mice at the same time. This program is developed for a subnote user who want to use both a pre-mounted pointing device and a external serial mouse.</quote>-->
作者によると:
<quote>このプログラムで同時に複数個のマウスの利用が可能になります。
このプログラムはサブノートユーザで、既に実装済みのポインティングデバイスと外付けのシリアルマウスの両方を使いたい人たちに向けて開発しています。</quote>
ということです。
</para><para><!--I'm not sure if the program supports second mouse other than serial, but the advantage is that the second mouse works in console mode too. <command>MultiMouse</command> can be found at Sunsite (sunsite.unc.edu /pub/Linux/system/Misc) and Tucows (www.tucows.com Linux Console -> Utilities).
-->
このプログラムで、二個目のマウスにシリアルマウス以外のものが使えるのかどうかについては私には分かりませんが、
このプログラムの利点は二個目のマウスをコンソールモードでも使えることです。
<command>MultiMouse</command> は Sunsite (sunsite.unc.edu
/pub/Linux/system/Misc) や Tucows (www.tucows.com Linux Console -> Utilities)
にあります。
</PARA>
</section>

<section id="credits"><title><!--Credits-->謝辞</title>
<PARA><!--
Special thanks to all the people who contribute to the Linux community and who made this HOWTO possible.
-->
Linux コミュニティに貢献していただき、この HOWTO
を可能にした全ての方々に感謝します。
</PARA>
</section>
</article>

