On Mon, Dec 19, 2011 at 04:00:28PM -0800, Felix Rosencrantz wrote: > Looks pretty good, I have four small issues: > > 1) automatic-rename is also turned off by setting window name via > escape sequence, which is not spelled out, anywhere in the man page, > and this is what actually was biting me originally. (or I missed it in > the patched version or forgot to add that in the patch I sent.) > > 2) "A window's title is the title of it's active pane." This might be > a little unclear, since just before there it says only panes have > titles.
Yes, maybe this is clearer below. Also fixed to mention tsl, fsl in set-titles bit. > > 3) "in target" seems awkward to me in this "Windows and sessions have > names, which may be used to specify them in target and...", but that > may be correct way to say it. It should be "in targets". Index: tmux.1 =================================================================== RCS file: /cvs/src/usr.bin/tmux/tmux.1,v retrieving revision 1.257 diff -u -p -r1.257 tmux.1 --- tmux.1 9 Dec 2011 16:28:18 -0000 1.257 +++ tmux.1 24 Dec 2011 08:22:49 -0000 @@ -2044,7 +2044,14 @@ command to destroy it. .It Xo Ic set-titles .Op Ic on | off .Xc -Attempt to set the window title using the \ee]2;...\e007 xterm code if +Attempt to set the client terminal title using the +.Em tsl +and +.Em fsl +.Xr terminfo 5 +entries if they exist. +.Nm +automatically sets these to the \ee]2;...\e007 sequence if the terminal appears to be an xterm. This option is off by default. Note that elinks @@ -2110,7 +2117,7 @@ may contain any of the following special .It Li "#I" Ta "Current window index" .It Li "#P" Ta "Current pane index" .It Li "#S" Ta "Session name" -.It Li "#T" Ta "Current window title" +.It Li "#T" Ta "Current pane title" .It Li "#W" Ta "Current window name" .It Li "##" Ta "A literal" Ql # .El @@ -2129,13 +2136,9 @@ global environment set (see the .Sx ENVIRONMENT section). .Pp -The window title (#T) is the title set by the program running within the window -using the OSC title setting sequence, for example: -.Bd -literal -offset indent -$ printf '\e033]2;My Title\e033\e\e' -.Ed -.Pp -When a window is first created, its title is the hostname. +For details on how the names and titles can be set see the +.Sx "NAMES AND TITLES" +section. .Pp #[attributes] allows a comma-separated list of attributes to be specified, these may be @@ -2359,7 +2362,8 @@ is specified at creation with or .Ic new-session , or later with -.Ic rename-window . +.Ic rename-window , +or with a terminal escape sequence. It may be switched off globally with: .Bd -literal -offset indent set-window-option -g automatic-rename off @@ -2654,6 +2658,62 @@ The following variables are available, w .It Li "window_name" Ta "Name of window" .It Li "window_width" Ta "Width of window" .El +.Sh NAMES AND TITLES +.Nm +distinguishes between names and titles. +Windows and sessions have names, which may be used to specify them in targets +and are displayed in the status line and various lists: the name is the +.Nm +identifier for a window or session. +Only panes have titles. +A pane's title is typically set by the program running inside the pane and +is not modified by +.Nm . +It is the same mechanism used to set for example the +.Xr xterm 1 +window title in an +.Xr X 7 +window manager. +Windows themselves do not have titles - a window's title is the title of it's +active pane. +.Nm +itself may set the title of the terminal in which the client is running, see +the +.Ic set-titles +option. +.Pp +A session's name is set with the +.Ic new-session +and +.Ic rename-session +commands. +A window's name is set with one of: +.Bl -enum -width Ds +.It +A command argument (such as +.Fl n +for +.Ic new-window +or +.Ic new-session ) . +.It +An escape sequence: +.Bd -literal -offset indent +$ printf '\e033kWINDOW_NAME\e033\e\e' +.Ed +.It +Automatic renaming, which sets the name to the active command in the window's +active pane. +See the +.Ic automatic-rename +option. +.El +.Pp +When a pane is first created, its title is the hostname. +A pane's title can be set via the OSC title setting sequence, for example: +.Bd -literal -offset indent +$ printf '\e033]2;My Title\e033\e\e' +.Ed .Sh ENVIRONMENT When the server is started, .Nm @@ -2717,8 +2777,8 @@ terminal. By default, the status line is enabled (it may be disabled with the .Ic status session option) and contains, from left-to-right: the name of the current -session in square brackets; the window list; the current window title in double -quotes; and the time and date. +session in square brackets; the window list; the title of the active pane +in double quotes; and the time and date. .Pp The status line is made of three parts: configurable left and right sections (which may contain dynamic content such as the time or output from a shell ------------------------------------------------------------------------------ Write once. Port to many. Get the SDK and tools to simplify cross-platform app development. Create new or port existing apps to sell to consumers worldwide. Explore the Intel AppUpSM program developer opportunity. appdeveloper.intel.com/join http://p.sf.net/sfu/intel-appdev _______________________________________________ tmux-users mailing list tmux-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/tmux-users
