The final draft seems correct to me and addresses the issues. -FR.
On Sat, Dec 24, 2011 at 12:23 AM, Nicholas Marriott <nicholas.marri...@gmail.com> wrote: > 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 ------------------------------------------------------------------------------ Ridiculously easy VDI. With Citrix VDI-in-a-Box, you don't need a complex infrastructure or vast IT resources to deliver seamless, secure access to virtual desktops. With this all-in-one solution, easily deploy virtual desktops for less than the cost of PCs and save 60% on VDI infrastructure costs. Try it free! http://p.sf.net/sfu/Citrix-VDIinabox _______________________________________________ tmux-users mailing list tmux-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/tmux-users