X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=man%2Fi3-input.man;h=dc145914749ab758962729649be6bf73a3355b14;hb=f43f4127713c61cc2e71765c950b2857ff290369;hp=df7c4d9ce82bd85845230acc959b9829d71c25fb;hpb=05c0a8985b9d07f6100150e7c6dcff4ba7775b85;p=i3%2Fi3 diff --git a/man/i3-input.man b/man/i3-input.man index df7c4d9c..dc145914 100644 --- a/man/i3-input.man +++ b/man/i3-input.man @@ -1,7 +1,7 @@ i3-input(1) -========= +=========== Michael Stapelberg -v4.1, September 2011 +v4.1.2, April 2012 == NAME @@ -17,15 +17,45 @@ 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. +You can press Escape to close i3-input without sending any commands. -== EXAMPLE +== OPTIONS +-s :: +Specify the path to the i3 IPC socket (it should not be necessary to use this +option, i3-input will figure out the path on its own). + +-F :: +Every occurrence of "%s" in the string is replaced by the user input, +and the result is sent to i3 as a command. Default value is "%s". + +-l :: +Set the maximum allowed length of the user input to characters. +i3-input will automatically issue the command when the user input reaches that +length. + +-P :: +Display the string in front of user input text field. +The prompt string is not included in the user input/command. + +-f :: +Use the specified X11 core font (use +xfontsel+ to chose a font). + +-v:: +Show version and exit. + +== EXAMPLES + +Mark a container with a single character: ------------------------------------------------ i3-input -F 'mark %s' -l 1 -P 'Mark: ' ------------------------------------------------ +Go to the container marked with above example: +----------------------------------------------------- +i3-input -F '[con_mark="%s"] focus' -l 1 -P 'Go to: ' +----------------------------------------------------- + == ENVIRONMENT === I3SOCK