home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat1 / xset.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  9.7 KB  |  265 lines
  1.  
  2.  
  3.  
  4. XSET(1)                              XSET(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        xset - user preference utility for X
  9.  
  10. SSYYNNOOPPSSIISS
  11.        xxsseett  [-display _d_i_s_p_l_a_y] [-b] [b on/off] [b [_v_o_l_u_m_e [_p_i_t_c_h
  12.        [_d_u_r_a_t_i_o_n]]]  [[-]bc]  [-c]  [c     on/off]   [c    [_v_o_l_u_m_e]]
  13.        [[-+]fp[-+=]  _p_a_t_h[,_p_a_t_h[,...]]]     [fp default] [fp rehash]
  14.        [[-]led       [_i_n_t_e_g_e_r]]      [led        on/off]     [m[ouse]
  15.        [_a_c_c_e_l___m_u_l_t[/_a_c_c_e_l___d_i_v] [_t_h_r_e_s_h_o_l_d]]] [m[ouse] default] [p
  16.        _p_i_x_e_l  _c_o_l_o_r]  [[-]r  [keycode]]     [r  on/off]  [s  [_l_e_n_g_t_h
  17.        [_p_e_r_i_o_d]]]   [s     blank/noblank]     [s  expose/noexpose]  [s
  18.        on/off] [s default] [s activate] [s reset] [q]
  19.  
  20. DDEESSCCRRIIPPTTIIOONN
  21.        This program  is     used  to  set    various     user  preference
  22.        options of the display.
  23.  
  24. OOPPTTIIOONNSS
  25.        --ddiissppllaayy _d_i_s_p_l_a_y
  26.            This option specifies the server to use; see _X_(_1_).
  27.  
  28.  
  29.        bb       The bb option controls bell volume, pitch and dura-
  30.            tion.   This  option accepts up to three numerical
  31.            parameters, a preceding    dash(-),  or  a     'on/off'
  32.            flag.   If  no  parameters  are given, or the 'on'
  33.            flag is used, the system defaults  will    be  used.
  34.            If  the    dash or 'off' are given, the bell will be
  35.            turned off.  If only one     numerical  parameter  is
  36.            given,  the bell volume will be set to that value,
  37.            as a percentage of  its    maximum.   Likewise,  the
  38.            second  numerical  parameter  specifies    the  bell
  39.            pitch, in hertz, and the third numerical parameter
  40.            specifies the duration in milliseconds.    Note that
  41.            not all hardware can vary  the  bell  characteris-
  42.            tics.   The  X server will set the characteristics
  43.            of the bell as closely as it  can  to  the  user's
  44.            specifications.
  45.  
  46.  
  47.        bbcc      The  bbcc    option controls _b_u_g _c_o_m_p_a_t_i_b_i_l_i_t_y mode in
  48.            the server, if possible; a preceding dash(-)  dis-
  49.            ables  the  mode,  otherwise  the mode is enabled.
  50.            Various pre-R4 clients pass illegal values in some
  51.            protocol requests, and pre-R4 servers did not cor-
  52.            rectly  generate     errors     in  these  cases.   Such
  53.            clients,     when run against an R4 server, will ter-
  54.            minate abnormally or  otherwise    fail  to  operate
  55.            correctly.    Bug  compatibility     mode  explicitly
  56.            reintroduces certain bugs into the  X  server,  so
  57.            that  many  such     clients  can still be run.  This
  58.            mode should be used  with  care;     new  application
  59.            development  should  be    done  with this mode dis-
  60.            abled.  The server must    support     the  MIT-SUNDRY-
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XSET(1)                              XSET(1)
  71.  
  72.  
  73.            NONSTANDARD  protocol  extension in order for this
  74.            option to work.
  75.  
  76.        cc       The cc option controls key click.     This option  can
  77.            take an optional value, a preceding dash(-), or an
  78.            'on/off' flag.  If no parameter or the  'on'  flag
  79.            is given, the system defaults will be used. If the
  80.            dash or 'off' flag is used, keyclick will be  dis-
  81.            abled.    If  a value from 0 to 100 is given, it is
  82.            used to indicate volume, as a  percentage  of  the
  83.            maximum.      The X server will set the volume to the
  84.            nearest value that the hardware can support.
  85.  
  86.  
  87.        ffpp== _p_a_t_h_,_._._.
  88.            The ffpp== sets the font path to the entries given in
  89.            the path argument.  The entries are interpreted by
  90.            the server, not by the client.  Typically they are
  91.            directory  names     or  font  server  names, but the
  92.            interpretation is server-dependent.
  93.  
  94.        ffpp ddeeffaauulltt
  95.            The ddeeffaauulltt argument causes the font  path  to  be
  96.            reset to the server's default.
  97.  
  98.        ffpp rreehhaasshh
  99.            The  rreehhaasshh  argument  resets the font path to its
  100.            current value, causing the server  to  reread  the
  101.            font  databases in the current font path.  This is
  102.            generally only used when adding    new  fonts  to    a
  103.            font  directory (after running _m_k_f_o_n_t_d_i_r to recre-
  104.            ate the font database).
  105.  
  106.  
  107.        --ffpp or ffpp--
  108.            The --ffpp and ffpp-- options remove elements    from  the
  109.            current    font  path.   They  must be followed by a
  110.            comma-separated list of entries.
  111.  
  112.  
  113.        ++ffpp or ffpp++
  114.            This ++ffpp and ffpp++ options prepend and  append  ele-
  115.            ments  to  the  current    font  path, respectively.
  116.            They must be followed by a comma-separated list of
  117.            entries.
  118.  
  119.  
  120.        lleedd     The  lleedd     option controls the keyboard LEDs.  This
  121.            controls the turning on or off of one  or  all  of
  122.            the  LEDs.  It accepts an optional integer, a pre-
  123.            ceding dash(-) or an 'on/off' flag.  If no parame-
  124.            ter or the 'on' flag is given, all LEDs are turned
  125.            on.  If a preceding dash     or  the  flag    'off'  is
  126.            given,  all  LEDs  are  turned  off.   If  a value
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XSET(1)                              XSET(1)
  137.  
  138.  
  139.            between 1 and 32 is given, that LED will be turned
  140.            on  or off depending on the existence of a preced-
  141.            ing dash.  A common LED which can be controlled is
  142.            the  ``Caps Lock'' LED.    ``xset led 3'' would turn
  143.            led #3 on.  ``xset -led 3''  would  turn     it  off.
  144.            The  particular    LED values may refer to different
  145.            LEDs on different hardware.
  146.  
  147.  
  148.        mm       The mm option controls the mouse    parameters.   The
  149.            parameters  for    the  mouse are `acceleration' and
  150.            `threshold'.  The acceleration can be specified as
  151.            an  integer,  or as a simple fraction.  The mouse,
  152.            or whatever pointer the machine is  connected  to,
  153.            will go `acceleration' times as fast when it trav-
  154.            els more than `threshold' pixels in a short  time.
  155.            This way, the mouse can be used for precise align-
  156.            ment when it is moved slowly, yet it can be set to
  157.            travel  across  the screen in a flick of the wrist
  158.            when desired.  One or both parameters  for  the    mm
  159.            option  can  be omitted, but if only one is given,
  160.            it will be interpreted as the acceleration.  If no
  161.            parameters or the flag 'default' is used, the sys-
  162.            tem defaults will be set.
  163.  
  164.  
  165.        pp       The pp option controls  pixel  color  values.   The
  166.            parameters are the color map entry number in deci-
  167.            mal, and a color specification.     The  root  back-
  168.            ground  colors  may  be changed on some servers by
  169.            altering      the    entries      for    BlackPixel    and
  170.            WhitePixel.   Although  these  are  often 0 and 1,
  171.            they need not be.  Also, a server  may  choose  to
  172.            allocate     those colors privately, in which case an
  173.            error will be generated.     The map entry    must  not
  174.            be a read-only color, or an error will result.
  175.  
  176.  
  177.        rr       The  rr  option controls the autorepeat.    If a pre-
  178.            ceding dash or the 'off' flag is used,  autorepeat
  179.            will  be     disabled.   If no parameters or the 'on'
  180.            flag is used, autorepeat will be     enabled.   If    a
  181.            specific     keycode  is  specified     as  a parameter,
  182.            autorepeat for that keycode  is    enabled     or  dis-
  183.            abled.
  184.  
  185.  
  186.        ss       The ss option lets you set the screen saver parame-
  187.            ters.  This option accepts  up  to  two    numerical
  188.            parameters,    a       'blank/noblank'    flag,    an
  189.            'expose/noexpose'  flag,     an  'on/off'  flag,   an
  190.            'activate/reset'     flag, or the 'default' flag.  If
  191.            no parameters or the 'default' flag is  used,  the
  192.            system  will  be     set  to its default screen saver
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XSET(1)                              XSET(1)
  203.  
  204.  
  205.            characteristics.     The 'on/off' flags  simply  turn
  206.            the  screen saver functions on or off.  The 'acti-
  207.            vate' flag forces activation of screen saver  even
  208.            if  the    screen    saver  had  been turned off.  The
  209.            'reset' flag forces deactivation of  screen  saver
  210.            if  it is active.  The 'blank' flag sets the pref-
  211.            erence to blank the video (if the hardware can  do
  212.            so)  rather  than  display  a  background pattern,
  213.            while 'noblank' sets the preference to  display    a
  214.            pattern rather than blank the video.  The 'expose'
  215.            flag sets the preference to allow window exposures
  216.            (the  server  can freely discard window contents),
  217.            while 'noexpose' sets the  preference  to  disable
  218.            screen  saver unless the server can regenerate the
  219.            screens    without     causing  exposure  events.   The
  220.            length  and period parameters for the screen saver
  221.            function determines how long the     server     must  be
  222.            inactive     for  screen  saving to activate, and the
  223.            period to change the background pattern    to  avoid
  224.            burn  in.  The arguments are specified in seconds.
  225.            If only one numerical parameter is given, it  will
  226.            be used for the length.
  227.  
  228.  
  229.        qq       The  qq option gives you information on the current
  230.            settings.
  231.  
  232.        These settings will be reset to default    values    when  you
  233.        log out.
  234.  
  235.        Note  that  not    all  X    implementations are guaranteed to
  236.        honor all of these options.
  237.  
  238. SSEEEE AALLSSOO
  239.        X(1), Xserver(1), xmodmap(1), xrdb(1), xsetroot(1)
  240.  
  241. AAUUTTHHOORR
  242.        Bob Scheifler, MIT Laboratory for Computer Science
  243.        David Krikorian, MIT Project Athena (X11 version)
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. X Version 11           Release 6.1                4
  263.  
  264.  
  265.