Ignore:
Timestamp:
06/12/2004 10:56:28 PM (20 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
d3edf27
Parents:
bfe245f
Message:

XML Updates to Part III from DJ

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2304 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/sysutils/gpm.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY gpm-download-http " ">
     8<!ENTITY gpm-download-ftp "ftp://arcana.linux.it/pub/gpm/gpm-&gpm-version;.tar.bz2">
     9<!ENTITY gpm-size "556 KB">
     10<!ENTITY gpm-buildsize "5.3 MB">
     11<!ENTITY gpm-time "0.09 SBU">
     12
     13]>
     14
    115<sect1 id="gpm" xreflabel="GPM-&gpm-version;">
    216<?dbhtml filename="gpm.html"?>
    317<title><acronym>GPM</acronym>-&gpm-version;</title>
    418
    5 &gpm-intro;
    6 &gpm-inst;
    7 &gpm-exp;
    8 &gpm-config;
    9 &gpm-desc;
     19<sect2>
     20<title>Introduction to <application><acronym>GPM</acronym></application></title>
     21                                                                               
     22<para>The <application><acronym>GPM</acronym></application> (General
     23Purpose Mouse daemon) package contains a mouse server for the console
     24and <command>xterm</command>. It not only provides cut and paste support
     25generally, but its library component is used by various software such as
     26<application>Links</application> to provide mouse support to the
     27application. It is useful on desktops, especially if following
     28(Beyond) Linux From Scratch instructions; it's often much easier (and
     29less error prone) to cut and paste between two console windows than to
     30type everything by hand!</para>
     31                                                                               
     32<sect3><title>Package information</title>
     33<itemizedlist spacing='compact'>
     34<listitem><para>Download (HTTP): <ulink
     35url="&gpm-download-http;"/></para></listitem>
     36<listitem><para>Download (FTP): <ulink
     37url="&gpm-download-ftp;"/></para></listitem>
     38<listitem><para>Download size: &gpm-size;</para></listitem>
     39<listitem><para>Estimated Disk space required:
     40&gpm-buildsize;</para></listitem>
     41<listitem><para>Estimated build time:
     42&gpm-time;</para></listitem></itemizedlist>
     43</sect3>
     44                                                                               
     45<sect3><title>Additional downloads</title>
     46<itemizedlist spacing='compact'>
     47<listitem><para>Recommended patch: <ulink
     48url="&patch-root;/gpm-1.20.1-segfault.patch"/></para></listitem>
     49<listitem><para>Recommended patch: <ulink
     50url="&patch-root;/gpm-1.20.1-silent.patch"/></para></listitem>
     51</itemizedlist>
     52</sect3>
     53                                                                               
     54</sect2>
     55
     56<sect2>
     57<title>Installation of <application><acronym>GPM</acronym></application></title>
     58                                                                               
     59<para>Install <application><acronym>GPM</acronym></application> by running the following commands:
     60</para>
     61                                                                               
     62<screen><userinput><command>patch -Np1 -i ../gpm-1.20.1-segfault.patch &amp;&amp;
     63patch -Np1 -i ../gpm-1.20.1-silent.patch &amp;&amp;
     64LDFLAGS="-lm" ./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
     65make &amp;&amp;
     66make install &amp;&amp;
     67cp conf/gpm-root.conf /etc &amp;&amp;
     68ldconfig -n -l /usr/lib/libgpm.so.1.19.0</command></userinput></screen>
     69</sect2>
     70
     71<sect2>
     72<title>Command explanations</title>
     73                                                                               
     74<para><command>LDFLAGS="-lm"</command>: The math library
     75 must be linked with <command>gpm</command>, as ceil() is used in some cursor
     76scrolling logic.</para>
     77                                                                               
     78<para><command>ldconfig -n -l </command>: During installation, gpm outputs a
     79message to run the above command to create the proper library links.</para>
     80                                                                               
     81</sect2>
     82
     83<sect2>
     84<title>Configuring <application><acronym>GPM</acronym></application></title>
     85                                                                               
     86<sect3><title>gpm init.d script</title>
     87<para>Install the <filename>/etc/rc.d/init.d/gpm</filename>
     88init script included in the
     89<xref linkend="intro-important-bootscripts"/> package.</para>
     90                                                                               
     91<screen><userinput><command>make install-gpm</command></userinput></screen>
     92                                                                               
     93</sect3>
     94                                                                               
     95<sect3><title>Config files</title>
     96<para><filename>/etc/sysconfig/mouse</filename>
     97This file contains the name of your mouse device and the protocol which
     98it uses.  To create this file, run the following:</para>
     99                                                                               
     100<screen><userinput><command>cat &gt; /etc/sysconfig/mouse &lt;&lt; "EOF"</command>
     101# Begin /etc/sysconfig/mouse
     102                                                                               
     103MDEVICE=<replaceable>[yourdevice]</replaceable>
     104PROTOCOL=<replaceable>[yourprotocol]</replaceable>
     105                                                                               
     106# End /etc/sysconfig/mouse
     107<command>EOF</command></userinput></screen>
     108</sect3>
     109                                                                               
     110<sect3><title>Configuration Information</title>
     111                                                                               
     112<para>Examples of values to set <envar>MDEVICE</envar> and
     113<envar>PROTOCOL</envar> to are:</para>
     114                                                                               
     115<screen><userinput>MDEVICE=/dev/psaux
     116PROTOCOL=imps2</userinput></screen>
     117                                                                               
     118<para>A list of which protocol values are known can be found by running
     119<command>gpm -t -help</command>.  Your <envar>MDEVICE</envar> setting depends on
     120which type of mouse you have.  For example,
     121<filename>/dev/ttyS0</filename> for a serial mouse (on Windows this is
     122COM1), <filename>/dev/input/mice</filename> is often used for
     123<acronym>USB</acronym> mice
     124and <filename>/dev/psaux</filename> for PS2 mice.</para>
     125                                                                               
     126</sect3>
     127                                                                               
     128</sect2>
     129
     130<sect2>
     131<title>Contents</title>
     132                                                                               
     133<para>The <application><acronym>GPM</acronym></application> package contains
     134<command>gpm</command>,
     135<command>gpm-root</command>, <command>disable-paste</command>
     136and <command>mev</command>.</para>
     137                                                                               
     138</sect2>
     139                                                                               
     140<sect2><title>Description</title>
     141                                                                               
     142<sect3><title>gpm</title>
     143<para><command>gpm</command> is a cut and paste utility and mouse server for
     144virtual consoles.</para></sect3>
     145                                                                               
     146<sect3><title>gpm-root</title>
     147<para><command>gpm-root</command> is a default handler for
     148<command>gpm</command>.  It is used to draw menus on the
     149root window.</para></sect3>
     150                                                                               
     151<sect3><title>disable-paste</title>
     152<para>No description available.</para></sect3>
     153                                                                               
     154<sect3><title>mev</title>
     155<para><command>mev</command> is a program to report mouse events.</para></sect3>
     156                                                                               
     157</sect2>
    10158
    11159</sect1>
Note: See TracChangeset for help on using the changeset viewer.