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

Reply via email to