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

Comparing rxvt-unicode/doc/rxvt.1.txt (file contents):
Revision 1.16 by root, Wed Feb 16 22:16:30 2005 UTC vs.
Revision 1.19 by root, Sat Feb 19 01:08:26 2005 UTC

311 311
312 -ssr|+ssr 312 -ssr|+ssr
313 Turn on/off secondary screen scroll (default enabled); resource 313 Turn on/off secondary screen scroll (default enabled); resource
314 secondaryScroll. 314 secondaryScroll.
315 315
316 -keysym.*sym*: *string* 316 -keysym.*sym* *string*
317 Remap a key symbol. See resource keysym. 317 Remap a key symbol. See resource keysym.
318 318
319 -embed: *windowid* 319 -embed *windowid*
320 Tells rxvt to embed it's windows into an already-existing window, 320 Tells rxvt to embed it's windows into an already-existing window,
321 which enables applications to easily embed a terminal. 321 which enables applications to easily embed a terminal.
322 322
323 Right now, rxvt will first unmap/map the specified window, so it 323 Right now, rxvt will first unmap/map the specified window, so it
324 shouldn't be a top-level window. rxvt will also reconfigure it quite 324 shouldn't be a top-level window. rxvt will also reconfigure it quite
330 It might be useful to know that rxvt will not close file descriptors 330 It might be useful to know that rxvt will not close file descriptors
331 passed to it (except for stdin/out/err, of course), so you can use 331 passed to it (except for stdin/out/err, of course), so you can use
332 file descriptors to communicate with the programs within the 332 file descriptors to communicate with the programs within the
333 terminal. This works regardless of wether the "-embed" option was 333 terminal. This works regardless of wether the "-embed" option was
334 used or not. 334 used or not.
335
336 Here is a short Gtk2-perl snippet that illustrates how this option
337 can be used (a longer example is in doc/embed):
338
339 my $rxvt = new Gtk2::Socket;
340 $rxvt->signal_connect_after (realize => sub {
341 my $xid = $_[0]->window->get_xid;
342 system "rxvt -embed $xid &";
343 });
344
345 -pty-fd *fileno*
346 Tells rxvt NOT to execute any commands or create a new pty/tty pair
347 but instead use the given filehandle as the tty master. This is
348 useful if you want to drive rxvt as a generic terminal emulator
349 without having to run a program within it.
350
351 If this switch is given, rxvt will not create any utmp/wtmp entries
352 and will not tinker with pty/tty permissions - you have to do that
353 yourself if you want that.
354
355 Here is a example in perl that illustrates how this option can be
356 used (a longer example is in doc/pty-fd):
357
358 use IO::Pty;
359 use Fcntl;
360
361 my $pty = new IO::Pty;
362 fcntl $pty, F_SETFD, 0; # clear close-on-exec
363 system "rxvt -pty-fd " . (fileno $pty) . "&";
364 close $pty;
365
366 # now communicate with rxvt
367 my $slave = $pty->slave;
368 while (<$slave>) { print $slave "got <$_>\n" }
335 369
336RESOURCES (available also as long-options) 370RESOURCES (available also as long-options)
337 Note: `rxvt --help' gives a list of all resources (long options) 371 Note: `rxvt --help' gives a list of all resources (long options)
338 compiled into your version. 372 compiled into your version.
339 373

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines