Author: manuel Date: 2005-05-07 03:39:51 -0600 (Sat, 07 May 2005) New Revision: 3999
Modified: trunk/BOOK/general/sysutils/gpm.xml Log: Tagged gpm.xml Modified: trunk/BOOK/general/sysutils/gpm.xml =================================================================== --- trunk/BOOK/general/sysutils/gpm.xml 2005-05-06 23:10:19 UTC (rev 3998) +++ trunk/BOOK/general/sysutils/gpm.xml 2005-05-07 09:39:51 UTC (rev 3999) @@ -4,224 +4,267 @@ <!ENTITY % general-entities SYSTEM "../../general.ent"> %general-entities; -<!ENTITY gpm-download-http " "> -<!ENTITY gpm-download-ftp "ftp://arcana.linux.it/pub/gpm/gpm-&gpm-version;.tar.bz2";> -<!ENTITY gpm-md5sum "2c63e827d755527950d9d13fe3d87692"> -<!ENTITY gpm-size "556 KB"> -<!ENTITY gpm-buildsize "6.7 MB"> -<!ENTITY gpm-time "0.09 SBU"> + <!ENTITY gpm-download-http " "> + <!ENTITY gpm-download-ftp "ftp://arcana.linux.it/pub/gpm/gpm-&gpm-version;.tar.bz2";> + <!ENTITY gpm-md5sum "2c63e827d755527950d9d13fe3d87692"> + <!ENTITY gpm-size "556 KB"> + <!ENTITY gpm-buildsize "6.7 MB"> + <!ENTITY gpm-time "0.09 SBU"> ]> <sect1 id="gpm" xreflabel="GPM-&gpm-version;"> -<sect1info> -<othername>$LastChangedBy$</othername> -<date>$Date$</date> -</sect1info> -<?dbhtml filename="gpm.html"?> -<title><acronym>GPM</acronym>-&gpm-version;</title> -<indexterm zone="gpm"> -<primary sortas="a-GPM">GPM</primary></indexterm> + <?dbhtml filename="gpm.html"?> -<sect2> -<title>Introduction to <application><acronym>GPM</acronym></application></title> + <sect1info> + <othername>$LastChangedBy$</othername> + <date>$Date$</date> + </sect1info> -<para>The <application><acronym>GPM</acronym></application> (General -Purpose Mouse daemon) package contains a mouse server for the console -and <command>xterm</command>. It not only provides cut and paste support -generally, but its library component is used by various software such as -<application>Links</application> to provide mouse support to the -application. It is useful on desktops, especially if following -(Beyond) Linux From Scratch instructions; it's often much easier (and -less error prone) to cut and paste between two console windows than to -type everything by hand!</para> + <title>GPM-&gpm-version;</title> -<sect3><title>Package information</title> -<itemizedlist spacing='compact'> -<listitem><para>Download (HTTP): <ulink -url="&gpm-download-http;"/></para></listitem> -<listitem><para>Download (FTP): <ulink -url="&gpm-download-ftp;"/></para></listitem> -<listitem><para>Download MD5 sum: &gpm-md5sum;</para></listitem> -<listitem><para>Download size: &gpm-size;</para></listitem> -<listitem><para>Estimated disk space required: -&gpm-buildsize;</para></listitem> -<listitem><para>Estimated build time: -&gpm-time;</para></listitem></itemizedlist> -</sect3> + <indexterm zone="gpm"> + <primary sortas="a-GPM">GPM</primary> + </indexterm> -<sect3><title>Additional downloads</title> -<itemizedlist spacing='compact'> -<listitem><para>Recommended Patch: <ulink -url="&patch-root;/gpm-&gpm-version;-segfault-1.patch"/></para></listitem> -<listitem><para>Recommended Patch: <ulink -url="&patch-root;/gpm-&gpm-version;-silent-1.patch"/></para></listitem> -</itemizedlist> -</sect3> + <sect2 role="package"> + <title>Introduction to GPM</title> -</sect2> + <para>The <application>GPM</application> (General Purpose Mouse + daemon) package contains a mouse server for the console and + <command>xterm</command>. It not only provides cut and paste support + generally, but its library component is used by various software such as + <application>Links</application> to provide mouse support to the application. + It is useful on desktops, especially if following (Beyond) Linux From Scratch + instructions; it's often much easier (and less error prone) to cut and paste + between two console windows than to type everything by hand!</para> -<sect2> -<title>Installation of <application><acronym>GPM</acronym></application></title> + <bridgehead renderas="sect3">Package Information</bridgehead> + <itemizedlist spacing="compact"> + <listitem> + <para>Download (HTTP): <ulink url="&gpm-download-http;"/></para> + </listitem> + <listitem> + <para>Download (FTP): <ulink url="&gpm-download-ftp;"/></para> + </listitem> + <listitem> + <para>Download MD5 sum: &gpm-md5sum;</para> + </listitem> + <listitem> + <para>Download size: &gpm-size;</para> + </listitem> + <listitem> + <para>Estimated disk space required: &gpm-buildsize;</para> + </listitem> + <listitem> + <para>Estimated build time: &gpm-time;</para> + </listitem> + </itemizedlist> -<para>Install <application><acronym>GPM</acronym></application> by running -the following commands: -</para> + <bridgehead renderas="sect3">Additional Downloads</bridgehead> + <itemizedlist spacing='compact'> + <listitem> + <para>Recommended Patch: <ulink + url="&patch-root;/gpm-&gpm-version;-segfault-1.patch"/></para> + </listitem> + <listitem> + <para>Recommended Patch: <ulink + url="&patch-root;/gpm-&gpm-version;-silent-1.patch"/></para> + </listitem> + </itemizedlist> -<screen><userinput><command>patch -Np1 -i ../gpm-&gpm-version;-segfault-1.patch && + </sect2> + + <sect2 role="installation"> + <title>Installation of GPM</title> + + <para>Install <application>GPM</application> by running + the following commands:</para> + +<screen><userinput>patch -Np1 -i ../gpm-&gpm-version;-segfault-1.patch && patch -Np1 -i ../gpm-&gpm-version;-silent-1.patch && LDFLAGS="-lm" ./configure --prefix=/usr --sysconfdir=/etc && -make</command></userinput></screen> +make</userinput></screen> -<para>Now, as the root user:</para> + <para>Now, as the <systemitem class="username">root</systemitem> user:</para> -<screen><userinput role='root'><command>make install && -cp conf/gpm-root.conf /etc && -ldconfig</command></userinput></screen> -</sect2> +<screen role="root"><userinput>make install && +cp -v conf/gpm-root.conf /etc && +ldconfig</userinput></screen> -<sect2> -<title>Command explanations</title> + </sect2> -<para><command>LDFLAGS="-lm"</command>: The math library -must be linked with <command>gpm</command>, as ceil() is used in some cursor -scrolling logic.</para> + <sect2 role="commands"> + <title>Command Explanations</title> + <para><command>LDFLAGS="-lm"</command>: The math library + must be linked with <command>gpm</command>, as ceil() is used in + some cursor scrolling logic.</para> + <!-- <para><command>ldconfig -n -l </command>: During installation, gpm outputs a message to run the above command to create the proper library links.</para> --> -</sect2> + </sect2> -<sect2> -<title>Configuring <application><acronym>GPM</acronym></application></title> + <sect2 role="configuration"> + <title>Configuring GPM</title> -<sect3 id="gpm-init"><title>gpm init.d script</title> -<indexterm zone="gpm gpm-init"> -<primary sortas="f-gpm-init">gpm</primary></indexterm> + <sect3 id="gpm-init"> + <title>Boot Script</title> -<para>Install the <filename>/etc/rc.d/init.d/gpm</filename> -init script included in the -<xref linkend="intro-important-bootscripts"/> package.</para> + <indexterm zone="gpm gpm-init"> + <primary sortas="f-gpm-init">gpm</primary> + </indexterm> -<screen><userinput role='root'><command>make install-gpm</command></userinput></screen> -</sect3> + <para>Install the <filename>/etc/rc.d/init.d/gpm</filename> init script + included in the <xref linkend="intro-important-bootscripts"/> package.</para> -<sect3 id="gpm-config"><title>Config files</title> +<screen role="root"><userinput>make install-gpm</userinput></screen> -<para><filename>/etc/gpm-root.conf</filename> and -<filename>~/.gpm-root</filename>: The default and individual user -<command>gpm-root</command> configuration files.</para> + </sect3> -<para><filename>/etc/sysconfig/mouse</filename>: -This file contains the name of your mouse device and the protocol which -it uses. To create this file, run the following as the root user:</para> + <sect3 id="gpm-config"> + <title>Config Files</title> -<screen><userinput role='root'><command>cat > /etc/sysconfig/mouse << "EOF"</command> -# Begin /etc/sysconfig/mouse + <para><filename>/etc/gpm-root.conf</filename> and + <filename>~/.gpm-root</filename>: The default and individual user + <command>gpm-root</command> configuration files.</para> + <para><filename>/etc/sysconfig/mouse</filename>: + This file contains the name of your mouse device and the protocol which + it uses. To create this file, run the following as the root user:</para> + +<screen role="root"><userinput>cat > /etc/sysconfig/mouse << "EOF" +<literal># Begin /etc/sysconfig/mouse + MDEVICE="<replaceable>[yourdevice]</replaceable>" PROTOCOL="<replaceable>[yourprotocol]</replaceable>" GPMOPTS="<replaceable>[additional options]</replaceable>" -# End /etc/sysconfig/mouse -<command>EOF</command></userinput></screen> +# End /etc/sysconfig/mouse</literal> +EOF</userinput></screen> -<indexterm zone="gpm gpm-config"> -<primary sortas="e-AA.gpm-root">~/.gpm-root</primary></indexterm> -<indexterm zone="gpm gpm-config"> -<primary sortas="e-etc-gpm-root.conf">/etc/gpm-root.conf</primary></indexterm> -<indexterm zone="gpm gpm-config"> -<primary sortas="e-etc-sysconfig-mouse">/etc/sysconfig/mouse</primary> -</indexterm> -</sect3> + <indexterm zone="gpm gpm-config"> + <primary sortas="e-AA.gpm-root">~/.gpm-root</primary> + </indexterm> -<sect3><title>Configuration Information</title> + <indexterm zone="gpm gpm-config"> + <primary sortas="e-etc-gpm-root.conf">/etc/gpm-root.conf</primary> + </indexterm> -<para>Examples of values to set <envar>MDEVICE</envar>, -<envar>PROTOCOL</envar>, and <envar>GPMOPTS</envar> to are:</para> + <indexterm zone="gpm gpm-config"> + <primary sortas="e-etc-sysconfig-mouse">/etc/sysconfig/mouse</primary> + </indexterm> -<screen><userinput>MDEVICE="/dev/psaux" + </sect3> + + <sect3> + <title>Configuration Information</title> + + <para>Examples of values to set <envar>MDEVICE</envar>, + <envar>PROTOCOL</envar>, and <envar>GPMOPTS</envar> to are:</para> + +<screen><literal>MDEVICE="/dev/psaux" PROTOCOL="imps2" -GPMOPTS=""</userinput></screen> +GPMOPTS=""</literal></screen> -<para>A list of which protocol values are known can be found by running -<command>gpm -t -help</command>. The <envar>MDEVICE</envar> setting -depends on which type of mouse you have. For example, -<filename>/dev/ttyS0</filename> for a serial mouse (on Windows this is -COM1), <filename>/dev/input/mice</filename> is often used for -<acronym>USB</acronym> mice and <filename>/dev/psaux</filename> for PS2 -mice. <envar>GPMOPTS</envar> is the 'catch all' for any -additional options that are needed for your hardware.</para> -</sect3> + <para>A list of which protocol values are known can be found by running + <command>gpm -t -help</command>. The <envar>MDEVICE</envar> setting + depends on which type of mouse you have. For example, + <filename>/dev/ttyS0</filename> for a serial mouse (on Windows this is + COM1), <filename>/dev/input/mice</filename> is often used for + USB mice and <filename>/dev/psaux</filename> for PS2 + mice. <envar>GPMOPTS</envar> is the 'catch all' for any + additional options that are needed for your hardware.</para> -</sect2> + </sect3> -<sect2> -<title>Contents</title> + </sect2> -<segmentedlist> -<segtitle>Installed Programs</segtitle> -<seglistitem> -<seg>disable-paste, gpm, gpm-root, hltest, mev and mouse-test</seg> -</seglistitem> -</segmentedlist> + <sect2 role="content"> + <title>Contents</title> -<variablelist> -<bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> + <segmentedlist> + <segtitle>Installed Programs</segtitle> + <segtitle>Installed Libraries</segtitle> + <segtitle>Installed Directories</segtitle> -<varlistentry id="disable-paste"> -<term><command>disable-paste</command></term> -<listitem><para>is a security mechanism used to disable the paste buffer.</para> -<indexterm zone="gpm disable-paste"> -<primary sortas="b-disable-paste">disable-paste</primary></indexterm> -</listitem> -</varlistentry> + <seglistitem> + <seg>disable-paste, gpm, gpm-root, hltest, mev, and mouse-test</seg> + <seg>None</seg> + <seg>None</seg> + </seglistitem> + </segmentedlist> -<varlistentry id="gpm-prog"> -<term><command>gpm</command></term> -<listitem><para>is a cut and paste utility and mouse server for virtual -consoles.</para> -<indexterm zone="gpm gpm-prog"> -<primary sortas="b-gpm">gpm</primary></indexterm> -</listitem> -</varlistentry> + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> -<varlistentry id="gpm-root"> -<term><command>gpm-root</command></term> -<listitem><para>is a default handler for <command>gpm</command>. It is used to -draw menus on the root window.</para> -<indexterm zone="gpm gpm-root"> -<primary sortas="b-gpm-root">gpm-root</primary></indexterm> -</listitem> -</varlistentry> + <varlistentry id="disable-paste"> + <term><command>disable-paste</command></term> + <listitem> + <para>is a security mechanism used to disable the paste buffer.</para> + <indexterm zone="gpm disable-paste"> + <primary sortas="b-disable-paste">disable-paste</primary> + </indexterm> + </listitem> + </varlistentry> -<varlistentry id="hltest"> -<term><command>hltest</command></term> -<listitem><para>is a simple sample application using the high-level library, -meant to be read by programmers trying to use the high-level library.</para> -<indexterm zone="gpm hltest"> -<primary sortas="b-hltest">hltest</primary></indexterm> -</listitem> -</varlistentry> + <varlistentry id="gpm-prog"> + <term><command>gpm</command></term> + <listitem> + <para>is a cut and paste utility and mouse server for virtual consoles.</para> + <indexterm zone="gpm gpm-prog"> + <primary sortas="b-gpm">gpm</primary> + </indexterm> + </listitem> + </varlistentry> -<varlistentry id="mev"> -<term><command>mev</command></term> -<listitem><para>is a program to report mouse events.</para> -<indexterm zone="gpm mev"> -<primary sortas="b-mev">mev</primary></indexterm> -</listitem> -</varlistentry> + <varlistentry id="gpm-root"> + <term><command>gpm-root</command></term> + <listitem> + <para>is a default handler for <command>gpm</command>. It is used to + draw menus on the root window.</para> + <indexterm zone="gpm gpm-root"> + <primary sortas="b-gpm-root">gpm-root</primary> + </indexterm> + </listitem> + </varlistentry> -<varlistentry id="mouse-test"> -<term><command>mouse-test</command></term> -<listitem><para>is a tool for determining the mouse type and device it's -attached to.</para> -<indexterm zone="gpm mouse-test"> -<primary sortas="b-mouse-test">mouse-test</primary></indexterm> -</listitem> -</varlistentry> -</variablelist> + <varlistentry id="hltest"> + <term><command>hltest</command></term> + <listitem> + <para>is a simple sample application using the high-level library, + meant to be read by programmers trying to use the high-level library.</para> + <indexterm zone="gpm hltest"> + <primary sortas="b-hltest">hltest</primary> + </indexterm> + </listitem> + </varlistentry> -</sect2> + <varlistentry id="mev"> + <term><command>mev</command></term> + <listitem> + <para>is a program to report mouse events.</para> + <indexterm zone="gpm mev"> + <primary sortas="b-mev">mev</primary> + </indexterm> + </listitem> + </varlistentry> + <varlistentry id="mouse-test"> + <term><command>mouse-test</command></term> + <listitem> + <para>is a tool for determining the mouse type and device it's + attached to.</para> + <indexterm zone="gpm mouse-test"> + <primary sortas="b-mouse-test">mouse-test</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> + </sect1> -- http://linuxfromscratch.org/mailman/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
