doc/pty-fd
doc/etc/rxvt-unicode.terminfo
doc/etc/rxvt-unicode.termcap
-doc/menu/example.menu
-doc/menu/jedmenu.sl
-doc/menu/menu
-doc/menu/rxvt.menu
-doc/menu/rxvt.zh-menu
-doc/menu/terminal.menu
doc/solaris9.patch
doc/.cvsignore
doc/Makefile.in
-doc/README.menu
doc/README.xvt
doc/changes.txt
doc/podtbl
You can specify separate locales for the input method and the rest
of the terminal, using the resource "imlocale":
- URxvt*imlocale: ja_JP.EUC-JP
+ URxvt.imlocale: ja_JP.EUC-JP
Now you can start your terminal with "LC_CTYPE=ja_JP.UTF-8" and
still use your input method. Please note, however, that you will not
+++ /dev/null
-A few examples of constructing menubars for rxvt. Used in conjuction
-with the reference material (rxvtRef.html/txt), it should be possible to
-piece together some useful menus without too much time.
-
-C-shell users be warned.
-Some of the menu items contain bsh/ksh constructs like ${EDITOR:-vi}\r
-which will cause your shell to gag.
-----------------------------------------------------------------------
-
-example.menu:
- simple menus for Pico and the Shell
-
-jedmenu.sl:
- (almost) self-contained SLang code for loading up a menubar
- for the Jed editor. It doesn't need terminal.menu,
- but looks a bit better with it.
-
- Note for JED users:
- since rxvt provides an escape sequence to override the
- normal XTerm interpretation of Shift-Insert/Prev/Next,
- "wmark.sl" (MS-windows-style shift marking) works really
- well and is a nice bonus for those forced to switch
- to/from MS-windows
-
-terminal.menu
- common rxvt terminal functions used by the other menus
-
-menu:
- a small shell script to reduce the pain of typing
- echo "ESC]10; ... BEL" for every menubar command.
- It also contains a sample "default" menu at the bottom.
-
-rxvt.menu:
- A nice script that allows a convenient way to have different
- menubars used for rlogin|telnet to a machine.
- Of course to get it to work, you'll need to add your own
- machine names (and remove mine).
-
- The script is set up so that "rxvt" will be called if the first
- argument to the script does not contain "rxvt".
- So
- rxvt.menu [options]
- is the same as
- rxvt.menu rxvt [options]
-
- To always have this script act as the front-end for rxvt:
- 1) install the rxvt binary somewhere not in your path
- 2) set the `exe' in menu.script to point to this binary
- eg,
- exe="/usr/local/X11/rxvt-2.21/rxvt"
- # default program to execute
- 3) have rxvt.menu linked somewhere in your path as `rxvt'
- 4) add all the various machines/menus combinations to
- rxvt.menu, or else make a separate database and change
- the `menu' variable in rxvt.menu to suit.
+++ /dev/null
-This example illustrates how several menus could be combined together
-
-command = "[read:example]"
-
- read the file starting at "[menu]" or "[menu:???]"
- and continue until it "[done]"
-
-command = "[read:example;pico]" or "[read:example;shell]"
-
- read the file starting at "[menu:pico]" or "[menu:shell]",
- respectively and continue until "[done:pico]" or [done:shell]",
- respectively.
-
-#-------------------------------------------------------------------------
-
-[menu:pico]
-[clear]
-[title:Pico (%n-%v)]
-
-# a menu for the pico editor
-# mostly a demonstration, I don't know why anyone would need it
-
-# Prior/Next & Home/End are messed up
-<l>^A<r>^E<u>^Y<d>^V
-
-/File/*
-{Insert File}{^R}
-{Save As}{^O}
-{-}
-{Suspend}{^Z}
-{Exit}{^X}
-
-/Edit/*
-{Find}{^W}
-{-}
-{Del Char}{^D}
-{Mark}{^^}
-{Kill Line}{^K}
-{Paste}{^U}
-
-/Basics/*
-{Forward}{^F}
-{Backward}{^B}
-{-}
-{Prev}{^P}
-{Next}{^N}
-{-}
-{Beg-of-Line}{^A}
-{End-of-Line}{^E}
-{-}
-{Prev Page}{^Y}
-{Next Page}{^V}
-
-/Buffer/*
-{Reformat}{^J}
-{Position}{^C}
-{Refresh}{^L}
-{Spell}{^T}
-
-[read:terminal]
-
-/?/*
-{Help}{^G}
-
-[show]
-[done:pico]
-
-#-------------------------------------------------------------------------
-
-[menu:shell]
-[clear]
-[title:shell]
-# [pixmap:name]
-
-# not necessarily useful, but an example of using the rxvt menuBar
-
-# assuming we have ksh with Emacs bindings
-<u>^P<d>^N<r>^F<l>^B
-
-/Programs/*
-{Edit} ${EDITOR:-vi}\r
-{Mail} Mail\r
-{News} slrn\r
-{Rxvt-News} rxvt -e slrn&
-{Commander} mc\r
-
-/Shell/{finger} finger\r
-{.name} invisible label!
-/
-
-[read:terminal]
-[show]
-[done:shell]
-
-#--------------------------------------------------------------------- eof
+++ /dev/null
-%--------------------------------*-SLang-*--------------------------------
-% An example of using the rxvt menuBar for the JED editor
-#if$TERM xterm*
-%!% provide a hook to imitated the S-Lang> prompt
-%!% use ESC[m to shadow the ESC[M used by mouse reporting
-define menuFn ()
-{
- variable ch, cmd;
-
- cmd = Null_String;
- forever
- {
- ch = getkey ();
- if (ch == '\r') break;
- cmd = strcat (cmd, char (ch));
- }
- eval (cmd);
-}
-local_setkey ("menuFn", "\e[m"); % menu
-
-%!% allow the user to bind their owm commands
-define menucmd (str) { tt_send (Sprintf ("\e]10;%s\a", str, 1)); }
-%-------------------------------------------------------------------------
-% integrate these with any existing suspend/resume/exit hooks
-% the suspend hook works best if there was already a menu defined
-% before invoking JED
-
-define suspend_hook () { menucmd ("[prev]"); }
-define resume_hook () { menucmd ("[next]"); }
-define exit_hook () { menucmd ("[rm]"); exit_jed (); }
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-menucmd ("[read:jedmenu.sl]"); % read this file
-
-% format _jed_version xyyzz into x.yy-zz
-menucmd (Sprintf ("[:[title:Jed%d.%d-%d (%%n-%%v)]:]",
- (_jed_version/10000),
- ((_jed_version mod 10000)/100),
- (_jed_version mod 100),
- 3));
-
-% get rid off pixmap stuff
-if (strcmp (getenv ("COLORTERM"), "rxvt-xpm"))
-{
- menucmd ("[menu][:-/Terminal/Pixmap:][show]");
-}
-#endif % xterm*
-%%%%%%%%%%%%%%%%%%%%%%%%%%% end-of-file (SLang) %%%%%%%%%%%%%%%%%%%%%%%%%%
-% rxvt menu database
-#iffalse
-% An example of using the rxvt menuBar for the JED editor
-% possibly useful things for the JED editor -- assuming Emacs bindings
-
-[menu:jed]
-
-[title:Jed menu (%n-%v)]
-% some convenient arrows
-<b>\E[m<l>bskip_word<u>backward_paragraph<d>forward_paragraph<r>skip_word<e>\r
-
-/File/*
-{Open}{^X^F}
-{Save}{^X^W}
-{Save Buffers}{^Xs}
-{Insert File}{^Xi}
-{-}
-{Shell Cmd}{M-!}
-{-}
-{Exit}{^X^C}
-
-/Edit/*
-{Undo}{^_}
-{-}
-{Cut}{^W}
-{Copy}{M-W}
-{Paste}{^Y}
-
-/Search/*
-{Forward}{^S}
-{Backward}{^R}
-{Replace}{M-%}
-{-}
-./Regexp/*
-{Forward}{M-^S}
-{Backward}{M-^R}
-{Replace} \E[mquery_replace_match\r
-
-/Buffers/*
-{Kill}{^Xk}
-{List}{^X^B}
-{Switch}{^Xb}
-{-}
-./Modes/*
-{C} \E[mc_mode\r
-{SLang} \E[mslang_mode\r
-{None} \E[mno_mode\r
-{LaTeX} \E[mlatex_mode\r
-{Text} \E[mtext_mode\r
-{Fortran} \E[mfortran_mode\r
-
-/Window/*
-{Delete}{^X0}
-{One}{^X1}
-{Split}{^X2}
-{Other}{^Xo}
-{-}
-{Recenter}{^L}
-{-}
-./Color Schemes/*
-{White-on-Black} \E[mset_color_scheme("15;0")\r
-{Black-on-White} \E[mset_color_scheme("0;15")\r
-{White-on-default-Black}\E[mset_color_scheme("15;default;0")\r
-{Black-on-default-White}\E[mset_color_scheme("0;default;15")\r
-
-/Utils/*
-{Bufed} \E[mbufed\r
-{Dired} \E[mdired\r
-{Mail} \E[mmail\r
-{Rmail} \E[mrmail\r
-{-}
-{EvalBuffer} \E[mevalbuffer\r
-{Trim-Buffer} \E[mtrim_buffer\r
-
-[read:terminal]
-
-/?/*
-{Info}{^X?i}
-{Man}{^X?m}
-{-}
-{Apropos}{^X?a}
-{Show Key}{^X?k}
-{Where Is}{^X?w}
-
-[show]
-[done]
-#endif
-%%%%%%%%%%%%%%%%%%%%%%%%%%% end-of-file (SLang) %%%%%%%%%%%%%%%%%%%%%%%%%%
+++ /dev/null
-#!/bin/sh --
-# shell wrapper to avoid typing Menu escape sequences
-if test $# -eq 0; then
-echo "\
-usage: `basename $0` cmd
-where the most common commands are
- [menu] [menu:name]
- [read:file] [read:file;name]
- [title:string]
- +/path/menu
- +/path/menu/*
- +/menu/path/{-}
- +/menu/path/{item}{rtext} action
-
- -/*
- -/path/menu
- -/path/menu/*
- -/path/{-}
- -/path/{item}
-
- <b>Begin<r>Right<l>Left<u>Up<d>Down<e>End
- [done]
-
- [rm] [rm:] [rm*] [rm:*] [rm:name]
- [swap] [prev] [next]
- [clear] [show] [hide]
- [pixmap:file]
- [dump]
-NB: commands may need to be quoted to avoid shell expansion
-"
-exit
-fi
-Echo="echo -n"
-# some systems/shells don't like `echo -n'
-case `/bin/uname` in
- SunOS) Echo="echo";;
-esac
-while [ $# -gt 0 ]
-do
- case $1 in
- +* | -* | '<'* | '['*) # send raw commands
- $Echo "\e]10;$1\a"
- ;;
-
- *) # read in menu files
- if test $1 = "default";
- then
- $Echo "\e]10;[read:$0]\a"
- else
- $Echo "\e]10;[read:$1]\a"
- fi
- if test "$COLORTERM" != "rxvt-xpm"; # remove pixmap stuff
- then
- $Echo "\e]10;[menu][:-/Terminal/Pixmap:][show]\a"
- fi
- ;;
- esac
- shift
-done
-exit # stop shell here!
-#-------------------------------------------------------------------------
-# since everything before a [menu] tag is ignored, we can put a default
-# menu here
-#-------------------------------------------------------------------------
-[menu:default]
-
-/Programs/*
-{Edit} ${EDITOR:-vi}\r
-{Top} top\r
-{Dir} ls -la|${PAGER:-more}\r
-{Dir-Time} ls -lat|${PAGER:-more}\r
-{Space Left} df\r
-{-}
-{Exit} exit\r
-
-/Shell/*
-{check mail} checkmail\r
-{Background} ^Z bg\r
-{Kill} ^C\r
-
-[show]
-[done]
-#--------------------------------------------------------------------- eof
+++ /dev/null
-#!/bin/sh --
-# an example of having different menus (even different pixmaps)
-# show up depending on the machine you are rlogin/telnet connecting to
-
-menu="$0" # or any convenient database
-exe="../../src/rxvt" # default program to execute
-# exe="/usr/local/bin/rxvt-2.21" # default program to execute
-
-if test $# -gt 0; then
- # if first argument contains "rxvt" use that instead
- case $1 in *rxvt*) exe="$1" shift;; esac
-fi
-
-while [ $# -gt 0 ]
-do
- case $1 in
- -h) # give usage
- echo "
-Usage: `basename $0` [rxvt-prgm] [options]
-
- start rxvt
- and load a menu corresponding to \"machine\" if the option
- -e {rlogin|telnet|tn3270} Machine.Domain ...
- was used"
- exit
- ;; # don't bother if we've already set it
-
- -menu) break;; # don't bother if we've already set it
-
- -e)
- if test $# -ge 3;
- then
- case $2 in
- # try to find menu for these cases
- *rlogin | *telnet | *tn3270)
- # strip domain & convert case
- mach=`echo $3 | sed -e 's/\..*$//' | tr [A-Z] [a-z]`
- if test ! -z "$mach";
- then
- found=`egrep "^\[menu:$mach\]" $menu`
- if test ! -z "$found";
- then
- mach="$menu;$mach"
- exe="$exe -menu $mach"
- fi
- fi
- ;;
- esac
- fi
- break
- ;;
-
- *)
- exe="$exe $1"
- ;;
- esac
- shift
-done
-
-# echo "$exe $@"
-$exe $@ &
-exit # stop shell here!
-#-------------------------------------------------------------------------
-[menu:weber]
-#[menu:machine1]
-[clear]
-# [pixmap:machine1.xpm]
-
-/Programs/*
-{Edit} ${EDITOR:-vi}\r
-{Mail} Mail\r
-{News} News\r
-{-}
-{Exit} exit\r
-
-/Jobs/*
-{Top} top\r
-{Ps u} ps aux|egrep ^$USER
-{Ps aux} ps aux|egrep -v "(root|ps)"
-# who's REALLY logged on (even with utmp logging turned off)
-{Who} ps aux|egrep "\-bash"|egrep -v "grep"
-{-}
-{Background} ^Z bg\r
-{Kill} ^C\r
-
-/Misc/*
-{Dir} ls -la|${PAGER:-more}\r
-{Dir-Time} ls -lat|${PAGER:-more}\r
-{Space Left} df\r
-
-[read:terminal]
-[show]
-#[done:machine1]
-[done:weber]
-
-#-------------------------------------------------------------------------
-[menu:conn]
-#[menu:machine2]
-[clear]
-# [pixmap:machine2.xpm]
-
-/Programs/*
-{Edit} ${EDITOR:-vi}\r
-{Checkmail} checkmail\r
-{Dir} ls -la|${PAGER:-more}\r
-{Dir-Time} ls -lat|${PAGER:-more}\r
-{Space Left} df\r
-{-}
-{Exit} exit\r
-
-/Jobs/*
-{Background} ^Z bg\r
-{Kill} ^C\r
-
-[read:terminal]
-[show]
-#[done:machine2]
-[done:conn]
-#--------------------------------------------------------------------- eof
+++ /dev/null
-#-------------------------------------------------------------------------
-[menu:big5]
-#[menu:machine2]
-[clear]
-# [pixmap:machine2.xpm]
-
-/¿ï³æ/*
-{½s¿è} ${EDITOR:-vi}\r
-{¦C¥X¥Ø¿ý} ls -la|${PAGER:-more}\r
-#{Dir-Time} ls -lat|${PAGER:-more}\r
-{ºÏºÐªÅ¶¡} df\r
-{-}
-{Ãö³¬ Ctrl-D} exit\r
-
-/¤u§@/*
-{Top} top\r
-{Ps u} ps aux|egrep $USER|${PAGER:-more}\r
-{Ps aux} ps aux|egrep -v "(root|ps)"|${PAGER:-more}\r
-# who's REALLY logged on (even with utmp logging turned off)
-{Who} w\r
-{-}
-{I´º} ^Z bg\r
-{²×µ²} ^C\r
-
-# standard settings for a `terminal' control menu
-# only attach to an existing menubar
-/²×ºÝ¾÷/*
-./¦r«¬ /*
-{¥¿±`} ^@\E]50;#
-{¸û¤j} ^@\E]50;#+
-{¸û¤p} ^@\E]50;#-
-{-}
-{¦r«¬ 1} ^@\E]50;#1
-{¦r«¬ 2} ^@\E]50;#2
-{¦r«¬ 3} ^@\E]50;#3
-{¦r«¬ 4} ^@\E]50;#4
-{¦r«¬ 5} ^@\E]50;#5
-{¦r«¬ 6} ^@\E]50;#6
-../¿Ã¹õ/*
-{I´º¤ÏÂà} ^@\E[?5t
-#{Toggle Width} ^@\E[?3t
-{´å¼Ð} ^@\E[?25t
-{¤Á´«} ^@\E[?47t
-{-}
-{ÁôÂÿï³æ} ^@\E[?10t
-{§ó·s¿ï³æ} ^@\E[?10h
-{¤Á´«±²¶b} ^@\E[?30t
-#{-}
-#{Toggle scroll-on-TTY} ^@\E[?1010t
-#{Toggle scroll-on-Key} ^@\E[?1011t
-../Áä½L /*
-{XTerm} ^@\E[?35t
-{Backspace} ^@\E[?67t
-{Cursor} ^@\E[?1t
-{KeyPad} ^@\E[?66t
-../
-{-}
-./I´º /*
-{µL} ^@\E[m\E]20;\a
-{-}
-# load .xpm files (assuming Rxvt*path: has been properly set)
-# notice there are 2 ways to do this task
-{background5} ^@\E]20;background5
-{Mona} ^@\E]10;[pixmap:monalisa;100]
-{-}
-./ÄÝ©Ê /*
-{©ñ¤j} ^@\E]20;;100x100+50+50;?
-{¨Ã¦C} ^@\E]20;;0
-{¤¤¥¡} ^@\E]20;;=+50+50;?
-{-}
-# set `quick arrow' keys
-{¦ùÁY}{200/50%} ^@\E]10;[:<b>\^@\\E]20;;<r>200x0<l>50x0<u>0x200<d>0x50<e>;?:]
-#{Pos}{5%} ^@\E]10;[:<b>\^@\\E]20;;<r>+5+0<l>-5+0<u>+0-5<d>+0+5<e>;?:]
-../
-../
-{-}
-{ª©¥»} ^@\E[8n
-/
-
-[show]
-#[done:machine2]
-[done:big5]
-#--------------------------------------------------------------------- eof
-
-#-------------------------------------------------------------------------
-[menu:gb]
-#[menu:machine2]
-[clear]
-# [pixmap:machine2.xpm]
-
-/Ñ¡µ¥/*
-{±à¼} ${EDITOR:-vi}\r
-{ÁгöĿ¼} ls -la|${PAGER:-more}\r
-#{Dir-Time} ls -lat|${PAGER:-more}\r
-{´Åµú¿Õ¼ä} df\r
-{-}
-{¹Ø±Õ Ctrl-D} exit\r
-
-/¹¤×÷/*
-{Top} top\r
-{Ps u} ps aux|egrep $USER|${PAGER:-more}\r
-{Ps aux} ps aux|egrep -v "(root|ps)"|${PAGER:-more}\r
-# who's REALLY logged on (even with utmp logging turned off)
-{Who} w\r
-{-}
-{±³¾°} ^Z bg\r
-{ÖÕ½á} ^C\r
-
-# standard settings for a `terminal' control menu
-# only attach to an existing menubar
-/Öն˻ú/*
-./×ÖÐÍ /*
-{Õý³£} ^@\E]50;#
-{½Ï´ó} ^@\E]50;#+
-{½ÏС} ^@\E]50;#-
-{-}
-{×ÖÐÍ 1} ^@\E]50;#1
-{×ÖÐÍ 2} ^@\E]50;#2
-{×ÖÐÍ 3} ^@\E]50;#3
-{×ÖÐÍ 4} ^@\E]50;#4
-{×ÖÐÍ 5} ^@\E]50;#5
-{×ÖÐÍ 6} ^@\E]50;#6
-../өĻ/*
-{±³¾°·´×ª} ^@\E[?5t
-#{Toggle Width} ^@\E[?3t
-{Óαê} ^@\E[?25t
-{Çл»} ^@\E[?47t
-{-}
-{Òþ²ØÑ¡µ¥} ^@\E[?10t
-{¸üÐÂÑ¡µ¥} ^@\E[?10h
-{Çл»¾íÖá} ^@\E[?30t
-#{-}
-#{Toggle scroll-on-TTY} ^@\E[?1010t
-#{Toggle scroll-on-Key} ^@\E[?1011t
-../¼üÅÌ /*
-{XTerm} ^@\E[?35t
-{Backspace} ^@\E[?67t
-{Cursor} ^@\E[?1t
-{KeyPad} ^@\E[?66t
-../
-{-}
-./±³¾° /*
-{ÎÞ} ^@\E[m\E]20;\a
-{-}
-# load .xpm files (assuming Rxvt*path: has been properly set)
-# notice there are 2 ways to do this task
-{background5} ^@\E]20;background5
-{Mona} ^@\E]10;[pixmap:monalisa;100]
-{-}
-./ÊôÐÔ /*
-{·Å´ó} ^@\E]20;;100x100+50+50;?
-{²¢ÁÐ} ^@\E]20;;0
-{ÖÐÑë} ^@\E]20;;=+50+50;?
-{-}
-# set `quick arrow' keys
-{ÉìËõ}{200/50%} ^@\E]10;[:<b>\^@\\E]20;;<r>200x0<l>50x0<u>0x200<d>0x50<e>;?:]
-#{Pos}{5%} ^@\E]10;[:<b>\^@\\E]20;;<r>+5+0<l>-5+0<u>+0-5<d>+0+5<e>;?:]
-../
-../
-{-}
-{°æ±¾} ^@\E[8n
-/
-
-[show]
-#[done:machine2]
-[done:gb]
-#--------------------------------------------------------------------- eof
-
+++ /dev/null
-# standard settings for a `terminal' control menu
-# only attach to an existing menubar
-[menu]
-
-/Terminal/*
-./Font/*
-{Normal} ^@\E]50;#
-{Larger} ^@\E]50;#+
-{Smaller} ^@\E]50;#-
-{-}
-{Font 1} ^@\E]50;#1
-{Font 2} ^@\E]50;#2
-{Font 3} ^@\E]50;#3
-{Font 4} ^@\E]50;#4
-../Screen/*
-{ReverseVideo} ^@\E[?5t
-{Toggle Width} ^@\E[?3t
-{Cursor} ^@\E[?25t
-{Switch} ^@\E[?47t
-{-}
-{menuBar} ^@\E[?10t
-{refresh menu} ^@\E[?10h
-{scrollBar} ^@\E[?30t
-{-}
-{Toggle scroll-on-TTY} ^@\E[?1010t
-{Toggle scroll-on-Key} ^@\E[?1011t
-../Keys/*
-{XTerm} ^@\E[?35t
-{Backspace} ^@\E[?67t
-{Cursor} ^@\E[?1t
-{KeyPad} ^@\E[?66t
-../
-{-}
-./Pixmap/*
-{None} ^@\E[m\E]20;\a
-{-}
-# load .xpm files (assuming Rxvt*path: has been properly set)
-# notice there are 2 ways to do this task
-{background5} ^@\E]20;background5
-{Mona} ^@\E]10;[pixmap:monalisa;100]
-{-}
-./Attrib/*
-{Full} ^@\E]20;;100x100+50+50;?
-{Tiled} ^@\E]20;;0
-{Centre} ^@\E]20;;=+50+50;?
-{-}
-# set `quick arrow' keys
-{Zoom}{200/50%} ^@\E]10;[:<b>\^@\\E]20;;<r>200x0<l>50x0<u>0x200<d>0x50<e>;?:]
-{Pos}{5%} ^@\E]10;[:<b>\^@\\E]20;;<r>+5+0<l>-5+0<u>+0-5<d>+0+5<e>;?:]
-../
-../
-{-}
-{Version} ^@\E[8n
-/
-
-# make sure the change gets updated
-[show]
-[done]
-#--------------------------------------------------------------------- eof
</p>
<hr />
<h1><a name="synopsis">SYNOPSIS</a></h1>
-<p><strong>urxvt</strong> [options] [-e command [ args ]]</p>
+<p><strong>rxvt</strong> [options] [-e command [ args ]]</p>
<p>
</p>
<hr />
</p>
<hr />
<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1>
-<p>See <code>urxvt(7)</code> (try <code>man 7 urxvt</code>) for a list of
+<p>See <code>rxvt(7)</code> (try <code>man 7 rxvt</code>) for a list of
frequently asked questions and answer to them and some common
problems. That document is also accessible on the World-Wide-Web at
<a href="http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html</a>.</p>
without most of it's features to get a lean binary. It also comes with
a client/daemon pair that lets you open any number of terminal windows
from within a single process, which makes startup time very fast and
-drastically reduces memory usage. See <code>urxvtd(1)</code> (daemon) and
-<code>urxvtc(1)</code> (client).</p>
+drastically reduces memory usage. See <code>rxvtd(1)</code> (daemon) and
+<code>rxvtc(1)</code> (client).</p>
<p>It also makes technical information about escape sequences (which have
-been extended) easier accessible: see <code>urxvt(7)</code> for technical
+been extended) easier accessible: see <code>rxvt(7)</code> for technical
reference documentation (escape sequences etc.).</p>
<p>
</p>
<hr />
<h1><a name="options">OPTIONS</a></h1>
-<p>The <strong>urxvt</strong> options (mostly a subset of <em>xterm</em>'s) are listed
+<p>The <strong>rxvt</strong> options (mostly a subset of <em>xterm</em>'s) are listed
below. In keeping with the smaller-is-better philosophy, options may be
eliminated or default values chosen at compile-time, so options and
defaults listed may not accurately reflect the version installed on
-your system. `urxvt -h' gives a list of major compile-time options on
+your system. `rxvt -h' gives a list of major compile-time options on
the <em>Options</em> line. Option descriptions may be prefixed with which
compile option each is dependent upon. e.g. `Compile <em>XIM</em>:' requires
-<em>XIM</em> on the <em>Options</em> line. Note: `urxvt -help' gives a list of all
+<em>XIM</em> on the <em>Options</em> line. Note: `rxvt -help' gives a list of all
command-line options compiled into your version.</p>
-<p>Note that <strong>urxvt</strong> permits the resource name to be used as a
+<p>Note that <strong>rxvt</strong> permits the resource name to be used as a
long-option (--/++ option) so the potential command-line options are
-far greater than those listed. For example: `urxvt --loginShell --color1
+far greater than those listed. For example: `rxvt --loginShell --color1
Orange'.</p>
<p>The following options are available:</p>
<dl>
</dd>
<dd>
<pre>
- urxvt -tr -tint blue -sh 40</pre>
+ rxvt -tr -tint blue -sh 40</pre>
</dd>
<p></p>
<dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong><br />
</dd>
<dd>
<pre>
- urxvt -fn "xft:Bitstream Vera Sans Mono:pixelsize=15"
- urxvt -fn "9x15bold,xft:Bitstream Vera Sans Mono"</pre>
+ rxvt -fn "xft:Bitstream Vera Sans Mono:pixelsize=15"
+ rxvt -fn "9x15bold,xft:Bitstream Vera Sans Mono"</pre>
</dd>
<dd>
<p>See also the question ``How does rxvt-unicode choose fonts?'' in the FAQ
-section of urxvt(7).</p>
+section of rxvt(7).</p>
</dd>
<p></p>
<dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong><br />
<dt><strong><a name="item__2de_command__5barguments_5d"><strong>-e</strong> <em>command [arguments]</em></a></strong><br />
</dt>
<dd>
-Run the command with its command-line arguments in the <strong>urxvt</strong>
+Run the command with its command-line arguments in the <strong>rxvt</strong>
window; also sets the window title and icon name to be the basename of
the program being executed if neither <em>-title</em> (<em>-T</em>) nor <em>-n</em> are
given on the command line. If this option is used, it must be the last
</dd>
<dd>
<pre>
- urxvt -e sh -c "shell commands"</pre>
+ rxvt -e sh -c "shell commands"</pre>
</dd>
<p></p>
<dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong><br />
<dt><strong><a name="item__2dhold_7c_2bhold"><strong>-hold</strong>|<strong>+hold</strong></a></strong><br />
</dt>
<dd>
-Turn on/off hold window after exit support. If enabled, urxvt
+Turn on/off hold window after exit support. If enabled, rxvt
will not immediately destroy its window when the program executed within
it exits. Instead, it will wait till it is being killed or closed by the
user; resource <strong>hold</strong>.
<dt><strong><a name="item__2dembed_windowid"><strong>-embed</strong> <em>windowid</em></a></strong><br />
</dt>
<dd>
-Tells urxvt to embed it's windows into an already-existing window,
+Tells rxvt to embed it's windows into an already-existing window,
which enables applications to easily embed a terminal.
</dd>
<dd>
-<p>Right now, urxvt will first unmap/map the specified window, so it
-shouldn't be a top-level window. urxvt will also reconfigure it
+<p>Right now, rxvt will first unmap/map the specified window, so it
+shouldn't be a top-level window. rxvt will also reconfigure it
quite a bit, so don't expect it to keep some specific state. It's best to
-create an extra subwindow for urxvt and leave it alone.</p>
+create an extra subwindow for rxvt and leave it alone.</p>
</dd>
<dd>
-<p>The window will not be destroyed when urxvt exits.</p>
+<p>The window will not be destroyed when rxvt exits.</p>
</dd>
<dd>
-<p>It might be useful to know that urxvt will not close file
+<p>It might be useful to know that rxvt will not close file
descriptors passed to it (except for stdin/out/err, of course), so you
can use file descriptors to communicate with the programs within the
terminal. This works regardless of wether the <code>-embed</code> option was used or
my $rxvt = new Gtk2::Socket;
$rxvt->signal_connect_after (realize => sub {
my $xid = $_[0]->window->get_xid;
- system "urxvt -embed $xid &";
+ system "rxvt -embed $xid &";
});</pre>
</dd>
<p></p>
<dt><strong><a name="item__2dpty_2dfd_file_descriptor"><strong>-pty-fd</strong> <em>file descriptor</em></a></strong><br />
</dt>
<dd>
-Tells urxvt NOT to execute any commands or create a new pty/tty
+Tells rxvt NOT to execute any commands or create a new pty/tty
pair but instead use the given filehandle as the tty master. This is
-useful if you want to drive urxvt as a generic terminal emulator
+useful if you want to drive rxvt as a generic terminal emulator
without having to run a program within it.
</dd>
<dd>
-<p>If this switch is given, urxvt will not create any utmp/wtmp
+<p>If this switch is given, rxvt will not create any utmp/wtmp
entries and will not tinker with pty/tty permissions - you have to do that
yourself if you want that.</p>
</dd>
<pre>
my $pty = new IO::Pty;
fcntl $pty, F_SETFD, 0; # clear close-on-exec
- system "urxvt -pty-fd " . (fileno $pty) . "&";
+ system "rxvt -pty-fd " . (fileno $pty) . "&";
close $pty;</pre>
</dd>
<dd>
</p>
<hr />
<h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1>
-<p>Note: `urxvt --help' gives a list of all resources (long
+<p>Note: `rxvt --help' gives a list of all resources (long
options) compiled into your version.</p>
<p>You can set and change the resources using X11 tools like <strong>xrdb</strong>. Many
distribution do also load settings from the <strong>~/.Xresources</strong> file when X
-starts. urxvt will consult the following files/resources in order,
+starts. rxvt will consult the following files/resources in order,
with later settings overwriting earlier ones:</p>
<pre>
1. system-wide app-defaults file, either locale-dependent OR global
3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
4. SCREEN_RESOURCES for the current screen
5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename></pre>
-<p>Note that when reading X resources, <strong>urxvt</strong> recognizes two class
+<p>Note that when reading X resources, <strong>rxvt</strong> recognizes two class
names: <strong>Rxvt</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows resources
-common to both <strong>urxvt</strong> and the original <em>rxvt</em> to be easily
+common to both <strong>rxvt</strong> and the original <em>rxvt</em> to be easily
configured, while the class name <strong>URxvt</strong> allows resources unique to
-<strong>urxvt</strong>, to be shared between different <strong>urxvt</strong>
+<strong>rxvt</strong>, to be shared between different <strong>rxvt</strong>
configurations. If no resources are specified, suitable defaults will
be used. Command-line arguments can be used to override resource
settings. The following resources are supported (you might want to
-check the <code>urxvtperl(3)</code> manpage for additional settings by perl
+check the <code>rxvtperl(3)</code> manpage for additional settings by perl
extensions not documented here):</p>
<dl>
<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br />
</dd>
<dd>
<p>Colours higher than 15 cannot be set using resources (yet), but can be
-changed using an escape command (see urxvt(7)).</p>
+changed using an escape command (see rxvt(7)).</p>
</dd>
<dd>
<p>Colours 16-79 form a standard 4x4x4 colour cube (the same as xterm with
scale is 1000. [default 0x0+50+50]
</dd>
<p></p>
-<dt><strong><a name="item_menu_3a_file_5b_3btag_5d"><strong>menu:</strong> <em>file[;tag]</em></a></strong><br />
-</dt>
-<dd>
-Read in the specified menu file (note the `.menu' extension is
-optional) and also optionally specify a starting tag to find. See the
-reference documentation for details on the syntax for the menuBar.
-</dd>
-<p></p>
<dt><strong><a name="item_path_3a_path"><strong>path:</strong> <em>path</em></a></strong><br />
</dt>
<dd>
-Specify the colon-delimited search path for finding files (XPM and
-menus), in addition to the paths specified by the <strong>RXVTPATH</strong> and
-<strong>PATH</strong> environment variables.
+Specify the colon-delimited search path for finding XPM files.
</dd>
<p></p>
<dt><strong><a name="item_font_3a_fontlist"><strong>font:</strong> <em>fontlist</em></a></strong><br />
</dd>
<dd>
<pre>
- URxvt*font: 9x15bold,\
+ URxvt.font: 9x15bold,\
-misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\
-misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \
[codeset=JISX0208]xft:Kochi Gothic:antialias=false, \
</dd>
<dd>
<pre>
- URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre>
+ URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre>
</dd>
<dd>
<p>This creates a new file in your home directory with the screen contents
Specify the font-set used for XIM styles <code>OverTheSpot</code> or
<code>OffTheSpot</code>. It must be a standard X font set (XLFD patterns separated
by commas), i.e. it's not in the same format as the other font lists used
-in urxvt. The default will be set-up to chose *any* suitable found
+in rxvt. The default will be set-up to chose *any* suitable found
found, preferably one or two pixels differing in size to the base font.
option <strong>-imfont</strong>.
</dd>
<dd>
<p>You can enable them by setting this boolean resource or specifying
<strong>-insecure</strong> as an option. At the moment, this enables display-answer,
-locale, findfont, icon label and window title requests as well as dynamic
-menubar dispatch.</p>
+locale, findfont, icon label and window title requests.</p>
</dd>
<p></p>
<dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br />
<dt><strong><a name="item_hold_3a_bool"><strong>hold</strong>: <em>bool</em></a></strong><br />
</dt>
<dd>
-Turn on/off hold window after exit support. If enabled, urxvt
+Turn on/off hold window after exit support. If enabled, rxvt
will not immediately destroy its window when the program executed within
it exits. Instead, it will wait till it is being killed or closed by the
user.
<dd>
<p>Please note that you need to double the <code>\</code> in resource files, as
Xlib itself does it's own de-escaping (you can use <code>\033</code> instead of
-<code>\e</code> (and so on), which will work with both Xt and urxvt's own
+<code>\e</code> (and so on), which will work with both Xt and rxvt's own
processing).</p>
</dd>
<dd>
</dd>
<dd>
<p>If <em>string</em> takes the form of <code>command:STRING</code>, the specified <strong>STRING</strong>
-is interpreted and executed as urxvt's control sequence. For
+is interpreted and executed as rxvt's control sequence. For
example the following means ``change the current locale to <code>zh_CN.GBK</code>
when Control-Meta-c is being pressed'':</p>
</dd>
</dd>
<dd>
<p>If <em>string</em> takes the form <code>perl:STRING</code>, then the specified <strong>STRING</strong>
-is passed to the <code>on_keyboard_command</code> perl handler. See the <code>urxvtperl(3)</code>
+is passed to the <code>on_keyboard_command</code> perl handler. See the <code>rxvtperl(3)</code>
manpage. For example, the <em>selection</em> extension (activated via
-<code>urxvt -pe selection</code>) listens for <code>selection:rot13</code> events:</p>
+<code>rxvt -pe selection</code>) listens for <code>selection:rot13</code> events:</p>
</dd>
<dd>
<pre>
</dd>
<dd>
<p>Unfortunately, this will override built-in key mappings. For example
-if you overwrite the <code>Insert</code> key you will disable urxvt's
+if you overwrite the <code>Insert</code> key you will disable rxvt's
<code>Shift-Insert</code> mapping. To re-enable that, you can poke ``holes'' into the
user-defined keymap using the <code>builtin:</code> replacement:</p>
</dd>
URxvt.keysym.M-C-2: command:\033]50;9x15bold\007</pre>
</dd>
<dd>
-<p>Other things are possible, e.g. resizing (see <code>urxvt(7)</code> for more
+<p>Other things are possible, e.g. resizing (see <code>rxvt(7)</code> for more
info):</p>
</dd>
<dd>
</dt>
<dd>
Perl code to be evaluated when all extensions have been registered. See
-the <code>urxvtperl(3)</code> manpage. Due to security reasons, this resource
+the <code>rxvtperl(3)</code> manpage. Due to security reasons, this resource
will be ignored when running setuid/setgid.
</dd>
<p></p>
<dd>
Colon-separated list of additional directories that hold extension
scripts. When looking for extensions specified by the <code>perl</code> resource,
-urxvt will first look in these directories and then in
-<em>/usr/local/lib/urxvt/perl/</em>. Due to security reasons, this resource
+rxvt will first look in these directories and then in
+<em>/opt/rxvt/lib/urxvt/perl/</em>. Due to security reasons, this resource
will be ignored when running setuid/setgid.
</dd>
<dd>
-<p>See the <code>urxvtperl(3)</code> manpage.</p>
+<p>See the <code>rxvtperl(3)</code> manpage.</p>
</dd>
<p></p>
<dt><strong><a name="item_selection_2epattern_2didx_3a_perl_2dregex"><strong>selection.pattern-<em>idx</em> </strong>>: <em>perl-regex</em></a></strong><br />
</dt>
<dd>
-Additional selection patterns, see the <code>urxvtperl(3)</code> manpage for
+Additional selection patterns, see the <code>rxvtperl(3)</code> manpage for
details.
</dd>
<p></p>
<dt><strong><a name="item_selection_2dautotransform_2eidx_3a_perl_2dtransfor"><strong>selection-autotransform.<em>idx</em> </strong>>: <em>perl-transform</em></a></strong><br />
</dt>
<dd>
-Selection auto-transform patterns, see the <code>urxvtperl(3)</code> manpage
+Selection auto-transform patterns, see the <code>rxvtperl(3)</code> manpage
for details.
</dd>
<p></p>
</p>
<hr />
<h1><a name="the_scrollbar">THE SCROLLBAR</a></h1>
-<p>Lines of text that scroll off the top of the <strong>urxvt</strong> window
+<p>Lines of text that scroll off the top of the <strong>rxvt</strong> window
(resource: <strong>saveLines</strong>) and can be scrolled back using the scrollbar
-or by keystrokes. The normal <strong>urxvt</strong> scrollbar has arrows and
+or by keystrokes. The normal <strong>rxvt</strong> scrollbar has arrows and
its behaviour is fairly intuitive. The <strong>xterm-scrollbar</strong> is without
arrows and its behaviour mimics that of <em>xterm</em></p>
<p>Scroll down with <strong>Button1</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Next</strong>.
</dt>
<dd>
Pressing and releasing the Middle mouse button (or <strong>Shift-Insert</strong>) in
-an <strong>urxvt</strong> window causes the current text selection to be
+an <strong>rxvt</strong> window causes the current text selection to be
inserted as if it had been typed on the keyboard.
</dd>
<p></p></dl>
<h1><a name="changing_fonts">CHANGING FONTS</a></h1>
<p>Changing fonts (or font sizes, respectively) via the keypad is not yet
supported in rxvt-unicode. Bug me if you need this.</p>
-<p>You can, however, switch fonts at runtime using escape sequences (and
-therefore using the menubar), e.g.:</p>
+<p>You can, however, switch fonts at runtime using escape sequences, e.g.:</p>
<pre>
printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic"</pre>
+<p>You can use keyboard shortcuts, too:</p>
+<pre>
+ URxvt.keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
+ URxvt.keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007</pre>
<p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p>
<p>
</p>
</p>
<hr />
<h1><a name="login_stamp">LOGIN STAMP</a></h1>
-<p><strong>urxvt</strong> tries to write an entry into the <em>utmp</em>(5) file so that
+<p><strong>rxvt</strong> tries to write an entry into the <em>utmp</em>(5) file so that
it can be seen via the <em>who(1)</em> command, and can accept messages. To
-allow this feature, <strong>urxvt</strong> may need to be installed setuid root
+allow this feature, <strong>rxvt</strong> may need to be installed setuid root
on some systems or setgid to root or to some other group on others.</p>
<p>
</p>
<hr />
<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1>
<p>In addition to the default foreground and background colours,
-<strong>urxvt</strong> can display up to 16 colours (8 ANSI colours plus
+<strong>rxvt</strong> can display up to 16 colours (8 ANSI colours plus
high-intensity bold/blink versions of the same). Here is a list of the
colours with their <strong>rgb.txt</strong> names.</p>
<table>
<em>xterm</em>(1) where the colours are only swapped if they have not otherwise
been specified. For example,</p>
<dl>
-<dt><strong><a name="item_urxvt__2dfg_black__2dbg_white__2drv"><strong>urxvt -fg Black -bg White -rv</strong></a></strong><br />
+<dt><strong><a name="item_rxvt__2dfg_black__2dbg_white__2drv"><strong>rxvt -fg Black -bg White -rv</strong></a></strong><br />
</dt>
<dd>
would yield White on Black, while on <em>xterm</em>(1) it would yield Black
</p>
<hr />
<h1><a name="environment">ENVIRONMENT</a></h1>
-<p><strong>urxvt</strong> sets and/or uses the following environment variables:</p>
+<p><strong>rxvt</strong> sets and/or uses the following environment variables:</p>
<dl>
<dt><strong><a name="item_term"><strong>TERM</strong></a></strong><br />
</dt>
<dt><strong><a name="item_colorterm"><strong>COLORTERM</strong></a></strong><br />
</dt>
<dd>
-Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on wether urxvt was
+Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on wether rxvt was
compiled with XPM support, and optionally with the added extension
<code>-mono</code> to indicate that rxvt-unicode runs on a monochrome screen.
</dd>
the colour code used as default foreground/text colour (or the string
<code>default</code> to indicate that the default-colour escape sequence is to be
used), <code>bg</code> is the colour code used as default background colour (or the
-string <code>default</code>), and <code>xpm</code> is the string <code>default</code> if urxvt
+string <code>default</code>), and <code>xpm</code> is the string <code>default</code> if rxvt
was compiled with XPM support. Libraries like <code>ncurses</code> and <code>slang</code> can
(and do) use this information to optimize screen output.
</dd>
<dt><strong><a name="item_windowid"><strong>WINDOWID</strong></a></strong><br />
</dt>
<dd>
-Set to the (decimal) X Window ID of the urxvt window (the toplevel
+Set to the (decimal) X Window ID of the rxvt window (the toplevel
window, which usually has subwindows for the scrollbar, the terminal
window and so on).
</dd>
<dt><strong><a name="item_terminfo"><strong>TERMINFO</strong></a></strong><br />
</dt>
<dd>
-Set to the terminfo directory iff urxvt was configured with
+Set to the terminfo directory iff rxvt was configured with
<code>--with-terminfo=PATH</code>.
</dd>
<p></p>
<dt><strong><a name="item_display"><strong>DISPLAY</strong></a></strong><br />
</dt>
<dd>
-Used by urxvt to connect to the display and set to the correct
+Used by rxvt to connect to the display and set to the correct
display in it's child processes.
</dd>
<p></p>
<dt><strong><a name="item_rxvtpath"><strong>RXVTPATH</strong></a></strong><br />
</dt>
<dd>
-The path where urxvt looks for support files such as menu and xpm
+The path where rxvt looks for support files such as menu and xpm
files.
</dd>
<p></p>
<dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong><br />
</dt>
<dd>
-The unix domain socket path used by <code>urxvtc(1)</code> and
-urxvtd(1).
+The unix domain socket path used by <code>rxvtc(1)</code> and
+rxvtd(1).
</dd>
<dd>
<p>Default <em>$HOME/.rxvt-unicode-<em><nodename </em></em> >>>.</p>
</dt>
<dd>
If set and accessible, gives the name of a X resource file to be loaded by
-urxvt.
+rxvt.
</dd>
<p></p></dl>
<p>
</p>
<hr />
<h1><a name="see_also">SEE ALSO</a></h1>
-<p>urxvt(7), urxvtc(1), urxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p>
+<p>rxvt(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p>
<p>
</p>
<hr />
.\" ========================================================================
.\"
.IX Title "rxvt 1"
-.TH rxvt 1 "2006-01-13" "7.0" "RXVT-UNICODE"
+.TH rxvt 1 "2006-01-16" "7.0" "RXVT-UNICODE"
.SH "NAME"
rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system)
.SH "SYNOPSIS"
specifies an integer number of images in that direction. No image will
be magnified beyond 10 times its original size. The maximum permitted
scale is 1000. [default 0x0+50+50]
-.IP "\fBmenu:\fR \fIfile[;tag]\fR" 4
-.IX Item "menu: file[;tag]"
-Read in the specified menu file (note the `.menu' extension is
-optional) and also optionally specify a starting tag to find. See the
-reference documentation for details on the syntax for the menuBar.
.IP "\fBpath:\fR \fIpath\fR" 4
.IX Item "path: path"
-Specify the colon-delimited search path for finding files (\s-1XPM\s0 and
-menus), in addition to the paths specified by the \fB\s-1RXVTPATH\s0\fR and
-\&\fB\s-1PATH\s0\fR environment variables.
+Specify the colon-delimited search path for finding \s-1XPM\s0 files.
.IP "\fBfont:\fR \fIfontlist\fR" 4
.IX Item "font: fontlist"
Select the fonts to be used. This is a comma separated list of font names
For example, this font resource
.Sp
.Vb 5
-\& URxvt*font: 9x15bold,\e
+\& URxvt.font: 9x15bold,\e
\& -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e
\& -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e
\& [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \e
Example:
.Sp
.Vb 1
-\& URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
+\& URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
.Ve
.Sp
This creates a new file in your home directory with the screen contents
.Sp
You can enable them by setting this boolean resource or specifying
\&\fB\-insecure\fR as an option. At the moment, this enables display\-answer,
-locale, findfont, icon label and window title requests as well as dynamic
-menubar dispatch.
+locale, findfont, icon label and window title requests.
.IP "\fBmodifier:\fR \fImodifier\fR" 4
.IX Item "modifier: modifier"
Set the key to be interpreted as the Meta key to: \fBalt\fR, \fBmeta\fR,
Changing fonts (or font sizes, respectively) via the keypad is not yet
supported in rxvt\-unicode. Bug me if you need this.
.PP
-You can, however, switch fonts at runtime using escape sequences (and
-therefore using the menubar), e.g.:
+You can, however, switch fonts at runtime using escape sequences, e.g.:
.PP
.Vb 1
\& printf '\ee]710;%s\e007' "9x15bold,xft:Kochi Gothic"
.Ve
.PP
+You can use keyboard shortcuts, too:
+.PP
+.Vb 2
+\& URxvt.keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007
+\& URxvt.keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007
+.Ve
+.PP
rxvt-unicode will automatically re-apply these fonts to the output so far.
.SH "ISO 14755 SUPPORT"
.IX Header "ISO 14755 SUPPORT"
be magnified beyond 10 times its original size. The maximum permitted
scale is 1000. [default 0x0+50+50]
-=item B<menu:> I<file[;tag]>
-
-Read in the specified menu file (note the `.menu' extension is
-optional) and also optionally specify a starting tag to find. See the
-reference documentation for details on the syntax for the menuBar.
-
=item B<path:> I<path>
-Specify the colon-delimited search path for finding files (XPM and
-menus), in addition to the paths specified by the B<RXVTPATH> and
-B<PATH> environment variables.
+Specify the colon-delimited search path for finding XPM files.
=item B<font:> I<fontlist>
For example, this font resource
- URxvt*font: 9x15bold,\
+ URxvt.font: 9x15bold,\
-misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\
-misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \
[codeset=JISX0208]xft:Kochi Gothic:antialias=false, \
Example:
- URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
+ URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
This creates a new file in your home directory with the screen contents
everytime you hit C<Print>.
You can enable them by setting this boolean resource or specifying
B<-insecure> as an option. At the moment, this enables display-answer,
-locale, findfont, icon label and window title requests as well as dynamic
-menubar dispatch.
+locale, findfont, icon label and window title requests.
=item B<modifier:> I<modifier>
Changing fonts (or font sizes, respectively) via the keypad is not yet
supported in rxvt-unicode. Bug me if you need this.
-You can, however, switch fonts at runtime using escape sequences (and
-therefore using the menubar), e.g.:
+You can, however, switch fonts at runtime using escape sequences, e.g.:
printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic"
+You can use keyboard shortcuts, too:
+
+ URxvt.keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
+ URxvt.keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007
+
rxvt-unicode will automatically re-apply these fonts to the output so far.
=head1 ISO 14755 SUPPORT
system)
SYNOPSIS
- urxvt [options] [-e command [ args ]]
+ rxvt [options] [-e command [ args ]]
DESCRIPTION
rxvt-unicode, version 7.0, is a colour vt102 terminal emulator intended
advantage on a machine serving many X sessions.
FREQUENTLY ASKED QUESTIONS
- See urxvt(7) (try "man 7 urxvt") for a list of frequently asked
- questions and answer to them and some common problems. That document is
- also accessible on the World-Wide-Web at
+ See rxvt(7) (try "man 7 rxvt") for a list of frequently asked questions
+ and answer to them and some common problems. That document is also
+ accessible on the World-Wide-Web at
<http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html>.
RXVT-UNICODE VS. RXVT
without most of it's features to get a lean binary. It also comes with a
client/daemon pair that lets you open any number of terminal windows
from within a single process, which makes startup time very fast and
- drastically reduces memory usage. See urxvtd(1) (daemon) and urxvtc(1)
+ drastically reduces memory usage. See rxvtd(1) (daemon) and rxvtc(1)
(client).
It also makes technical information about escape sequences (which have
- been extended) easier accessible: see urxvt(7) for technical reference
+ been extended) easier accessible: see rxvt(7) for technical reference
documentation (escape sequences etc.).
OPTIONS
- The urxvt options (mostly a subset of *xterm*'s) are listed below. In
+ The rxvt options (mostly a subset of *xterm*'s) are listed below. In
keeping with the smaller-is-better philosophy, options may be eliminated
or default values chosen at compile-time, so options and defaults listed
- may not accurately reflect the version installed on your system. `urxvt
+ may not accurately reflect the version installed on your system. `rxvt
-h' gives a list of major compile-time options on the *Options* line.
Option descriptions may be prefixed with which compile option each is
dependent upon. e.g. `Compile *XIM*:' requires *XIM* on the *Options*
- line. Note: `urxvt -help' gives a list of all command-line options
+ line. Note: `rxvt -help' gives a list of all command-line options
compiled into your version.
- Note that urxvt permits the resource name to be used as a long-option
+ Note that rxvt permits the resource name to be used as a long-option
(--/++ option) so the potential command-line options are far greater
- than those listed. For example: `urxvt --loginShell --color1 Orange'.
+ than those listed. For example: `rxvt --loginShell --color1 Orange'.
The following options are available:
be used to brighten or darken the image in addition to tinting it;
resource *tintColor*. Example:
- urxvt -tr -tint blue -sh 40
+ rxvt -tr -tint blue -sh 40
-sh *number* Darken (0 .. 100) or lighten (-1 .. -100) the transparent
background image in addition to tinting it (i.e. -tint must be
prefix it with "x:". To specify an XFT-font, you need to prefix it
with "xft:", e.g.:
- urxvt -fn "xft:Bitstream Vera Sans Mono:pixelsize=15"
- urxvt -fn "9x15bold,xft:Bitstream Vera Sans Mono"
+ rxvt -fn "xft:Bitstream Vera Sans Mono:pixelsize=15"
+ rxvt -fn "9x15bold,xft:Bitstream Vera Sans Mono"
See also the question "How does rxvt-unicode choose fonts?" in the
- FAQ section of urxvt(7).
+ FAQ section of rxvt(7).
-fb *fontlist*
Compile *font-styles*: The bold font list to use when bold
resource termName.
-e *command [arguments]*
- Run the command with its command-line arguments in the urxvt window;
+ Run the command with its command-line arguments in the rxvt window;
also sets the window title and icon name to be the basename of the
program being executed if neither *-title* (*-T*) nor *-n* are given
on the command line. If this option is used, it must be the last on
want to run shell commands, you have to specify the shell, like
this:
- urxvt -e sh -c "shell commands"
+ rxvt -e sh -c "shell commands"
-title *text*
Window title (-T still respected); the default title is the basename
secondaryScroll.
-hold|+hold
- Turn on/off hold window after exit support. If enabled, urxvt will
+ Turn on/off hold window after exit support. If enabled, rxvt will
not immediately destroy its window when the program executed within
it exits. Instead, it will wait till it is being killed or closed by
the user; resource hold.
Remap a key symbol. See resource keysym.
-embed *windowid*
- Tells urxvt to embed it's windows into an already-existing window,
+ Tells rxvt to embed it's windows into an already-existing window,
which enables applications to easily embed a terminal.
- Right now, urxvt will first unmap/map the specified window, so it
- shouldn't be a top-level window. urxvt will also reconfigure it
- quite a bit, so don't expect it to keep some specific state. It's
- best to create an extra subwindow for urxvt and leave it alone.
+ Right now, rxvt will first unmap/map the specified window, so it
+ shouldn't be a top-level window. rxvt will also reconfigure it quite
+ a bit, so don't expect it to keep some specific state. It's best to
+ create an extra subwindow for rxvt and leave it alone.
- The window will not be destroyed when urxvt exits.
+ The window will not be destroyed when rxvt exits.
- It might be useful to know that urxvt will not close file
- descriptors passed to it (except for stdin/out/err, of course), so
- you can use file descriptors to communicate with the programs within
- the terminal. This works regardless of wether the "-embed" option
- was used or not.
+ It might be useful to know that rxvt will not close file descriptors
+ passed to it (except for stdin/out/err, of course), so you can use
+ file descriptors to communicate with the programs within the
+ terminal. This works regardless of wether the "-embed" option was
+ used or not.
Here is a short Gtk2-perl snippet that illustrates how this option
can be used (a longer example is in doc/embed):
my $rxvt = new Gtk2::Socket;
$rxvt->signal_connect_after (realize => sub {
my $xid = $_[0]->window->get_xid;
- system "urxvt -embed $xid &";
+ system "rxvt -embed $xid &";
});
-pty-fd *file descriptor*
- Tells urxvt NOT to execute any commands or create a new pty/tty pair
+ Tells rxvt NOT to execute any commands or create a new pty/tty pair
but instead use the given filehandle as the tty master. This is
- useful if you want to drive urxvt as a generic terminal emulator
+ useful if you want to drive rxvt as a generic terminal emulator
without having to run a program within it.
- If this switch is given, urxvt will not create any utmp/wtmp entries
+ If this switch is given, rxvt will not create any utmp/wtmp entries
and will not tinker with pty/tty permissions - you have to do that
yourself if you want that.
my $pty = new IO::Pty;
fcntl $pty, F_SETFD, 0; # clear close-on-exec
- system "urxvt -pty-fd " . (fileno $pty) . "&";
+ system "rxvt -pty-fd " . (fileno $pty) . "&";
close $pty;
# now communicate with rxvt
use) in this terminal instance. See resource perl-ext for details.
RESOURCES (available also as long-options)
- Note: `urxvt --help' gives a list of all resources (long options)
+ Note: `rxvt --help' gives a list of all resources (long options)
compiled into your version.
You can set and change the resources using X11 tools like xrdb. Many
distribution do also load settings from the ~/.Xresources file when X
- starts. urxvt will consult the following files/resources in order, with
+ starts. rxvt will consult the following files/resources in order, with
later settings overwriting earlier ones:
1. system-wide app-defaults file, either locale-dependent OR global
4. SCREEN_RESOURCES for the current screen
5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename>
- Note that when reading X resources, urxvt recognizes two class names:
- Rxvt and URxvt. The class name Rxvt allows resources common to both
- urxvt and the original *rxvt* to be easily configured, while the class
- name URxvt allows resources unique to urxvt, to be shared between
- different urxvt configurations. If no resources are specified, suitable
- defaults will be used. Command-line arguments can be used to override
- resource settings. The following resources are supported (you might want
- to check the urxvtperl(3) manpage for additional settings by perl
- extensions not documented here):
+ Note that when reading X resources, rxvt recognizes two class names:
+ Rxvt and URxvt. The class name Rxvt allows resources common to both rxvt
+ and the original *rxvt* to be easily configured, while the class name
+ URxvt allows resources unique to rxvt, to be shared between different
+ rxvt configurations. If no resources are specified, suitable defaults
+ will be used. Command-line arguments can be used to override resource
+ settings. The following resources are supported (you might want to check
+ the rxvtperl(3) manpage for additional settings by perl extensions not
+ documented here):
geometry: *geom*
Create the window with the specified X window geometry [default
section.
Colours higher than 15 cannot be set using resources (yet), but can
- be changed using an escape command (see urxvt(7)).
+ be changed using an escape command (see rxvt(7)).
Colours 16-79 form a standard 4x4x4 colour cube (the same as xterm
with 88 colour support). Colours 80-87 are evenly spaces grey steps.
will be magnified beyond 10 times its original size. The maximum
permitted scale is 1000. [default 0x0+50+50]
- menu: *file[;tag]*
- Read in the specified menu file (note the `.menu' extension is
- optional) and also optionally specify a starting tag to find. See
- the reference documentation for details on the syntax for the
- menuBar.
-
path: *path*
- Specify the colon-delimited search path for finding files (XPM and
- menus), in addition to the paths specified by the RXVTPATH and PATH
- environment variables.
+ Specify the colon-delimited search path for finding XPM files.
font: *fontlist*
Select the fonts to be used. This is a comma separated list of font
For example, this font resource
- URxvt*font: 9x15bold,\
+ URxvt.font: 9x15bold,\
-misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\
-misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \
[codeset=JISX0208]xft:Kochi Gothic:antialias=false, \
Example:
- URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
+ URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
This creates a new file in your home directory with the screen
contents everytime you hit "Print".
Specify the font-set used for XIM styles "OverTheSpot" or
"OffTheSpot". It must be a standard X font set (XLFD patterns
separated by commas), i.e. it's not in the same format as the other
- font lists used in urxvt. The default will be set-up to chose *any*
+ font lists used in rxvt. The default will be set-up to chose *any*
suitable found found, preferably one or two pixels differing in size
to the base font. option -imfont.
You can enable them by setting this boolean resource or specifying
-insecure as an option. At the moment, this enables display-answer,
- locale, findfont, icon label and window title requests as well as
- dynamic menubar dispatch.
+ locale, findfont, icon label and window title requests.
modifier: *modifier*
Set the key to be interpreted as the Meta key to: alt, meta, hyper,
instead scroll the screen up.
hold: *bool*
- Turn on/off hold window after exit support. If enabled, urxvt will
+ Turn on/off hold window after exit support. If enabled, rxvt will
not immediately destroy its window when the program executed within
it exits. Instead, it will wait till it is being killed or closed by
the user.
Please note that you need to double the "\" in resource files, as
Xlib itself does it's own de-escaping (you can use "\033" instead of
- "\e" (and so on), which will work with both Xt and urxvt's own
+ "\e" (and so on), which will work with both Xt and rxvt's own
processing).
You can define a range of keysyms in one shot by providing a
URxvt.keysym.Meta-Control-0x63: \033<M-C-c>
If *string* takes the form of "command:STRING", the specified STRING
- is interpreted and executed as urxvt's control sequence. For example
+ is interpreted and executed as rxvt's control sequence. For example
the following means "change the current locale to "zh_CN.GBK" when
Control-Meta-c is being pressed":
If *string* takes the form "perl:STRING", then the specified STRING
is passed to the "on_keyboard_command" perl handler. See the
- urxvtperl(3) manpage. For example, the selection extension
- (activated via "urxvt -pe selection") listens for "selection:rot13"
- events:
+ rxvtperl(3) manpage. For example, the selection extension (activated
+ via "rxvt -pe selection") listens for "selection:rot13" events:
URxvt.keysym.M-C-c: perl:selection:rot13
unless some of those are defined mappings themselves.
Unfortunately, this will override built-in key mappings. For example
- if you overwrite the "Insert" key you will disable urxvt's
+ if you overwrite the "Insert" key you will disable rxvt's
"Shift-Insert" mapping. To re-enable that, you can poke "holes" into
the user-defined keymap using the "builtin:" replacement:
URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007
URxvt.keysym.M-C-2: command:\033]50;9x15bold\007
- Other things are possible, e.g. resizing (see urxvt(7) for more
+ Other things are possible, e.g. resizing (see rxvt(7) for more
info):
URxvt.keysym.M-C-3: command:\033[8;25;80t
perl-eval: *string*
Perl code to be evaluated when all extensions have been registered.
- See the urxvtperl(3) manpage. Due to security reasons, this resource
+ See the rxvtperl(3) manpage. Due to security reasons, this resource
will be ignored when running setuid/setgid.
perl-lib: *path*
Colon-separated list of additional directories that hold extension
scripts. When looking for extensions specified by the "perl"
- resource, urxvt will first look in these directories and then in
- /usr/local/lib/urxvt/perl/. Due to security reasons, this resource
+ resource, rxvt will first look in these directories and then in
+ /opt/rxvt/lib/urxvt/perl/. Due to security reasons, this resource
will be ignored when running setuid/setgid.
- See the urxvtperl(3) manpage.
+ See the rxvtperl(3) manpage.
selection.pattern-*idx*: *perl-regex*
- Additional selection patterns, see the urxvtperl(3) manpage for
+ Additional selection patterns, see the rxvtperl(3) manpage for
details.
selection-autotransform.*idx*: *perl-transform*
- Selection auto-transform patterns, see the urxvtperl(3) manpage for
+ Selection auto-transform patterns, see the rxvtperl(3) manpage for
details.
searchable-scrollback: *keysym*
Sets the WM_TRANSIENT_FOR property to the given window iw.
THE SCROLLBAR
- Lines of text that scroll off the top of the urxvt window (resource:
+ Lines of text that scroll off the top of the rxvt window (resource:
saveLines) and can be scrolled back using the scrollbar or by
- keystrokes. The normal urxvt scrollbar has arrows and its behaviour is
+ keystrokes. The normal rxvt scrollbar has arrows and its behaviour is
fairly intuitive. The xterm-scrollbar is without arrows and its
behaviour mimics that of *xterm*
Insertion:
Pressing and releasing the Middle mouse button (or Shift-Insert) in
- an urxvt window causes the current text selection to be inserted as
+ an rxvt window causes the current text selection to be inserted as
if it had been typed on the keyboard.
CHANGING FONTS
Changing fonts (or font sizes, respectively) via the keypad is not yet
supported in rxvt-unicode. Bug me if you need this.
- You can, however, switch fonts at runtime using escape sequences (and
- therefore using the menubar), e.g.:
+ You can, however, switch fonts at runtime using escape sequences, e.g.:
printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic"
+ You can use keyboard shortcuts, too:
+
+ URxvt.keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
+ URxvt.keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007
+
rxvt-unicode will automatically re-apply these fonts to the output so
far.
both scenario A and B of ISO 14755, including part 5.2.
LOGIN STAMP
- urxvt tries to write an entry into the *utmp*(5) file so that it can be
+ rxvt tries to write an entry into the *utmp*(5) file so that it can be
seen via the *who(1)* command, and can accept messages. To allow this
- feature, urxvt may need to be installed setuid root on some systems or
+ feature, rxvt may need to be installed setuid root on some systems or
setgid to root or to some other group on others.
COLORS AND GRAPHICS
- In addition to the default foreground and background colours, urxvt can
+ In addition to the default foreground and background colours, rxvt can
display up to 16 colours (8 ANSI colours plus high-intensity bold/blink
versions of the same). Here is a list of the colours with their rgb.txt
names.
*xterm*(1) where the colours are only swapped if they have not otherwise
been specified. For example,
- urxvt -fg Black -bg White -rv
+ rxvt -fg Black -bg White -rv
would yield White on Black, while on *xterm*(1) it would yield Black
on White.
ENVIRONMENT
- urxvt sets and/or uses the following environment variables:
+ rxvt sets and/or uses the following environment variables:
TERM
Normally set to "rxvt-unicode", unless overwritten at configure
time, via resources or on the commandline.
COLORTERM
- Either "rxvt", "rxvt-xpm", depending on wether urxvt was compiled
+ Either "rxvt", "rxvt-xpm", depending on wether rxvt was compiled
with XPM support, and optionally with the added extension "-mono" to
indicate that rxvt-unicode runs on a monochrome screen.
string "default" to indicate that the default-colour escape sequence
is to be used), "bg" is the colour code used as default background
colour (or the string "default"), and "xpm" is the string "default"
- if urxvt was compiled with XPM support. Libraries like "ncurses" and
+ if rxvt was compiled with XPM support. Libraries like "ncurses" and
"slang" can (and do) use this information to optimize screen output.
WINDOWID
- Set to the (decimal) X Window ID of the urxvt window (the toplevel
+ Set to the (decimal) X Window ID of the rxvt window (the toplevel
window, which usually has subwindows for the scrollbar, the terminal
window and so on).
TERMINFO
- Set to the terminfo directory iff urxvt was configured with
+ Set to the terminfo directory iff rxvt was configured with
"--with-terminfo=PATH".
DISPLAY
- Used by urxvt to connect to the display and set to the correct
+ Used by rxvt to connect to the display and set to the correct
display in it's child processes.
SHELL
The shell to be used for command execution, defaults to "/bin/sh".
RXVTPATH
- The path where urxvt looks for support files such as menu and xpm
+ The path where rxvt looks for support files such as menu and xpm
files.
PATH
Used in the same way as "RXVTPATH".
RXVT_SOCKET
- The unix domain socket path used by urxvtc(1) and urxvtd(1).
+ The unix domain socket path used by rxvtc(1) and rxvtd(1).
Default $HOME/.rxvt-unicode-*<nodename*.
XENVIRONMENT
If set and accessible, gives the name of a X resource file to be
- loaded by urxvt.
+ loaded by rxvt.
FILES
/usr/lib/X11/rgb.txt
Color names.
SEE ALSO
- urxvt(7), urxvtc(1), urxvtd(1), xterm(1), sh(1), resize(1), X(1),
- pty(4), tty(4), utmp(5)
+ rxvt(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4),
+ tty(4), utmp(5)
CURRENT PROJECT COORDINATOR
Project Coordinator
</dd>
<dd>
<pre>
- URxvt*imlocale: ja_JP.EUC-JP</pre>
+ URxvt.imlocale: ja_JP.EUC-JP</pre>
</dd>
<dd>
<p>Now you can start your terminal with <code>LC_CTYPE=ja_JP.UTF-8</code> and still
terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR:
.Sp
.Vb 1
-\& URxvt*imlocale: ja_JP.EUC-JP
+\& URxvt.imlocale: ja_JP.EUC-JP
.Ve
.Sp
Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still
You can specify separate locales for the input method and the rest of the
terminal, using the resource C<imlocale>:
- URxvt*imlocale: ja_JP.EUC-JP
+ URxvt.imlocale: ja_JP.EUC-JP
Now you can start your terminal with C<LC_CTYPE=ja_JP.UTF-8> and still
use your input method. Please note, however, that you will not be able to
You can specify separate locales for the input method and the rest
of the terminal, using the resource "imlocale":
- URxvt*imlocale: ja_JP.EUC-JP
+ URxvt.imlocale: ja_JP.EUC-JP
Now you can start your terminal with "LC_CTYPE=ja_JP.UTF-8" and
still use your input method. Please note, however, that you will not
.\" ========================================================================
.\"
.IX Title "rxvt 3"
-.TH rxvt 3 "2006-01-15" "7.0" "RXVT-UNICODE"
+.TH rxvt 3 "2006-01-16" "7.0" "RXVT-UNICODE"
.SH "NAME"
@@RXVT_NAME@@perl \- rxvt\-unicode's embedded perl interpreter
.SH "SYNOPSIS"
thisdir = src
# for developers: the following debug options may be used
-# -DDEBUG_CMD -DDEBUG_MAIN -DDEBUG_MENU -DDEBUG_MENUARROWS
-# -DDEBUG_MENUBAR_STACKING -DDEBUG_MENU_LAYOUT -DDEBUG_RESOURCES
+# -DDEBUG_CMD -DDEBUG_MAIN -DDEBUG_RESOURCES
# -DDEBUG_SEARCH_PATH -DDEBUG_SIZE -DDEBUG_TTY -DDEBUG_TTYMODE
# -DDEBUG_KEYBOARD
DEBUG=-DDEBUG_STRICT @DEBUG@
}
/*}}} */
-#if MENUBAR_MAX || defined (KEYSYM_RESOURCE)
-/*{{{ rxvt_cmd_write (), rxvt_cmd_getc () */
-/* attempt to `write' count to the input buffer */
+#if defined (KEYSYM_RESOURCE)
unsigned int
rxvt_term::cmd_write (const char *str, unsigned int count)
{
scrollBar.setIdle ();
scrollbar_show (0);
}
-#ifdef MENUBAR
- if (menubar_visible () && isMenuBarWindow (ev.xany.window))
- menubar_expose ();
-#endif
#ifdef TRANSPARENT
if (am_transparent && ev.xany.window == parent[0])
#ifdef POINTER_BLANK
if (hidden_pointer)
pointer_unblank ();
-#endif
-#if MENUBAR
- if (isMenuBarWindow (ev.xany.window))
- {
- menubar_control (ev.xbutton);
- break;
- }
#endif
if ((priv_modes & PrivMode_mouse_report) && !bypass_keystate)
break;
return;
}
-
-#if MENUBAR
- /*
- * Menubar window processing of button press
- */
- if (isMenuBarWindow (ev.window))
- menubar_control (ev);
-#endif
}
void
#endif
}
}
-#ifdef MENUBAR
- else if (isMenuBarWindow (ev.window))
- menubar_control (ev);
-#endif
}
#ifdef TRANSPARENT
// TODO, when secure mode?
break;
-#ifdef MENUBAR
- case URxvt_Menu:
- if (OPTION (Opt_insecure))
- menubar_dispatch (const_cast<char *>(str)); // casting away constness is checked
- break;
-#endif
#if 0
case Rxvt_dumpscreen: /* no error notices */
{
{ 7, PrivMode_Autowrap },
// 8, bi-directional support mode
{ 9, PrivMode_MouseX10 },
-#ifdef menuBar_esc
- { menuBar_esc, PrivMode_menuBar },
-#endif
// 18, 19 printing-related
{ 25, PrivMode_VisibleCursor },
#ifdef scrollBar_esc
if (state) /* orthogonal */
priv_modes &= ~PrivMode_MouseX11;
break;
-#ifdef menuBar_esc
- case menuBar_esc:
-#ifdef MENUBAR
- map_menuBar (state);
-#endif
- break;
-#endif
#ifdef scrollBar_esc
case scrollBar_esc:
if (scrollbar_mapping (state))
*/
/* #define SB_BORDER */
-/*------------------------------MENU BAR--------------------------------*/
-/*
- * Choose how many of (experimental) menuBars you want to be able to stack at
- * one time.
- * A value of 1 disables menuBar stacking.
- * A value of 0 disables menuBar all together.
- * Note that the amount of memory overhead is the same for any value >= 2.
- */
-#define MENUBAR_MAX 16
-
-/*
- * Change the default shadow style
- */
-/* #define MENUBAR_SHADOW_IN */
-
-/*
- * Change the default shadow style
- */
-#define MENU_SHADOW_IN
-
/*---------------------------MULTILINGUAL-------------------------------*/
/*
* Allow run-time selection of Meta (Alt) to set the 8th bit on
last_bot = last_state = -1;
-#ifdef MENUBAR
- menu_readonly = 1;
-# if ! (MENUBAR_MAX > 1)
- CurrentBar = &BarList;
-# endif /* (MENUBAR_MAX > 1) */
-#endif
-
return true;
}
#endif
/* add value for scrollBar */
- if (scrollbar_visible ())
+ if (scrollBar.state)
{
priv_modes |= PrivMode_scrollBar;
SavedModes |= PrivMode_scrollBar;
}
- if (menubar_visible ())
- {
- priv_modes |= PrivMode_menuBar;
- SavedModes |= PrivMode_menuBar;
- }
-
run_command (argv);
}
}
/*
- * get scrollBar/menuBar shadow colors
+ * get scrollBar shadow colors
*
* The calculations of topShadow/bottomShadow values are adapted
* from the fvwm window manager.
/* vt cursor: Black-on-White is standard, but this is more popular */
TermWin_cursor = XCreateFontCursor (disp, XC_xterm);
-#if defined(HAVE_SCROLLBARS) || defined(MENUBAR)
- /* cursor (menuBar/scrollBar): Black-on-White */
+#ifdef HAVE_SCROLLBARS
+ /* cursor scrollBar: Black-on-White */
leftptr_cursor = XCreateFontCursor (disp, XC_left_ptr);
#endif
vt_ev.start (display, vt);
-#if defined(MENUBAR) && (MENUBAR_MAX > 1)
- if (menuBar_height ())
- {
- menuBar.win = XCreateSimpleWindow (disp, top,
- window_vt_x, 0,
- width,
- menuBar_TotalHeight (),
- 0,
- pix_colors_focused[Color_fg],
- pix_colors_focused[Color_scroll]);
-
-#ifdef DEBUG_X
- XStoreName (disp, menuBar.win, "menubar");
-#endif
-
- menuBar.drawable = new rxvt_drawable (display, menuBar.win);
-
- XDefineCursor (disp, menuBar.win,
- XCreateFontCursor (disp, XC_left_ptr));
-
- XSelectInput (disp, menuBar.win,
- (ExposureMask | ButtonPressMask | ButtonReleaseMask | Button1MotionMask));
- menubar_ev.start (display, menuBar.win);
- }
-#endif
-
#ifdef XPM_BACKGROUND
if (rs[Rs_backgroundPixmap] != NULL
&& ! OPTION (Opt_transparent))
drawable = new rxvt_drawable (display, vt);
-#if defined(MENUBAR) || defined(RXVT_SCROLLBAR)
+#ifdef RXVT_SCROLLBAR
gcvalue.foreground = pix_colors[Color_topShadow];
topShadowGC = XCreateGC (disp, vt, GCForeground, &gcvalue);
gcvalue.foreground = pix_colors[Color_bottomShadow];
#ifdef HAVE_SCROLLBARS
scrollbar_ev (this, &rxvt_term::x_cb),
#endif
-#ifdef MENUBAR
- menubar_ev (this, &rxvt_term::x_cb),
-#endif
#ifdef CURSOR_BLINK
cursor_blink_ev (this, &rxvt_term::cursor_blink_cb),
#endif
#ifdef USE_XIM
im_destroy ();
#endif
-#ifdef MENUBAR
- if (menubarGC) XFreeGC (disp, menubarGC);
-#endif
#ifdef XTERM_SCROLLBAR
if (xscrollbarGC) XFreeGC (disp, xscrollbarGC);
if (ShadowGC) XFreeGC (disp, ShadowGC);
if (upArrowHi) XFreePixmap (disp, upArrowHi);
if (downArrowHi) XFreePixmap (disp, downArrowHi);
#endif
-#if defined(MENUBAR) || defined(RXVT_SCROLLBAR)
+#ifdef RXVT_SCROLLBAR
if (topShadowGC) XFreeGC (disp, topShadowGC);
if (botShadowGC) XFreeGC (disp, botShadowGC);
if (scrollbarGC) XFreeGC (disp, scrollbarGC);
#endif
if (gc) XFreeGC (disp, gc);
-#if defined(MENUBAR) && (MENUBAR_MAX > 1)
- delete menuBar.drawable;
- //if (menuBar.win)
- // XDestroyWindow (disp, menuBar.win);
-#endif
delete drawable;
// destroy all windows
if (parent[0])
#if HAVE_SCROLLBARS
scrollbar_ev.stop (display);
#endif
-#if MENUBAR
- menubar_ev.stop (display);
-#endif
#if TRANSPARENT
rootwin_ev.stop (display);
#endif
keyboard->register_done ();
#endif
-#if MENUBAR_MAX
- menubar_read (rs[Rs_menu]);
-#endif
#ifdef HAVE_SCROLLBARS
if (OPTION (Opt_scrollBar))
scrollBar.setIdle (); /* set existence for size calculations */
if (OPTION (Opt_scrollBar))
resize_scrollbar (); /* create and map scrollbar */
#endif
-#if (MENUBAR_MAX)
- if (menubar_visible ())
- XMapWindow (disp, menuBar.win);
-#endif
#ifdef TRANSPARENT
if (OPTION (Opt_transparent))
{
rxvt_term::window_calc (unsigned int newwidth, unsigned int newheight)
{
short recalc_x, recalc_y;
- int x, y, sb_w, mb_h, flags;
+ int x, y, sb_w, flags;
unsigned int w, h;
unsigned int max_width, max_height;
dDisp;
szHint.base_width = szHint.base_height = 2 * int_bwidth;
- sb_w = mb_h = 0;
+ sb_w = 0;
window_vt_x = window_vt_y = int_bwidth;
- if (scrollbar_visible ())
+ if (scrollBar.state)
{
sb_w = scrollbar_TotalWidth ();
szHint.base_width += sb_w;
window_vt_x += sb_w;
}
- if (menubar_visible ())
- {
- mb_h = menuBar_TotalHeight ();
- szHint.base_height += mb_h;
- window_vt_y += mb_h;
- }
-
szHint.width_inc = fwidth;
szHint.height_inc = fheight;
szHint.min_width = szHint.base_width + szHint.width_inc;
szHint.height = szHint.base_height + height;
}
- if (scrollbar_visible () && OPTION (Opt_scrollBar_right))
+ if (scrollBar.state && OPTION (Opt_scrollBar_right))
window_sb_x = szHint.width - sb_w;
if (recalc_x)
if (fix_screen || newwidth != old_width || newheight != old_height)
{
- if (scrollbar_visible ())
+ if (scrollBar.state)
{
XMoveResizeWindow (disp, scrollBar.win,
window_sb_x, 0,
resize_scrollbar ();
}
- if (menubar_visible ())
- XMoveResizeWindow (disp, menuBar.win,
- window_vt_x, 0,
- width, menuBar_TotalHeight ());
-
XMoveResizeWindow (disp, vt,
window_vt_x, window_vt_y,
width, height);
/* #define DEBUG_SEARCH_PATH */
-#if defined (XPM_BACKGROUND) || (MENUBAR_MAX)
+#ifdef XPM_BACKGROUND
/*
* search for FILE in the current working directory, and within the
* colon-delimited PATHLIST, adding the file extension EXT if required.
return f;
}
-#endif /* defined (XPM_BACKGROUND) || (MENUBAR_MAX) */
+#endif
/*----------------------------------------------------------------------*
* miscellaneous drawing routines
/*
* Draw top/left and bottom/right border shadows around windows
*/
-#if defined(RXVT_SCROLLBAR) || defined(MENUBAR)
+#ifdef RXVT_SCROLLBAR
void
rxvt_Draw_Shadow (Display *display, Window win, GC topShadow, GC botShadow, int x, int y, int w, int h)
{
}
#endif
-/* button shapes */
-#ifdef MENUBAR
-void
-rxvt_Draw_Triangle (Display *display, Window win, GC topShadow, GC botShadow, int x, int y, int w, int type)
-{
- switch (type)
- {
- case 'r': /* right triangle */
- XDrawLine (display, win, topShadow, x, y, x, y + w);
- XDrawLine (display, win, topShadow, x, y, x + w, y + w / 2);
- XDrawLine (display, win, botShadow, x, y + w, x + w, y + w / 2);
- break;
-
- case 'l': /* left triangle */
- XDrawLine (display, win, botShadow, x + w, y + w, x + w, y);
- XDrawLine (display, win, botShadow, x + w, y + w, x, y + w / 2);
- XDrawLine (display, win, topShadow, x, y + w / 2, x + w, y);
- break;
-
- case 'd': /* down triangle */
- XDrawLine (display, win, topShadow, x, y, x + w / 2, y + w);
- XDrawLine (display, win, topShadow, x, y, x + w, y);
- XDrawLine (display, win, botShadow, x + w, y, x + w / 2, y + w);
- break;
-
- case 'u': /* up triangle */
- XDrawLine (display, win, botShadow, x + w, y + w, x + w / 2, y);
- XDrawLine (display, win, botShadow, x + w, y + w, x, y + w);
- XDrawLine (display, win, topShadow, x, y + w, x + w / 2, y);
- break;
-#if 0
- case 's': /* square */
- XDrawLine (display, win, topShadow, x + w, y, x, y);
- XDrawLine (display, win, topShadow, x, y, x, y + w);
- XDrawLine (display, win, botShadow, x, y + w, x + w, y + w);
- XDrawLine (display, win, botShadow, x + w, y + w, x + w, y);
- break;
-#endif
-
- }
-}
-#endif
-
// should not be used in interactive programs, for obvious reasons
void rxvt_usleep (int usecs)
{
#endif
def (name)
def (title)
-#if defined (XPM_BACKGROUND) || (MENUBAR_MAX)
- def (path)
-#endif
#ifdef XPM_BACKGROUND
+ def (path)
def (backgroundPixmap)
-#endif
-#if (MENUBAR_MAX)
- def (menu)
#endif
def (loginShell)
def (jumpScroll)
*/
struct grwin_t;
-/* Sanitize menubar info */
-#ifndef MENUBAR
-# undef MENUBAR_MAX
-#endif
-#ifndef MENUBAR_MAX
-# define MENUBAR_MAX 0
-#endif
-
/* If we're using either the rxvt scrollbar or menu bars, keep the
* scrollColor resource.
*/
-#if defined(RXVT_SCROLLBAR) || defined(NEXT_SCROLLBAR) || defined(MENUBAR) || defined(PLAIN_SCROLLBAR)
+#if defined(RXVT_SCROLLBAR) || defined(NEXT_SCROLLBAR) || defined(PLAIN_SCROLLBAR)
# define KEEP_SCROLLCOLOR 1
#else
# undef KEEP_SCROLLCOLOR
# define EXIT_FAILURE 1 /* exit function failure */
#endif
-#define menuBar_esc 10
#define scrollBar_esc 30
-#define menuBar_margin 2 /* margin below text */
#if defined(RXVT_SCROLLBAR) || defined(NEXT_SCROLLBAR) || defined(XTERM_SCROLLBAR) || defined(PLAIN_SCROLLBAR)
# define HAVE_SCROLLBARS 1
#endif
-/* width of scrollBar, menuBar shadow, must be 1 or 2 */
+/* width of scrollBar shadow, must be 1 or 2 */
#ifdef HALFSHADOW
# define MENU_SHADOW 1
#else
#define PrivMode_MouseX10 (1UL<<12)
#define PrivMode_MouseX11 (1UL<<13)
#define PrivMode_scrollBar (1UL<<14)
-#define PrivMode_menuBar (1UL<<15)
-#define PrivMode_TtyOutputInh (1UL<<16)
-#define PrivMode_Keypress (1UL<<17)
-#define PrivMode_smoothScroll (1UL<<18)
-#define PrivMode_vt52 (1UL<<19)
-#define PrivMode_LFNL (1UL<<20)
+#define PrivMode_TtyOutputInh (1UL<<15)
+#define PrivMode_Keypress (1UL<<16)
+#define PrivMode_smoothScroll (1UL<<17)
+#define PrivMode_vt52 (1UL<<18)
+#define PrivMode_LFNL (1UL<<19)
/* too annoying to implement X11 highlight tracking */
-/* #define PrivMode_MouseX11Track (1LU<<21) */
+/* #define PrivMode_MouseX11Track (1LU<<20) */
#define PrivMode_mouse_report (PrivMode_MouseX10|PrivMode_MouseX11)
#define PrivMode(test,bit) \
#define scrollbar_size() (scrollBar.end - scrollBar.beg \
- scrollbar_minheight ())
-#if (MENUBAR_MAX > 1)
-/* rendition style flags */
-# define menuBar_height() (fheight + MENU_SHADOW)
-# define menuBar_TotalHeight() (menuBar_height() + MENU_SHADOW + menuBar_margin)
-# define isMenuBarWindow(w) ((w) == menuBar.win)
-#else
-# define menuBar_height() (0)
-# define menuBar_TotalHeight() (0)
-# define isMenuBarWindow(w) (0)
-#endif
-
#ifdef XPM_BACKGROUND
# define XPMClearArea(a, b, c, d, e, f, g) XClearArea((a), (b), (c), (d), (e), (f), (g))
#else
/****************************************************************************/
-#ifdef MENUBAR
-# include "menubar.h"
-#endif
-
#define BLINK_INTERVAL 0.5
#define TEXT_BLINK_INTERVAL 0.5
last_top, /* scrollbar last top position */
last_state, /* scrollbar last state */
scrollbar_len,
-#ifdef MENUBAR
- menu_readonly, /* okay to alter menu? */
- Arrows_x,
-#endif
-#if MENUBAR_MAX > 1
- Nbars,
-#endif
window_vt_x,
window_vt_y,
window_sb_x,
/* ---------- */
Atom xa[NUM_XA];
/* ---------- */
-#ifdef MENUBAR
- GC menubarGC;
-#endif
-#if defined(MENUBAR) || defined(RXVT_SCROLLBAR)
+#ifdef RXVT_SCROLLBAR
GC scrollbarGC,
topShadowGC,
botShadowGC;
bgPixmap_t bgPixmap;
XpmAttributes xpmAttr; /* originally loaded pixmap and its scaling */
#endif
-#ifdef MENUBAR
- menu_t *ActiveMenu, /* currently active menu */
- *BuildMenu; /* the menu currently being built */
- bar_t *CurrentBar;
-# if ! (MENUBAR_MAX > 1)
- bar_t BarList;
-# endif /* (MENUBAR_MAX > 1) */
-#endif
#if ENABLE_OVERLAY
int ov_x, ov_y, ov_w, ov_h; // overlay dimensions
#ifdef HAVE_SCROLLBARS
xevent_watcher scrollbar_ev;
#endif
-#ifdef MENUBAR
- xevent_watcher menubar_ev;
-#endif
void check_cb (check_watcher &w); check_watcher check_ev;
void destroy_cb (time_watcher &w); time_watcher destroy_ev;
int rXParseAllocColor (rxvt_color * screen_in_out, const char *colour);
void set_widthheight (unsigned int newwidth, unsigned int newheight);
-#ifdef MENUBAR
- // menubar.C
- void menuitem_free (menu_t *menu, menuitem_t *item);
- int action_dispatch (action_t *action);
- void menuarrow_free (char name);
- void menuarrow_add (char *string);
- char *menu_find_base (menu_t **menu, char *path);
- menu_t *menu_delete (menu_t *menu);
- menu_t *menu_add (menu_t *parent, char *path);
- void drawbox_menubar (int x, int len, int state);
- void drawtriangle (int x, int y, int state);
- void drawbox_menuitem (int y, int state);
- void menu_show ();
- void menu_display (void (rxvt_term::*update) ());
- void menu_hide_all ();
- void menu_hide ();
- void menu_clear (menu_t *menu);
- void menubar_clear ();
- bar_t *menubar_find (const char *name);
- int menubar_push (const char *name);
- void menubar_remove (const char *name);
- void menubar_dump (FILE *fp);
- void menubar_read (const char *filename);
- void menubar_dispatch (char *str);
- void draw_Arrows (int name, int state);
- void menubar_expose ();
- int menubar_mapping (int map);
- int menu_select (XButtonEvent &ev);
- void menubar_select (XButtonEvent &ev);
- void menubar_control (XButtonEvent &ev);
- void map_menuBar (int map);
-#endif
-
// screen.C
void lalloc (line_t &l) const
#define SET_R(r) rxvt_current_term = const_cast<rxvt_term *>(r)
#define GET_R rxvt_current_term
-#define scrollbar_visible() scrollBar.state
-#define menubar_visible() menuBar.state
-
typedef struct {
int row;
int col;
/* ------------------------------------------------------------------------- */
-typedef struct {
- short state;
- Window win;
- struct rxvt_drawable *drawable;
-} menuBar_t;
-
typedef struct {
char state; /* scrollbar state */
char init; /* scrollbar has been initialised */
struct rxvt_vars : TermWin_t {
scrollBar_t scrollBar;
- menuBar_t menuBar;
uint32_t options;
XSizeHints szHint;
rxvt_display *display;
#include "perlxsi.c"
-#if defined(HAVE_SCROLLBARS) || defined(MENUBAR)
+#ifdef HAVE_SCROLLBARS
# define GRAB_CURSOR THIS->leftptr_cursor
#else
# define GRAB_CURSOR None
#ifdef HAVE_SCROLLBARS
int top, bot, len, adj;
- if (!scrollbar_visible ())
+ if (!scrollBar.state)
return 0;
if (update)
STRG (Rs_color + Color_pointer_fg, "pointerColor", "pr", "color", "pointer color"),
STRG (Rs_color + Color_pointer_bg, "pointerColor2", "pr2", "color", "pointer bg color"),
STRG (Rs_color + Color_border, "borderColor", "bd", "color", "border color"),
-#if defined (XPM_BACKGROUND) || (MENUBAR_MAX)
- RSTRG (Rs_path, "path", "search path"),
-#endif /* defined (XPM_BACKGROUND) || (MENUBAR_MAX) */
#ifdef XPM_BACKGROUND
+ RSTRG (Rs_path, "path", "search path"),
STRG (Rs_backgroundPixmap, "backgroundPixmap", "pixmap", "file[;geom]", "background pixmap"),
-#endif /* XPM_BACKGROUND */
-#if (MENUBAR_MAX)
- RSTRG (Rs_menu, "menu", "name[;tag]"),
#endif
/* fonts: command-line option = resource name */
STRG (Rs_font, "font", "fn", "fontname", "normal text font"),
#if defined(UTMP_SUPPORT)
"utmp,"
#endif
-#if defined(MENUBAR)
- "menubar,"
-#endif
#if defined(USE_XIM)
"XIM,"
#endif
projects / dana / urxvt.git / commitdiff