# vim:ts=2:sw=2:expandtab
#
# i3 - an improved dynamic tiling window manager
-# © 2009-2012 Michael Stapelberg and contributors (see also: LICENSE)
+# © 2009 Michael Stapelberg and contributors (see also: LICENSE)
#
# parser-specs/commands.spec: Specification file for generate-command-parser.pl
# which will generate the appropriate header files for our C parser.
'kill' -> KILL
'open' -> call cmd_open()
'fullscreen' -> FULLSCREEN
+ 'sticky' -> STICKY
'split' -> SPLIT
'floating' -> FLOATING
'mark' -> MARK
'rename' -> RENAME
'nop' -> NOP
'scratchpad' -> SCRATCHPAD
+ 'swap' -> SWAP
+ 'title_format' -> TITLE_FORMAT
'mode' -> MODE
'bar' -> BAR
state CRITERIA:
- ctype = 'class' -> CRITERION
- ctype = 'instance' -> CRITERION
+ ctype = 'class' -> CRITERION
+ ctype = 'instance' -> CRITERION
ctype = 'window_role' -> CRITERION
- ctype = 'con_id' -> CRITERION
- ctype = 'id' -> CRITERION
- ctype = 'con_mark' -> CRITERION
- ctype = 'title' -> CRITERION
- ctype = 'urgent' -> CRITERION
+ ctype = 'con_id' -> CRITERION
+ ctype = 'id' -> CRITERION
+ ctype = 'window_type' -> CRITERION
+ ctype = 'con_mark' -> CRITERION
+ ctype = 'title' -> CRITERION
+ ctype = 'urgent' -> CRITERION
+ ctype = 'workspace' -> CRITERION
+ ctype = 'tiling', 'floating'
+ -> call cmd_criteria_add($ctype, NULL); CRITERIA
']' -> call cmd_criteria_match_windows(); INITIAL
state CRITERION:
argument = 'toggle', 'on', 'off'
-> call cmd_debuglog($argument)
-# border normal|none|1pixel|toggle|1pixel
+# border normal|pixel [<n>]
+# border none|1pixel|toggle
state BORDER:
- border_style = 'normal', 'pixel'
+ border_style = 'normal', 'pixel', 'toggle'
-> BORDER_WIDTH
- border_style = 'none', 'toggle'
- -> call cmd_border($border_style, "0")
- border_style = '1pixel'
- -> call cmd_border($border_style, "1")
+ border_style = 'none'
+ -> call cmd_border($border_style, 0)
+ '1pixel'
+ -> call cmd_border("pixel", 1)
state BORDER_WIDTH:
end
- -> call cmd_border($border_style, "2")
- border_width = word
- -> call cmd_border($border_style, $border_width)
+ -> call cmd_border($border_style, -1)
+ border_width = number
+ -> call cmd_border($border_style, &border_width)
# layout default|stacked|stacking|tabbed|splitv|splith
# layout toggle [split|all]
state LAYOUT_TOGGLE:
end
-> call cmd_layout_toggle($toggle_mode)
- toggle_mode = 'split', 'all'
+ toggle_mode = string
-> call cmd_layout_toggle($toggle_mode)
# append_layout <path>
# workspace next|prev|next_on_output|prev_on_output
# workspace back_and_forth
-# workspace <name>
-# workspace number <number>
+# workspace [--no-auto-back-and-forth] <name>
+# workspace [--no-auto-back-and-forth] number <number>
state WORKSPACE:
+ no_auto_back_and_forth = '--no-auto-back-and-forth'
+ ->
direction = 'next_on_output', 'prev_on_output', 'next', 'prev'
-> call cmd_workspace($direction)
'back_and_forth'
'number'
-> WORKSPACE_NUMBER
workspace = string
- -> call cmd_workspace_name($workspace)
+ -> call cmd_workspace_name($workspace, $no_auto_back_and_forth)
state WORKSPACE_NUMBER:
workspace = string
- -> call cmd_workspace_number($workspace)
+ -> call cmd_workspace_number($workspace, $no_auto_back_and_forth)
# focus left|right|up|down
# focus output <output>
end
-> call cmd_fullscreen("toggle", "output")
-# split v|h|vertical|horizontal
+# sticky enable|disable|toggle
+state STICKY:
+ action = 'enable', 'disable', 'toggle'
+ -> call cmd_sticky($action)
+
+# split v|h|t|vertical|horizontal|toggle
state SPLIT:
- direction = 'horizontal', 'vertical', 'v', 'h'
+ direction = 'horizontal', 'vertical', 'toggle', 'v', 'h', 't'
-> call cmd_split($direction)
# floating enable|disable|toggle
floating = 'enable', 'disable', 'toggle'
-> call cmd_floating($floating)
-# mark <mark>
+# mark [--add|--replace] [--toggle] <mark>
state MARK:
+ mode = '--add', '--replace'
+ ->
+ toggle = '--toggle'
+ ->
mark = string
- -> call cmd_mark($mark)
+ -> call cmd_mark($mark, $mode, $toggle)
# unmark [mark]
state UNMARK:
state RESIZE:
way = 'grow', 'shrink'
-> RESIZE_DIRECTION
+ set = 'set'
+ -> RESIZE_SET
state RESIZE_DIRECTION:
direction = 'up', 'down', 'left', 'right', 'width', 'height'
-> RESIZE_PX
state RESIZE_PX:
- resize_px = word
+ resize_px = number
-> RESIZE_TILING
end
- -> call cmd_resize($way, $direction, "10", "10")
+ -> call cmd_resize($way, $direction, 10, 10)
state RESIZE_TILING:
'px'
'or'
-> RESIZE_TILING_OR
end
- -> call cmd_resize($way, $direction, $resize_px, "10")
+ -> call cmd_resize($way, $direction, &resize_px, 0)
state RESIZE_TILING_OR:
- resize_ppt = word
+ resize_ppt = number
-> RESIZE_TILING_FINAL
state RESIZE_TILING_FINAL:
'ppt', end
- -> call cmd_resize($way, $direction, $resize_px, $resize_ppt)
+ -> call cmd_resize($way, $direction, &resize_px, &resize_ppt)
+
+state RESIZE_SET:
+ 'height'
+ -> RESIZE_HEIGHT_GET_NUMBER
+ 'width'
+ ->
+ width = number
+ -> RESIZE_WIDTH
+
+state RESIZE_WIDTH:
+ mode_width = 'px', 'ppt'
+ ->
+ end
+ -> call cmd_resize_set(&width, $mode_width, 0, 0)
+ 'height'
+ -> RESIZE_HEIGHT_GET_NUMBER
+ height = number
+ -> RESIZE_HEIGHT
+
+state RESIZE_HEIGHT_GET_NUMBER:
+ height = number
+ -> RESIZE_HEIGHT
+
+state RESIZE_HEIGHT:
+ mode_height = 'px', 'ppt'
+ ->
+ end
+ -> call cmd_resize_set(&width, $mode_width, &height, $mode_height)
# rename workspace <name> to <name>
# rename workspace to <name>
-> RENAME_WORKSPACE
state RENAME_WORKSPACE:
- old_name = 'to'
+ 'to'
-> RENAME_WORKSPACE_LIKELY_TO
old_name = word
-> RENAME_WORKSPACE_TO
state RENAME_WORKSPACE_LIKELY_TO:
- 'to'
- -> RENAME_WORKSPACE_NEW_NAME
+ 'to '
+ -> RENAME_WORKSPACE_LIKELY_TO_NEW_NAME
new_name = word
-> call cmd_rename_workspace(NULL, $new_name)
+state RENAME_WORKSPACE_LIKELY_TO_NEW_NAME:
+ new_name = string
+ -> call cmd_rename_workspace("to", $new_name)
+ end
+ -> call cmd_rename_workspace(NULL, "to")
+
state RENAME_WORKSPACE_TO:
'to'
- -> RENAME_WORKSPACE_NEW_NAME
+ -> RENAME_WORKSPACE_TO_NEW_NAME
-state RENAME_WORKSPACE_NEW_NAME:
- end
- -> call cmd_rename_workspace(NULL, "to")
+state RENAME_WORKSPACE_TO_NEW_NAME:
new_name = string
-> call cmd_rename_workspace($old_name, $new_name)
# move <direction> [<pixels> [px]]
# move [window|container] [to] workspace [<str>|next|prev|next_on_output|prev_on_output|current]
# move [window|container] [to] output <str>
+# move [window|container] [to] mark <str>
# move [window|container] [to] scratchpad
# move workspace to [output] <str>
# move scratchpad
# move [window|container] [to] [absolute] position [ [<pixels> [px] <pixels> [px]] | center ]
+# move [window|container] [to] position mouse|cursor|pointer
state MOVE:
'window'
->
->
'to'
->
+ no_auto_back_and_forth = '--no-auto-back-and-forth'
+ ->
'workspace'
-> MOVE_WORKSPACE
'output'
-> MOVE_TO_OUTPUT
+ 'mark'
+ -> MOVE_TO_MARK
'scratchpad'
-> call cmd_move_scratchpad()
direction = 'left', 'right', 'up', 'down'
-> MOVE_TO_ABSOLUTE_POSITION
state MOVE_DIRECTION:
- pixels = word
+ pixels = number
-> MOVE_DIRECTION_PX
end
- -> call cmd_move_direction($direction, "10")
+ -> call cmd_move_direction($direction, 10)
state MOVE_DIRECTION_PX:
'px'
- -> call cmd_move_direction($direction, $pixels)
+ -> call cmd_move_direction($direction, &pixels)
end
- -> call cmd_move_direction($direction, $pixels)
+ -> call cmd_move_direction($direction, &pixels)
state MOVE_WORKSPACE:
'to '
'number'
-> MOVE_WORKSPACE_NUMBER
workspace = string
- -> call cmd_move_con_to_workspace_name($workspace)
+ -> call cmd_move_con_to_workspace_name($workspace, $no_auto_back_and_forth)
state MOVE_WORKSPACE_NUMBER:
number = string
- -> call cmd_move_con_to_workspace_number($number)
+ -> call cmd_move_con_to_workspace_number($number, $no_auto_back_and_forth)
state MOVE_TO_OUTPUT:
output = string
-> call cmd_move_con_to_output($output)
+state MOVE_TO_MARK:
+ mark = string
+ -> call cmd_move_con_to_mark($mark)
+
state MOVE_WORKSPACE_TO_OUTPUT:
'output'
->
state MOVE_TO_POSITION:
'center'
-> call cmd_move_window_to_center($method)
- coord_x = word
+ 'mouse', 'cursor', 'pointer'
+ -> call cmd_move_window_to_mouse()
+ coord_x = number
-> MOVE_TO_POSITION_X
state MOVE_TO_POSITION_X:
'px'
->
- coord_y = word
+ coord_y = number
-> MOVE_TO_POSITION_Y
state MOVE_TO_POSITION_Y:
'px', end
- -> call cmd_move_window_to_position($method, $coord_x, $coord_y)
+ -> call cmd_move_window_to_position(&coord_x, &coord_y)
# mode <string>
state MODE:
state NOP:
comment = string
-> call cmd_nop($comment)
+ end
+ -> call cmd_nop(NULL)
state SCRATCHPAD:
'show'
-> call cmd_scratchpad_show()
+# swap [container] [with] id <window>
+# swap [container] [with] con_id <con_id>
+# swap [container] [with] mark <mark>
+state SWAP:
+ 'container'
+ ->
+ 'with'
+ ->
+ mode = 'id', 'con_id', 'mark'
+ -> SWAP_ARGUMENT
+
+state SWAP_ARGUMENT:
+ arg = string
+ -> call cmd_swap($mode, $arg)
+
+state TITLE_FORMAT:
+ format = string
+ -> call cmd_title_format($format)
+
# bar (hidden_state hide|show|toggle)|(mode dock|hide|invisible|toggle) [<bar_id>]
state BAR:
bar_type = 'hidden_state'