From 12e096cf73222708406c74ccadc33b90f9f41f1c Mon Sep 17 00:00:00 2001 From: Michael Stapelberg Date: Sun, 18 Sep 2011 13:57:39 +0100 Subject: [PATCH] i3-input: update manpage --- man/i3-input.man | 21 +++++++++++++++------ 1 file changed, 15 insertions(+), 6 deletions(-) diff --git a/man/i3-input.man b/man/i3-input.man index cd85c92c..df7c4d9c 100644 --- a/man/i3-input.man +++ b/man/i3-input.man @@ -1,7 +1,7 @@ i3-input(1) ========= Michael Stapelberg -v3.delta, November 2009 +v4.1, September 2011 == NAME @@ -9,7 +9,7 @@ i3-input - interactively take a command for i3 window manager == SYNOPSIS -i3-input [-s ] [-p ] [-l ] [-P ] [-f ] [-v] +i3-input [-s ] [-F ] [-l ] [-P ] [-f ] [-v] == DESCRIPTION @@ -17,19 +17,28 @@ i3-input is a tool to take commands (or parts of a command) composed by the user, and send it/them to i3. This is useful, for example, for the mark/goto command. +The -F option takes a format string. In this string, every occurence of %s is +replaced by the user input. + == EXAMPLE ------------------------------------------------ -i3-input -p 'mark ' -l 1 -P 'Mark: ' +i3-input -F 'mark %s' -l 1 -P 'Mark: ' ------------------------------------------------ == ENVIRONMENT === I3SOCK -If no ipc-socket is specified on the commandline, this variable is used -to determine the path, at wich the unix domain socket is expected, on which -to connect to i3. +i3-input handles the different sources of socket paths in the following order: + +* I3SOCK environment variable +* I3SOCK gets overwritten by the -s parameter, if specified +* if neither are available, i3-input reads the socket path from the X11 + property, which is the recommended way +* if everything fails, i3-input tries +/tmp/i3-ipc.sock+ + +The socket path is necessary to connect to i3 and actually issue the command. == SEE ALSO -- 2.39.5