=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/tmux/tmux.1,v retrieving revision 1.761 retrieving revision 1.762 diff -u -r1.761 -r1.762 --- src/usr.bin/tmux/tmux.1 2020/05/16 15:41:54 1.761 +++ src/usr.bin/tmux/tmux.1 2020/05/16 15:45:29 1.762 @@ -1,4 +1,4 @@ -.\" $OpenBSD: tmux.1,v 1.761 2020/05/16 15:41:54 nicm Exp $ +.\" $OpenBSD: tmux.1,v 1.762 2020/05/16 15:45:29 nicm Exp $ .\" .\" Copyright (c) 2007 Nicholas Marriott .\" @@ -947,6 +947,7 @@ .It Xo Ic attach-session .Op Fl dErx .Op Fl c Ar working-directory +.Op Fl f Ar flags .Op Fl t Ar target-session .Xc .D1 (alias: Ic attach ) @@ -964,12 +965,30 @@ .Dv SIGHUP to the parent process of the client as well as detaching the client, typically causing it to exit. +.Fl f +sets a comma-separated list of client flags. +The flags are: +.Bl -tag -width Ds +.It read-only +the client is read-only +.It ignore-size +the client does not affect the size of other clients +.It no-output +the client does not receive pane output in control mode +.El +.Pp +A leading +.Ql ! +turns a flag off if the client is already attached. .Fl r -signifies the client is read-only (only keys bound to the +is an alias for +.Fl f +.Ar read-only,ignore-size . +When a client is read-only, only keys bound to the .Ic detach-client or .Ic switch-client -commands have any effect) +commands have any effect. .Pp If no server is started, .Ic attach-session @@ -1095,6 +1114,7 @@ .Op Fl AdDEPX .Op Fl c Ar start-directory .Op Fl e Ar environment +.Op Fl f Ar flags .Op Fl F Ar format .Op Fl n Ar window-name .Op Fl s Ar session-name @@ -1132,6 +1152,9 @@ is given, the .Ic default-size option is set for the session. +.Fl f +sets a comma-separated list of client flags (see +.Ic attach-session ) . .Pp If run from a terminal, any .Xr termios 4 @@ -1209,7 +1232,7 @@ .It Xo Ic refresh-client .Op Fl cDlLRSU .Op Fl C Ar XxY -.Op Fl F Ar flags +.Op Fl f Ar flags .Op Fl t Ar target-client .Op Ar adjustment .Xc @@ -1252,12 +1275,10 @@ it. .Pp .Fl C -sets the width and height of a control client and -.Fl F -sets a comma-separated list of flags. -Currently the only flag available is -.Ql no-output -to disable receiving pane output. +sets the width and height of a control client. +.Fl f +sets a comma-separated list of client flags, see +.Ic attach-session . .Pp .Fl l requests the clipboard from the client using the @@ -1377,7 +1398,11 @@ is used, the client is moved to the last, next or previous session respectively. .Fl r -toggles whether a client is read-only (see the +toggles the client +.Ic read-only +and +.Ic ignore-size +flags (see the .Ic attach-session command). .Pp @@ -4480,6 +4505,7 @@ .It Li "client_control_mode" Ta "" Ta "1 if client is in control mode" .It Li "client_created" Ta "" Ta "Time client created" .It Li "client_discarded" Ta "" Ta "Bytes discarded when client behind" +.It Li "client_flags" Ta "" Ta "List of client flags" .It Li "client_height" Ta "" Ta "Height of client" .It Li "client_key_table" Ta "" Ta "Current key table" .It Li "client_last_session" Ta "" Ta "Name of the client's last session"