ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1.html
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.1.html (file contents):
Revision 1.11 by root, Fri Feb 11 18:14:07 2005 UTC vs.
Revision 1.18 by root, Fri Feb 18 12:15:07 2005 UTC

… …
47<p><strong>rxvt</strong> [options] [-e command [ args ]]</p> 47<p><strong>rxvt</strong> [options] [-e command [ args ]]</p>
48<p> 48<p>
49</p> 49</p>
50<hr /> 50<hr />
51<h1><a name="description">DESCRIPTION</a></h1> 51<h1><a name="description">DESCRIPTION</a></h1>
52<p><strong>rxvt-unicode</strong>, version <strong>5.0</strong>, is a colour vt102 terminal 52<p><strong>rxvt-unicode</strong>, version <strong>5.2</strong>, is a colour vt102 terminal
53emulator intended as an <em>xterm</em>(1) replacement for users who do not 53emulator intended as an <em>xterm</em>(1) replacement for users who do not
54require features such as Tektronix 4014 emulation and toolkit-style 54require features such as Tektronix 4014 emulation and toolkit-style
55configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- 55configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
56a significant advantage on a machine serving many X sessions.</p> 56a significant advantage on a machine serving many X sessions.</p>
57<p> 57<p>
… …
511<dd> 511<dd>
512Turn on/off secondary screen scroll (default enabled); resource 512Turn on/off secondary screen scroll (default enabled); resource
513<strong>secondaryScroll</strong>. 513<strong>secondaryScroll</strong>.
514</dd> 514</dd>
515<p></p> 515<p></p>
516<dt><strong><a name="item__2dkeysym_2esym_3a_string"><strong>-keysym.</strong><em>sym</em>: <em>string</em></a></strong><br /> 516<dt><strong><a name="item__2dkeysym_2esym_string"><strong>-keysym.</strong><em>sym</em> <em>string</em></a></strong><br />
517</dt> 517</dt>
518<dd> 518<dd>
519Remap a key symbol. See resource <strong>keysym</strong>. 519Remap a key symbol. See resource <strong>keysym</strong>.
520</dd> 520</dd>
521<p></p> 521<p></p>
522<dt><strong><a name="item__2dxrm_resourcestring"><strong>-xrm</strong> <em>resourcestring</em></a></strong><br /> 522<dt><strong><a name="item__2dembed_windowid"><strong>-embed</strong> <em>windowid</em></a></strong><br />
523</dt> 523</dt>
524<dd>
525Tells rxvt to embed it's windows into an already-existing window,
526which enables applications to easily embed a terminal.
524<dd> 527</dd>
525No effect on rxvt-unicode. Simply passes through an argument to be made 528<dd>
526available in the instance's argument list. Appears in <em>WM_COMMAND</em> in 529<p>Right now, rxvt will first unmap/map the specified window, so it
527some window managers. 530shouldn't be a top-level window. rxvt will also reconfigure it
531quite a bit, so don't expect it to keep some specific state. It's best to
532create an extra subwindow for rxvt and leave it alone.</p>
533</dd>
534<dd>
535<p>The window will not be destroyed when rxvt exits.</p>
536</dd>
537<dd>
538<p>It might be useful to know that rxvt will not close file
539descriptors passed to it (except for stdin/out/err, of course), so you
540can use file descriptors to communicate with the programs within the
541terminal. This works regardless of wether the <code>-embed</code> option was used or
542not.</p>
543</dd>
544<dd>
545<p>Here is a short Gtk2-perl snippet that illustrates how this option can be
546used (a longer example is in <em>doc/embed</em>):</p>
547</dd>
548<dd>
549<pre>
550 my $rxvt = new Gtk2::DrawingArea;
551 $...-&gt;add ($rxvt); # important to add it somewhere first
552 $rxvt-&gt;realize; # now it can be realized
553 my $xid = $rxvt-&gt;window-&gt;get_xid;</pre>
554</dd>
555<dd>
556<pre>
557 system &quot;rxvt -embed $xid &amp;&quot;;</pre>
558</dd>
559<p></p>
560<dt><strong><a name="item__2dpty_2dfd_fileno"><strong>-pty-fd</strong> <em>fileno</em></a></strong><br />
561</dt>
562<dd>
563Tells rxvt NOT to execute any commands or create a new pty/tty
564pair but instead use the given filehandle as the tty master. This is
565useful if you want to drive rxvt as a generic terminal emulator
566without having to run a program within it.
567</dd>
568<dd>
569<p>If this switch is given, rxvt will not create any utmp/wtmp
570entries and will not tinker with pty/tty permissions - you have to do that
571yourself if you want that.</p>
572</dd>
573<dd>
574<p>Here is a example in perl that illustrates how this option can be used (a
575longer example is in <em>doc/pty-fd</em>):</p>
576</dd>
577<dd>
578<pre>
579 use IO::Pty;
580 use Fcntl;</pre>
581</dd>
582<dd>
583<pre>
584 my $pty = new IO::Pty;
585 fcntl $pty, F_SETFD, 0; # clear close-on-exec
586 system &quot;rxvt -pty-fd &quot; . (fileno $pty) . &quot;&amp;&quot;;
587 close $pty;</pre>
588</dd>
589<dd>
590<pre>
591 # now communicate with rxvt
592 my $slave = $pty-&gt;slave;
593 while (&lt;$slave&gt;) { print $slave &quot;got &lt;$_&gt;\n&quot; }</pre>
528</dd> 594</dd>
529<p></p></dl> 595<p></p></dl>
530<p> 596<p>
531</p> 597</p>
532<hr /> 598<hr />
… …
926<p></p> 992<p></p>
927<dt><strong><a name="item_scrollwithbuffer_3a_boolean"><strong>scrollWithBuffer:</strong> <em>boolean</em></a></strong><br /> 993<dt><strong><a name="item_scrollwithbuffer_3a_boolean"><strong>scrollWithBuffer:</strong> <em>boolean</em></a></strong><br />
928</dt> 994</dt>
929<dd> 995<dd>
930<strong>True</strong>: scroll with scrollback buffer when tty receives new lines (and 996<strong>True</strong>: scroll with scrollback buffer when tty receives new lines (and
931<strong>scrollTtyOutput</strong> is False); option <strong>+sw</strong>. <strong>False</strong>: do not scroll 997<strong>scrollTtyOutput</strong> is False); option <strong>-sw</strong>. <strong>False</strong>: do not scroll
932with scrollback buffer when tty recieves new lines; option <strong>-sw</strong>. 998with scrollback buffer when tty recieves new lines; option <strong>+sw</strong>.
933</dd> 999</dd>
934<p></p> 1000<p></p>
935<dt><strong><a name="item_scrollttykeypress_3a_boolean"><strong>scrollTtyKeypress:</strong> <em>boolean</em></a></strong><br /> 1001<dt><strong><a name="item_scrollttykeypress_3a_boolean"><strong>scrollTtyKeypress:</strong> <em>boolean</em></a></strong><br />
936</dt> 1002</dt>
937<dd> 1003<dd>
… …
1441Set to a string of the form <code>fg;bg</code> or <code>fg;xpm;bg</code>, where <code>fg</code> is 1507Set to a string of the form <code>fg;bg</code> or <code>fg;xpm;bg</code>, where <code>fg</code> is
1442the colour code used as default foreground/text colour (or the string 1508the colour code used as default foreground/text colour (or the string
1443<code>default</code> to indicate that the default-colour escape sequence is to be 1509<code>default</code> to indicate that the default-colour escape sequence is to be
1444used), <code>bg</code> is the colour code used as default background colour (or the 1510used), <code>bg</code> is the colour code used as default background colour (or the
1445string <code>default</code>), and <code>xpm</code> is the string <code>default</code> if rxvt 1511string <code>default</code>), and <code>xpm</code> is the string <code>default</code> if rxvt
1446was compiled with XPM support. Libraries like <code>slang</code> can (and do) use 1512was compiled with XPM support. Libraries like <code>ncurses</code> and <code>slang</code> can
1447this information to optimize screen output. 1513(and do) use this information to optimize screen output.
1448</dd> 1514</dd>
1449<p></p> 1515<p></p>
1450<dt><strong><a name="item_windowid"><strong>WINDOWID</strong></a></strong><br /> 1516<dt><strong><a name="item_windowid"><strong>WINDOWID</strong></a></strong><br />
1451</dt> 1517</dt>
1452<dd> 1518<dd>
… …
1548<h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1> 1614<h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1>
1549<dl> 1615<dl>
1550<dt><strong><a name="item_project_coordinator">Project Coordinator</a></strong><br /> 1616<dt><strong><a name="item_project_coordinator">Project Coordinator</a></strong><br />
1551</dt> 1617</dt>
1552<dd> 1618<dd>
1553Marc A. Lehmann <em><a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a></em> 1619Marc A. Lehmann <em><a href="mailto:<rxvt-unicode@schmorp.de"><rxvt-unicode@schmorp.de</a></em>&gt;
1554</dd>
1555<dd> 1620</dd>
1621<dd>
1556<p><a href="http://software.schmorp.de/">http://software.schmorp.de/</a></p> 1622<p><a href="http://software.schmorp.de/#rxvt-unicode">http://software.schmorp.de/#rxvt-unicode</a></p>
1557</dd> 1623</dd>
1558<p></p></dl> 1624<p></p></dl>
1559<p> 1625<p>
1560</p> 1626</p>
1561<hr /> 1627<hr />
… …
1599<dd> 1665<dd>
1600Rewrote screen display and text selection routines. Project Coordinator 1666Rewrote screen display and text selection routines. Project Coordinator
1601(changes.txt 2.4.6 - rxvt-unicode) 1667(changes.txt 2.4.6 - rxvt-unicode)
1602</dd> 1668</dd>
1603<p></p> 1669<p></p>
1604<dt><strong><a name="item_marc_alexander_lehmann__3crxvt_40schmorp_2ede_3e">Marc Alexander Lehmann <em><a href="mailto:<rxvt@schmorp.de"><rxvt@schmorp.de</a></em>&gt;</a></strong><br /> 1670<dt><strong><a name="item_marc_alexander_lehmann__3crxvt_2dunicode_40schmorp">Marc Alexander Lehmann <em><a href="mailto:<rxvt-unicode@schmorp.de"><rxvt-unicode@schmorp.de</a></em>&gt;</a></strong><br />
1605</dt> 1671</dt>
1606<dd> 1672<dd>
1607Forked rxvt-unicode, rewrote most of the display code and internal 1673Forked rxvt-unicode, rewrote most of the display code and internal
1608character handling to store text in unicode, improve xterm 1674character handling to store text in unicode, improve xterm
1609compatibility and apply numerous other bugfixes and extensions. 1675compatibility and apply numerous other bugfixes and extensions.

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines