--- rxvt-unicode/src/urxvt.pm	2006/01/25 15:11:31	1.129
+++ rxvt-unicode/src/urxvt.pm	2006/02/06 05:40:15	1.132
@@ -207,6 +207,18 @@
 B<Shift-Right> will switch to the tab left or right of the current one,
 while B<Shift-Down> creates a new tab.
 
+The tabbar itself can be configured similarly to a normal terminal, but
+with a resource class of C<URxvt.tabbed>. In addition, it supports the
+following four resources (shown with defaults):
+
+   URxvt.tabbed.tabbar-fg: <colour-index, default 3>
+   URxvt.tabbed.tabbar-bg: <colour-index, default 0>
+   URxvt.tabbed.tab-fg:    <colour-index, default 0>
+   URxvt.tabbed.tab-bg:    <colour-index, default 1>
+
+See I<COLOR AND GRAPHICS> in the @@RXVT_NAME@@(1) manpage for valid
+indices.
+
 =item mark-urls
 
 Uses per-line display filtering (C<on_line_update>) to underline urls and
@@ -244,7 +256,7 @@
 
 Displays a digital clock using the built-in overlay.
 
-=item remote-selection
+=item remote-clipboard
 
 Somewhat of a misnomer, this extension adds two menu entries to the
 selection popup that allows one ti run external commands to store the
@@ -517,12 +529,15 @@
 
 Called just after the screen gets redrawn. See C<on_refresh_begin>.
 
-=item on_keyboard_command $term, $string
+=item on_user_command $term, $string
 
-Called whenever the user presses a key combination that has a
-C<perl:string> action bound to it (see description of the B<keysym>
+Called whenever the a user-configured event is being activated (e.g. via
+a C<perl:string> action bound to a key, see description of the B<keysym>
 resource in the @@RXVT_NAME@@(1) manpage).
 
+The event is simply the action string. This interface is assumed to change
+slightly in the future.
+
 =item on_x_event $term, $event
 
 Called on every X event received on the vt window (and possibly other
@@ -666,6 +681,13 @@
 
 Messages have a size limit of 1023 bytes currently.
 
+=item @terms = urxvt::termlist
+
+Returns all urxvt::term objects that exist in this process, regardless of
+wether they are started, being destroyed etc., so be careful. Only term
+objects that have perl extensions attached will be returned (because there
+is no urxvt::term objet associated with others).
+
 =item $time = urxvt::NOW
 
 Returns the "current time" (as per the event loop).
@@ -733,6 +755,8 @@
 
 =item $rend = urxvt::SET_BGCOLOR $rend, $new_colour
 
+=item $rend = urxvt::SET_COLOR $rend, $new_fg, $new_bg
+
 Replace the foreground/background colour in the rendition mask with the
 specified one.
 
@@ -879,6 +903,10 @@
    $retval
 }
 
+sub SET_COLOR($$$) {
+   SET_BGCOLOR (SET_FGCOLOR ($_[0], $_[1]), $_[2])
+}
+
 # urxvt::term::extension
 
 package urxvt::term::extension;
@@ -1055,14 +1083,18 @@
 Croaks (and probably outputs an error message) if the new instance
 couldn't be created.  Returns C<undef> if the new instance didn't
 initialise perl, and the terminal object otherwise. The C<init> and
-C<start> hooks will be called during this call.
+C<start> hooks will be called before this call returns, and are free to
+refer to global data (which is race free).
 
 =cut
 
 sub new {
    my ($class, $env, @args) = @_;
 
-   _new ([ map "$_=$env->{$_}", keys %$env ], @args);
+   $env  or Carp::croak "environment hash missing in call to urxvt::term->new";
+   @args or Carp::croak "name argument missing in call to urxvt::term->new";
+
+   _new ([ map "$_=$env->{$_}", keys %$env ], \@args);
 }
 
 =item $term->destroy
@@ -1372,6 +1404,16 @@
 
    $term->vt_emask_add (urxvt::PointerMotionMask);
 
+=item $term->focus_in
+
+=item $term->focus_out
+
+=item $term->key_press ($state, $keycode[, $time])
+
+=item $term->key_release ($state, $keycode[, $time])
+
+Deliver various fake events to to terminal.
+
 =item $window_width = $term->width
 
 =item $window_height = $term->height
@@ -1626,9 +1668,12 @@
 Converts rxvt-unicodes text reprsentation into a perl string. See
 C<< $term->ROW_t >> for details.
 
-=item $success = $term->grab_button ($button, $modifiermask)
+=item $success = $term->grab_button ($button, $modifiermask[, $window = $term->vt])
+
+=item $term->ungrab_button ($button, $modifiermask[, $window = $term->vt])
 
-Registers a synchronous button grab. See the XGrabButton manpage.
+Register/unregister a synchronous button grab. See the XGrabButton
+manpage.
 
 =item $success = $term->grab ($eventtime[, $sync])