Ignore:
Timestamp:
03/19/2020 10:00:16 AM (4 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
e68b588
Parents:
09f0998
Message:

Format sysutils

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/sysutils/gpm.xml

    r09f0998 rb1532549  
    3030    <title>Introduction to GPM</title>
    3131
    32     <para>The <application>GPM</application> (General Purpose Mouse
    33     daemon) package contains a mouse server for the console and
    34     <command>xterm</command>. It not only provides cut and paste support
    35     generally, but its library component is used by various software such as
    36     <application>Links</application> to provide mouse support to the application.
    37     It is useful on desktops, especially if following (Beyond) Linux From Scratch
    38     instructions; it's often much easier (and less error prone) to cut and paste
    39     between two console windows than to type everything by hand!</para>
     32    <para>
     33      The <application>GPM</application> (General Purpose Mouse daemon)
     34      package contains a mouse server for the console and
     35      <command>xterm</command>. It not only provides cut and paste support
     36      generally, but its library component is used by various software such as
     37      <application>Links</application> to provide mouse support to the
     38      application.  It is useful on desktops, especially if following (Beyond)
     39      Linux From Scratch instructions; it's often much easier (and less error
     40      prone) to cut and paste between two console windows than to type
     41      everything by hand!
     42    </para>
    4043
    4144    &lfs91_checked;
    … …  
    4447    <itemizedlist spacing="compact">
    4548      <listitem>
    46         <para>Download (HTTP): <ulink url="&gpm-download-http;"/></para>
    47       </listitem>
    48       <listitem>
    49         <para>Download (FTP): <ulink url="&gpm-download-ftp;"/></para>
    50       </listitem>
    51       <listitem>
    52         <para>Download MD5 sum: &gpm-md5sum;</para>
    53       </listitem>
    54       <listitem>
    55         <para>Download size: &gpm-size;</para>
    56       </listitem>
    57       <listitem>
    58         <para>Estimated disk space required: &gpm-buildsize;</para>
    59       </listitem>
    60       <listitem>
    61         <para>Estimated build time: &gpm-time;</para>
     49        <para>
     50          Download (HTTP): <ulink url="&gpm-download-http;"/>
     51        </para>
     52      </listitem>
     53      <listitem>
     54        <para>
     55          Download (FTP): <ulink url="&gpm-download-ftp;"/>
     56        </para>
     57      </listitem>
     58      <listitem>
     59        <para>
     60          Download MD5 sum: &gpm-md5sum;
     61        </para>
     62      </listitem>
     63      <listitem>
     64        <para>
     65          Download size: &gpm-size;
     66        </para>
     67      </listitem>
     68      <listitem>
     69        <para>
     70          Estimated disk space required: &gpm-buildsize;
     71        </para>
     72      </listitem>
     73      <listitem>
     74        <para>
     75          Estimated build time: &gpm-time;
     76        </para>
    6277      </listitem>
    6378    </itemizedlist>
    … …  
    100115
    101116
    102     <para>Install <application>GPM</application> by running
    103     the following commands:</para>
     117    <para>
     118      Install <application>GPM</application> by running
     119      the following commands:
     120    </para>
    104121
    105122<screen><userinput>sed -i -e 's:&lt;gpm.h&gt;:"headers/gpm.h":' src/prog/{display-buttons,display-coords,get-versions}.c &amp;&amp;
    … …  
    109126make</userinput></screen>
    110127
    111     <para>This package does not come with a test suite.</para>
    112 
    113     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     128    <para>
     129      This package does not come with a test suite.
     130    </para>
     131
     132    <para>
     133      Now, as the <systemitem class="username">root</systemitem> user:
     134    </para>
    114135
    115136<screen role="root"><userinput>make install                                          &amp;&amp;
    … …  
    132153    <title>Command Explanations</title>
    133154
    134     <para><command>./autogen.sh</command>: This command creates the missing
    135     <command>configure</command> script.</para>
    136 
    137     <para><command>install-info ...</command>: This package installs an
    138     <filename class="extension">.info</filename> file, but does not update the
    139     system <filename>dir</filename> file. This command makes the update.</para>
    140 
    141     <para><command>ln -v -sfn libgpm.so.2.1.0 /usr/lib/libgpm.so</command>: This
    142     command is used to create (or update) the <filename class="extension">.so</filename>
    143     symlink to the library.</para>
     155    <para>
     156      <command>./autogen.sh</command>: This command creates the missing
     157      <command>configure</command> script.
     158    </para>
     159
     160    <para>
     161      <command>install-info ...</command>: This package installs a
     162      <filename class="extension">.info</filename> file, but does not update
     163      the system <filename>dir</filename> file. This command makes the update.
     164    </para>
     165
     166    <para>
     167      <command>ln -v -sfn libgpm.so.2.1.0 /usr/lib/libgpm.so</command>: This
     168      command is used to create (or update) the <filename
     169      class="extension">.so</filename> symlink to the library.
     170    </para>
    144171
    145172  </sect2>
    … …  
    156183      </indexterm>
    157184
    158       <para revision="sysv">Install the
    159       <filename>/etc/rc.d/init.d/gpm</filename> init script included in the
    160       <xref linkend="bootscripts"/> package.</para>
     185      <para revision="sysv">
     186        Install the
     187        <filename>/etc/rc.d/init.d/gpm</filename> init script included in the
     188        <xref linkend="bootscripts"/> package.
     189      </para>
    161190
    162191      <para revision="systemd">
    … …  
    174203      <title>Config Files</title>
    175204
    176       <para><filename>/etc/gpm-root.conf</filename> and
    177       <filename>~/.gpm-root</filename>: The default and individual user
    178       <command>gpm-root</command> configuration files.</para>
    179 
    180       <para revision="sysv"><filename>/etc/sysconfig/mouse</filename>:
    181       This file contains the name of your mouse device and the protocol
    182       it uses.  To create this file, run the following as the
    183       <systemitem class="username">root</systemitem> user:</para>
     205      <para>
     206        <filename>/etc/gpm-root.conf</filename> and
     207        <filename>~/.gpm-root</filename>: The default and individual user
     208        <command>gpm-root</command> configuration files.
     209      </para>
     210
     211      <para revision="sysv">
     212        <filename>/etc/sysconfig/mouse</filename>:
     213        This file contains the name of your mouse device and the protocol
     214        it uses.  To create this file, run the following as the
     215        <systemitem class="username">root</systemitem> user:
     216      </para>
    184217
    185218<screen role="root" revision="sysv"><userinput>cat &gt; /etc/sysconfig/mouse &lt;&lt; "EOF"
    … …  
    210243      <title>Configuration Information</title>
    211244
    212       <para revision="sysv">Examples of values to set <envar>MDEVICE</envar>,
    213       <envar>PROTOCOL</envar>, and <envar>GPMOPTS</envar> to are:</para>
     245      <para revision="sysv">
     246        Examples of values to set <envar>MDEVICE</envar>,
     247        <envar>PROTOCOL</envar>, and <envar>GPMOPTS</envar> to are:
     248      </para>
    214249
    215250<screen revision="sysv"><literal>MDEVICE="/dev/input/mice"
    … …  
    217252GPMOPTS=""</literal></screen>
    218253
    219       <para revision="sysv">A list of which protocol values are known can be
    220       found by running
    221       <command>gpm -m <replaceable>[device]</replaceable> -t -help</command>.
    222       The <envar>MDEVICE</envar> setting depends on which type of mouse you
    223       have.  For example, <filename>/dev/ttyS0</filename> for a serial mouse
    224       (on Windows this is COM1), <filename>/dev/input/mice</filename> is often
    225       used for USB mice and <filename>/dev/psaux</filename> for PS2 mice.
    226       <envar>GPMOPTS</envar> is the 'catch all' for any additional options that
    227       are needed for your hardware.</para>
     254      <para revision="sysv">
     255        A list of which protocol values are known can be found by running
     256        <command>gpm -m <replaceable>[device]</replaceable> -t -help</command>.
     257        The <envar>MDEVICE</envar> setting depends on which type of mouse you
     258        have.  For example, <filename>/dev/ttyS0</filename> for a serial mouse
     259        (on Windows this is COM1), <filename>/dev/input/mice</filename> is
     260        often used for USB mice and <filename>/dev/psaux</filename> for PS2
     261        mice. <envar>GPMOPTS</envar> is the 'catch all' for any additional
     262        options that are needed for your hardware.
     263      </para>
    228264
    229265      <para revision="systemd">
    … …  
    270306        <term><command>disable-paste</command></term>
    271307        <listitem>
    272           <para>is a security mechanism used to disable the paste buffer.</para>
     308          <para>
     309            is a security mechanism used to disable the paste buffer.
     310          </para>
    273311          <indexterm zone="gpm disable-paste">
    274312            <primary sortas="b-disable-paste">disable-paste</primary>
    … …  
    280318        <term><command>display-buttons</command></term>
    281319        <listitem>
    282           <para>is a simple program that reports the mouse buttons being
    283           pressed and released.</para>
     320          <para>
     321            is a simple program that reports the mouse buttons being
     322            pressed and released.
     323          </para>
    284324          <indexterm zone="gpm display-buttons">
    285325            <primary sortas="b-display-buttons">display-buttons</primary>
    … …  
    291331        <term><command>display-coords</command></term>
    292332        <listitem>
    293           <para>is a simple program that reports the mouse coordinates.</para>
     333          <para>
     334            is a simple program that reports the mouse coordinates.
     335          </para>
    294336          <indexterm zone="gpm display-coords">
    295337            <primary sortas="b-display-coords">display-coords</primary>
    … …  
    301343        <term><command>get-versions</command></term>
    302344        <listitem>
    303           <para>is used to report the <application>GPM</application> library
    304           and server versions.</para>
     345          <para>
     346            is used to report the <application>GPM</application> library
     347            and server versions.
     348          </para>
    305349          <indexterm zone="gpm get-versions">
    306350            <primary sortas="b-get-versions">get-versions</primary>
    … …  
    312356        <term><command>gpm</command></term>
    313357        <listitem>
    314           <para>is a cut and paste utility and mouse server for virtual consoles.</para>
     358          <para>
     359            is a cut and paste utility and mouse server for virtual consoles.
     360          </para>
    315361          <indexterm zone="gpm gpm-prog">
    316362            <primary sortas="b-gpm">gpm</primary>
    … …  
    322368        <term><command>gpm-root</command></term>
    323369        <listitem>
    324           <para>is a default handler for <command>gpm</command>. It is used to
    325           draw menus on the root window.</para>
     370          <para>
     371            is a default handler for <command>gpm</command>. It is used to
     372            draw menus on the root window.
     373          </para>
    326374          <indexterm zone="gpm gpm-root">
    327375            <primary sortas="b-gpm-root">gpm-root</primary>
    … …  
    333381        <term><command>hltest</command></term>
    334382        <listitem>
    335           <para>is a simple sample application using the high-level library,
    336           meant to be read by programmers trying to use the high-level library.</para>
     383          <para>
     384            is a simple sample application using the high-level library, meant
     385            to be read by programmers trying to use the high-level library.
     386          </para>
    337387          <indexterm zone="gpm hltest">
    338388            <primary sortas="b-hltest">hltest</primary>
    … …  
    344394        <term><command>mev</command></term>
    345395        <listitem>
    346           <para>is a program to report mouse events.</para>
     396          <para>
     397            is a program to report mouse events.
     398          </para>
    347399          <indexterm zone="gpm mev">
    348400            <primary sortas="b-mev">mev</primary>
    … …  
    354406        <term><command>mouse-test</command></term>
    355407        <listitem>
    356           <para>is a tool for determining the mouse type and device it's
    357           attached to.</para>
     408          <para>
     409            is a tool for determining the mouse type and device it's
     410            attached to.
     411          </para>
    358412          <indexterm zone="gpm mouse-test">
    359413            <primary sortas="b-mouse-test">mouse-test</primary>
    … …  
    365419        <term><filename class='libraryfile'>libgpm.{so.a}</filename></term>
    366420        <listitem>
    367           <para>contains the API functions to access the
    368           <application>GPM</application> daemon.</para>
     421          <para>
     422            contains the API functions to access the
     423            <application>GPM</application> daemon.
     424          </para>
    369425          <indexterm zone="gpm libgpm">
    370426            <primary sortas="c-libgpm">libgpm.{so,a}</primary>
Note: See TracChangeset for help on using the changeset viewer.