


()                                                             ()



























































                                                                1





RXVT(1.11)                                             RXVT(1.11)


NNAAMMEE
       rxvt - VT100 emulator for the X window system

SSYYNNOOPPSSIISS
       rrxxvvtt [ _o_p_t_i_o_n_s ]

DDEESSCCRRIIPPTTIIOONN
       _R_x_v_t  is  a VT100 terminal emulator for X.  It is intended
       as a replacement for _x_t_e_r_m(1) for users who do not require
       the  more  esoteric  features of _x_t_e_r_m.  Specifically _r_x_v_t
       does not implement the Tektronix 4014  emulation,  session
       logging  and  toolkit style configurability.  As a result,
       _r_x_v_t uses much less swap space than _x_t_e_r_m - a  significant
       advantage on a machine serving many X sessions.

OOPPTTIIOONNSS
       The options supported by _r_x_v_t (which are a subset of those
       supported by _x_t_e_r_m) are listed below.

       --ee _c_o_m_m_a_n_d [ _a_r_g_u_m_e_n_t_s ]
              Run the command with its command line arguments  in
              the _x_v_t window.  If this option is used, it must be
              the last on the command line.  If there  is  no  --ee
              option then the default is to run the program spec-
              ified by the SHELL environment variable or, failing
              that, _s_h(1).

       --ddiissppllaayy _d_i_s_p_l_a_y_-_n_a_m_e
              Attempt  to open the _x_v_t window on the named X dis-
              play.  In the absence if this option,  the  display
              specified  by  the  DISPLAY environment variable is
              used.

       --ggeeoommeettrryy _w_i_n_d_o_w_-_g_e_o_m_e_t_r_y
              Create the window with the specified X window geom-
              etry.

       --bbgg _c_o_l_o_r
              Use  the specified color as the window's background
              color.

       --ffgg _c_o_l_o_r
              Use the specified colour as the window's foreground
              color.

       --ffoonntt _f_o_n_t_n_a_m_e
              Set the main text font used by _r_x_v_t.

       --ffbb _f_o_n_t_n_a_m_e
              Set  the  font  used  for  the vt100 bold rendition
              style.  Unlike _x_t_e_r_m, the current version  of  _r_x_v_t
              will not try and create bold text by displacing and
              _o_r'ing an ordinary font and so, if  you  want  bold
              highlighting  to  work, you need to use this option



                           21 July 1993                         1





RXVT(1.11)                                             RXVT(1.11)


              to specify a suitable bold font.

       --TT _t_e_x_t
              Set the string that is displayed  in  the  window's
              title bar if it has one.

       --nn _t_e_x_t
              Set  the  name  that will be used to label the win-
              dow's icon or displayed in an icon manager  window.
              This  option also sets the window's title unless it
              is set expicitely.

       --CC     Capture system console messages.

       --77     Run in 7 bit   mode, stripping the 8th bit from all
              character typed on the keyboard.

       --88     Run  in  8  bit clean mode, allowing the use of the
              meta-key to set the 8th bit of characters typed  at
              the keyboard.

       --llss    Prepend a "-" to argv[0] of the shell which is ini-
              tiated for the window, causing it  to  be  a  login
              shell.

       --llss--   Do  not prepend a "-" to argv[0] of the shell which
              is initiated for the window, causing  it  to  be  a
              regular  shell.  Used only to over-ride a resources
              setting.

        --ffaatt  Use an xterm-style fat scrollbar instead of  rxvt's
              native thin scrollbar.

        --tthhiinn Use  rxvt's  native  thin scrollbar, no matter what
              the resources say.


XX RREESSOOUURRCCEESS
       rrxxvvtt accepts resources set in each users ~/.Xdefaults, and
       probably  from  a  few  dozen  other  places  too.  If  no
       resources are specified, suitable defaults will  be  used.
       Command  line arguments can be used to over-ride resources
       settings. The following resources are allowed:

       rrxxvvtt..ccoommmmaanndd:: _c_o_m_m_a_n_d [ _a_r_g_u_m_e_n_t_s ]
              The same as command line argument -e.

       rrxxvvtt..ggeeoommeettrryy:: _w_i_n_d_o_w_-_g_e_o_m_e_t_r_y
              The same as command line argument -geometry.

       rrxxvvtt..bbaacckkggrroouunndd:: _c_o_l_o_r
              The same as command line argument -bg.





                           21 July 1993                         2





RXVT(1.11)                                             RXVT(1.11)


       rrxxvvtt..ffoorreeggrroouunndd:: _c_o_l_o_r
              The same as command line argument -fg.

       rrxxvvtt..ffoonntt:: _f_o_n_t_n_a_m_e
              The same as command line argument -font.

       rrxxvvtt..bboollddffoonntt:: _f_o_n_t_n_a_m_e
              The same as command line argument -fb.

       rrxxvvtt..ttiittllee:: _t_e_x_t
              The same as command line argument -T.

       rrxxvvtt..iiccoonn__nnaammee:: _t_e_x_t
              The same as command line argument -n.

       rrxxvvtt..bbiittss:: _t_e_x_t
              _t_e_x_t must be 7 or 8. 7 is the same as command  line
              option -7, and 8 is the same as -8.

       rrxxvvtt..llooggiinn__sshheellll:: _t_e_x_t
              _t_e_x_t  must  be  True  or False. True is the same as
              -ls, and False is the same as -ls-.

       rrxxvvtt..ssccrroollllbbaarr:: _t_e_x_t
              _t_e_x_t must be Fat  or Thin. Fat is the same as -fat,
              and thin is the same as -thin.




TTIITTLLEESS AANNDD IICCOONN NNAAMMEESS
       One  occasionally  confusing  aspect  of  _r_x_v_t and other X
       applications is the collection of names that  an  applica-
       tion  window  can  have  and  the relationship between the
       names and the command line options used to set them.  This
       section  attempts  to  make the situation a bit clearer in
       the case of _r_x_v_t.

       In fact, each terminal window has two names: its title and
       its  icon name.  These names are distinct and have differ-
       ent functions, although they usually have the same  value.
       The  title is the text that is displayed in the title bar,
       if there is one, and  the  icon  name  is  the  name  that
       appears  in the window's icon or represents it in the icon
       manager window.

TTHHEE SSCCRROOLLLL BBAARR
       Lines of text that scroll off the top of the  _r_x_v_t  window
       are  saved  automatically  (up to a preset maximum number)
       and can be viewed by scrolling them back into  the  window
       with the scrollbar.

   TThhee rrxxvvtt--ssttyyllee ssccrroollll bbaarr
       Pressing a  mouse button while in the scrollbar will cause



                           21 July 1993                         3





RXVT(1.11)                                             RXVT(1.11)


       the window contents  to  scroll  continuously  with  mouse
       motion.

       Pressing  the  up  or down arrows which are at the top and
       bottom of the scroll bar, will cause the window to  scroll
       by almost a full screen.


   TThhee xxtteerrmm--ssttyyllee ssccrroollll bbaarr
       If  the -fat option has been selected, an xterm-compatible
       scroll bar is used instead of the rxvt-style scroll bar.

       Pressing a mouse button 2  while  in  the  scrollbar  will
       cause  the  window  contents  to  scroll continuously with
       mouse motion.

       Pressing mouse button 1 will move the line adjacent to the
       pointer to the top of the display window.

       Pressing  mouse  button 2 will move the line at the top of
       the display window to a position adjacent to the  pointer.


TTEEXXTT SSEELLEECCTTIIOONN AANNDD IINNSSEERRTTIIOONN
       _r_x_v_t  uses  a similar kind of text selection and insertion
       mechanism to _x_t_e_r_m.  Pressing  and  releasing  the  middle
       mouse  button  in  an  _r_x_v_t window causes the current text
       selection to be inserted as if it had been  typed  on  the
       keyboard.   For the insertion to take place, both the but-
       ton press and the button release need to be done with  the
       cursor in the _r_x_v_t window.

       The  left and right mouse buttons are used to select text.
       A text selection starts at the point  where  the  left  or
       right button is pressed, and ends at the point where it is
       released. Rxvt does not support word and line selection by
       double clicking.

BBUUGGSS
        _r_x_v_t_-_1_._2 had 2 bugs, but _r_x_v_t_-_1_._3 is bug-free.

AAUUTTHHOORR
       John  Bovey, University of Kent, 1992.  Very heavily modi-
       fied by Rob Nation (nation@rocket.sanders.lockheed.com)













                           21 July 1993                         4


