1 # vim:ts=2:sw=2:expandtab
3 # i3 - an improved dynamic tiling window manager
4 # © 2009-2012 Michael Stapelberg and contributors (see also: LICENSE)
6 # parser-specs/commands.spec: Specification file for generate-command-parser.pl
7 # which will generate the appropriate header files for our C parser.
9 # Use :source highlighting.vim in vim to get syntax highlighting
13 # We have an end token here for all the commands which just call some
14 # function without using an explicit 'end' token.
16 '[' -> call cmd_criteria_init(); CRITERIA
19 'exit' -> call cmd_exit()
20 'restart' -> call cmd_restart()
21 'reload' -> call cmd_reload()
24 'append_layout' -> APPEND_LAYOUT
25 'workspace' -> WORKSPACE
28 'open' -> call cmd_open()
29 'fullscreen' -> FULLSCREEN
31 'floating' -> FLOATING
36 'scratchpad' -> SCRATCHPAD
40 ctype = 'class' -> CRITERION
41 ctype = 'instance' -> CRITERION
42 ctype = 'window_role' -> CRITERION
43 ctype = 'con_id' -> CRITERION
44 ctype = 'id' -> CRITERION
45 ctype = 'con_mark' -> CRITERION
46 ctype = 'title' -> CRITERION
47 ctype = 'urgent' -> CRITERION
48 ']' -> call cmd_criteria_match_windows(); INITIAL
55 -> call cmd_criteria_add($ctype, $cvalue); CRITERIA
57 # exec [--no-startup-id] <command>
59 nosn = '--no-startup-id'
62 -> call cmd_exec($nosn, $command)
64 # border normal|none|1pixel|toggle|1pixel
66 border_style = 'normal', 'pixel'
68 border_style = 'none', 'toggle'
69 -> call cmd_border($border_style, "0")
70 border_style = '1pixel'
71 -> call cmd_border($border_style, "1")
75 -> call cmd_border($border_style, "2")
77 -> call cmd_border($border_style, $border_width)
79 # layout default|stacked|stacking|tabbed|splitv|splith
80 # layout toggle [split|all]
82 layout_mode = 'default', 'stacked', 'stacking', 'tabbed', 'splitv', 'splith'
83 -> call cmd_layout($layout_mode)
87 # layout toggle [split|all]
90 -> call cmd_layout_toggle($toggle_mode)
91 toggle_mode = 'split', 'all'
92 -> call cmd_layout_toggle($toggle_mode)
94 # append_layout <path>
96 path = string -> call cmd_append_layout($path)
98 # workspace next|prev|next_on_output|prev_on_output
99 # workspace back_and_forth
101 # workspace number <number>
103 direction = 'next_on_output', 'prev_on_output', 'next', 'prev'
104 -> call cmd_workspace($direction)
106 -> call cmd_workspace_back_and_forth()
110 -> call cmd_workspace_name($workspace)
112 state WORKSPACE_NUMBER:
114 -> call cmd_workspace_number($workspace)
116 # focus left|right|up|down
117 # focus output <output>
118 # focus tiling|floating|mode_toggle
122 direction = 'left', 'right', 'up', 'down'
123 -> call cmd_focus_direction($direction)
126 window_mode = 'tiling', 'floating', 'mode_toggle'
127 -> call cmd_focus_window_mode($window_mode)
128 level = 'parent', 'child'
129 -> call cmd_focus_level($level)
135 -> call cmd_focus_output($output)
137 # kill [window|client]
139 kill_mode = 'window', 'client'
140 -> call cmd_kill($kill_mode)
142 -> call cmd_kill($kill_mode)
144 # fullscreen [global]
146 fullscreen_mode = 'global'
147 -> call cmd_fullscreen($fullscreen_mode)
149 -> call cmd_fullscreen($fullscreen_mode)
151 # split v|h|vertical|horizontal
153 direction = 'horizontal', 'vertical', 'v', 'h'
154 -> call cmd_split($direction)
156 # floating enable|disable|toggle
158 floating = 'enable', 'disable', 'toggle'
159 -> call cmd_floating($floating)
164 -> call cmd_mark($mark)
168 way = 'grow', 'shrink'
171 state RESIZE_DIRECTION:
172 direction = 'up', 'down', 'left', 'right', 'width', 'height'
179 -> call cmd_resize($way, $direction, "10", "10")
187 -> call cmd_resize($way, $direction, $resize_px, "10")
189 state RESIZE_TILING_OR:
195 -> call cmd_resize($way, $direction, $resize_px, $resize_ppt)
197 # rename workspace <name> to <name>
198 # rename workspace to <name>
203 state RENAME_WORKSPACE:
205 -> RENAME_WORKSPACE_LIKELY_TO
207 -> RENAME_WORKSPACE_TO
209 state RENAME_WORKSPACE_LIKELY_TO:
211 -> RENAME_WORKSPACE_NEW_NAME
213 -> call cmd_rename_workspace(NULL, $new_name)
215 state RENAME_WORKSPACE_TO:
217 -> RENAME_WORKSPACE_NEW_NAME
219 state RENAME_WORKSPACE_NEW_NAME:
221 -> call cmd_rename_workspace(NULL, "to")
223 -> call cmd_rename_workspace($old_name, $new_name)
225 # move <direction> [<pixels> [px]]
226 # move [window|container] [to] workspace [<str>|next|prev|current]
227 # move [window|container] [to] output <str>
228 # move [window|container] [to] scratchpad
229 # move workspace to [output] <str>
231 # move [window|container] [to] [absolute] position [ [<pixels> [px] <pixels> [px]] | center ]
244 -> call cmd_move_scratchpad()
245 direction = 'left', 'right', 'up', 'down'
250 -> MOVE_TO_ABSOLUTE_POSITION
252 state MOVE_DIRECTION:
256 -> call cmd_move_direction($direction, "10")
258 state MOVE_DIRECTION_PX:
260 -> call cmd_move_direction($direction, $pixels)
262 -> call cmd_move_direction($direction, $pixels)
264 state MOVE_WORKSPACE:
266 -> MOVE_WORKSPACE_TO_OUTPUT
267 workspace = 'next', 'prev', 'next_on_output', 'prev_on_output', 'current'
268 -> call cmd_move_con_to_workspace($workspace)
270 -> call cmd_move_con_to_workspace_back_and_forth()
272 -> MOVE_WORKSPACE_NUMBER
274 -> call cmd_move_con_to_workspace_name($workspace)
276 state MOVE_WORKSPACE_NUMBER:
278 -> call cmd_move_con_to_workspace_number($number)
280 state MOVE_TO_OUTPUT:
282 -> call cmd_move_con_to_output($output)
284 state MOVE_WORKSPACE_TO_OUTPUT:
288 -> call cmd_move_workspace_to_output($output)
290 state MOVE_TO_ABSOLUTE_POSITION:
294 state MOVE_TO_POSITION:
296 -> call cmd_move_window_to_center($method)
298 -> MOVE_TO_POSITION_X
300 state MOVE_TO_POSITION_X:
304 -> MOVE_TO_POSITION_Y
306 state MOVE_TO_POSITION_Y:
308 -> call cmd_move_window_to_position($method, $coord_x, $coord_y)
313 -> call cmd_mode($mode)
317 -> call cmd_nop($comment)
321 -> call cmd_scratchpad_show()