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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.54 by root, Fri Feb 11 18:55:39 2005 UTC vs.
Revision 1.60 by root, Thu Feb 17 15:13:47 2005 UTC

… …
368=item B<-ssr>|B<+ssr> 368=item B<-ssr>|B<+ssr>
369 369
370Turn on/off secondary screen scroll (default enabled); resource 370Turn on/off secondary screen scroll (default enabled); resource
371B<secondaryScroll>. 371B<secondaryScroll>.
372 372
373=item B<-keysym.>I<sym>: I<string> 373=item B<-keysym.>I<sym> I<string>
374 374
375Remap a key symbol. See resource B<keysym>. 375Remap a key symbol. See resource B<keysym>.
376 376
377=item B<-xrm> I<resourcestring> 377=item B<-embed> I<windowid>
378 378
379No effect on rxvt-unicode. Simply passes through an argument to be made 379Tells @@RXVT_NAME@@ to embed it's windows into an already-existing window,
380available in the instance's argument list. Appears in I<WM_COMMAND> in 380which enables applications to easily embed a terminal.
381some window managers. 381
382Right now, @@RXVT_NAME@@ will first unmap/map the specified window, so it
383shouldn't be a top-level window. @@RXVT_NAME@@ will also reconfigure it
384quite a bit, so don't expect it to keep some specific state. It's best to
385create an extra subwindow for @@RXVT_NAME@@ and leave it alone.
386
387The window will not be destroyed when @@RXVT_NAME@@ exits.
388
389It might be useful to know that @@RXVT_NAME@@ will not close file
390descriptors passed to it (except for stdin/out/err, of course), so you
391can use file descriptors to communicate with the programs within the
392terminal. This works regardless of wether the C<-embed> option was used or
393not.
394
395Here is a short Gtk2-perl snippet that illustrates how this option can be
396used (a longer example is in F<doc/embed>):
397
398 my $rxvt = new Gtk2::DrawingArea;
399 $...->add ($rxvt); # important to add it somewhere first
400 $rxvt->realize; # now it can be realized
401 my $xid = $rxvt->window->get_xid;
402
403 system "@@RXVT_NAME@@ -embed $xid &";
404
405=item B<-pty-fd> I<fileno>
406
407Tells @@RXVT_NAME@@ NOT to execute any commands or create a new pty/tty
408pair but instead use the given filehandle as the tty master. This is
409useful if you want to drive @@RXVT_NAME@@ as a generic terminal emulator
410without having to run a program within it.
411
412If this switch is given, @@RXVT_NAME@@ will not create any utmp/wtmp
413entries and will not tinker with pty/tty permissions - you have to do that
414yourself if you want that.
415
416Here is a example in perl that illustrates how this option can be used (a
417longer example is in F<doc/pty-fd>):
418
419 use IO::Pty;
420 use Fcntl;
421
422 my $pty = new IO::Pty;
423 fcntl $pty, F_SETFD, 0; # clear close-on-exec
424 system "@@RXVT_NAME@@ -pty-fd " . (fileno $pty) . "&";
425 close $pty;
426
427 # now communicate with rxvt
428 my $slave = $pty->slave;
429 while (<$slave>) { print $slave "got <$_>\n" }
382 430
383=back 431=back
384 432
385=head1 RESOURCES (available also as long-options) 433=head1 RESOURCES (available also as long-options)
386 434
… …
692B<+si>. 740B<+si>.
693 741
694=item B<scrollWithBuffer:> I<boolean> 742=item B<scrollWithBuffer:> I<boolean>
695 743
696B<True>: scroll with scrollback buffer when tty receives new lines (and 744B<True>: scroll with scrollback buffer when tty receives new lines (and
697B<scrollTtyOutput> is False); option B<+sw>. B<False>: do not scroll 745B<scrollTtyOutput> is False); option B<-sw>. B<False>: do not scroll
698with scrollback buffer when tty recieves new lines; option B<-sw>. 746with scrollback buffer when tty recieves new lines; option B<+sw>.
699 747
700=item B<scrollTtyKeypress:> I<boolean> 748=item B<scrollTtyKeypress:> I<boolean>
701 749
702B<True>: scroll to bottom when a non-special key is pressed. Special keys 750B<True>: scroll to bottom when a non-special key is pressed. Special keys
703are those which are intercepted by rxvt-unicode for special handling and 751are those which are intercepted by rxvt-unicode for special handling and
… …
1218 1266
1219=over 4 1267=over 4
1220 1268
1221=item Project Coordinator 1269=item Project Coordinator
1222 1270
1223@@RXVT_MAINT@@ L<@@RXVT_MAINTEMAIL@@> 1271Marc A. Lehmann L<< <rxvt-unicode@schmorp.de> >>
1224 1272
1225L<@@RXVT_WEBPAGE@@> 1273L<http://software.schmorp.de/#rxvt-unicode>
1226 1274
1227=back 1275=back
1228 1276
1229=head1 AUTHORS 1277=head1 AUTHORS
1230 1278
… …
1255=item Geoff Wing L<< <gcw@pobox.com> >> 1303=item Geoff Wing L<< <gcw@pobox.com> >>
1256 1304
1257Rewrote screen display and text selection routines. Project Coordinator 1305Rewrote screen display and text selection routines. Project Coordinator
1258(changes.txt 2.4.6 - rxvt-unicode) 1306(changes.txt 2.4.6 - rxvt-unicode)
1259 1307
1260=item Marc Alexander Lehmann L<< <rxvt@schmorp.de> >> 1308=item Marc Alexander Lehmann L<< <rxvt-unicode@schmorp.de> >>
1261 1309
1262Forked rxvt-unicode, rewrote most of the display code and internal 1310Forked rxvt-unicode, rewrote most of the display code and internal
1263character handling to store text in unicode, improve xterm 1311character handling to store text in unicode, improve xterm
1264compatibility and apply numerous other bugfixes and extensions. 1312compatibility and apply numerous other bugfixes and extensions.
1265 1313

Diff Legend

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