git.sur5r.net Git - i3/i3/blob - parser-specs/commands.spec

   1 # vim:ts=2:sw=2:expandtab
   2 #
   3 # i3 - an improved dynamic tiling window manager
   4 # © 2009-2012 Michael Stapelberg and contributors (see also: LICENSE)
   5 #
   6 # parser-specs/commands.spec: Specification file for generate-command-parser.pl
   7 # which will generate the appropriate header files for our C parser.
   8 #
   9 # Use :source highlighting.vim in vim to get syntax highlighting
  10 # for this file.
  11
  12 state INITIAL:
  13   # We have an end token here for all the commands which just call some
  14   # function without using an explicit 'end' token.
  15   end ->
  16   '[' -> call cmd_criteria_init(); CRITERIA
  17   'move' -> MOVE
  18   'exec' -> EXEC
  19   'exit' -> call cmd_exit()
  20   'restart' -> call cmd_restart()
  21   'reload' -> call cmd_reload()
  22   'shmlog' -> SHMLOG
  23   'border' -> BORDER
  24   'layout' -> LAYOUT
  25   'append_layout' -> APPEND_LAYOUT
  26   'workspace' -> WORKSPACE
  27   'focus' -> FOCUS
  28   'kill' -> KILL
  29   'open' -> call cmd_open()
  30   'fullscreen' -> FULLSCREEN
  31   'split' -> SPLIT
  32   'floating' -> FLOATING
  33   'mark' -> MARK
  34   'resize' -> RESIZE
  35   'rename' -> RENAME
  36   'nop' -> NOP
  37   'scratchpad' -> SCRATCHPAD
  38   'mode' -> MODE
  39   'bar' -> BAR
  40
  41 state CRITERIA:
  42   ctype = 'class' -> CRITERION
  43   ctype = 'instance' -> CRITERION
  44   ctype = 'window_role' -> CRITERION
  45   ctype = 'con_id' -> CRITERION
  46   ctype = 'id' -> CRITERION
  47   ctype = 'con_mark' -> CRITERION
  48   ctype = 'title' -> CRITERION
  49   ctype = 'urgent' -> CRITERION
  50   ']' -> call cmd_criteria_match_windows(); INITIAL
  51
  52 state CRITERION:
  53   '=' -> CRITERION_STR
  54
  55 state CRITERION_STR:
  56   cvalue = word
  57       -> call cmd_criteria_add($ctype, $cvalue); CRITERIA
  58
  59 # exec [--no-startup-id] <command>
  60 state EXEC:
  61   nosn = '--no-startup-id'
  62       ->
  63   command = string
  64       -> call cmd_exec($nosn, $command)
  65
  66 # shmlog <size>|toggle|on|off
  67 state SHMLOG:
  68   # argument may be a number
  69   argument = string
  70     -> call cmd_shmlog($argument)
  71
  72 # border normal|none|1pixel|toggle|1pixel
  73 state BORDER:
  74   border_style = 'normal', 'pixel'
  75     -> BORDER_WIDTH
  76   border_style = 'none', 'toggle'
  77     -> call cmd_border($border_style, "0")
  78   border_style = '1pixel'
  79     -> call cmd_border($border_style, "1")
  80
  81 state BORDER_WIDTH:
  82   end
  83     -> call cmd_border($border_style, "2")
  84   border_width = word
  85     -> call cmd_border($border_style, $border_width)
  86
  87 # layout default|stacked|stacking|tabbed|splitv|splith
  88 # layout toggle [split|all]
  89 state LAYOUT:
  90   layout_mode = 'default', 'stacked', 'stacking', 'tabbed', 'splitv', 'splith'
  91       -> call cmd_layout($layout_mode)
  92   'toggle'
  93       -> LAYOUT_TOGGLE
  94
  95 # layout toggle [split|all]
  96 state LAYOUT_TOGGLE:
  97   end
  98       -> call cmd_layout_toggle($toggle_mode)
  99   toggle_mode = 'split', 'all'
 100       -> call cmd_layout_toggle($toggle_mode)
 101
 102 # append_layout <path>
 103 state APPEND_LAYOUT:
 104   path = string -> call cmd_append_layout($path)
 105
 106 # workspace next|prev|next_on_output|prev_on_output
 107 # workspace back_and_forth
 108 # workspace <name>
 109 # workspace number <number>
 110 state WORKSPACE:
 111   direction = 'next_on_output', 'prev_on_output', 'next', 'prev'
 112       -> call cmd_workspace($direction)
 113   'back_and_forth'
 114       -> call cmd_workspace_back_and_forth()
 115   'number'
 116       -> WORKSPACE_NUMBER
 117   workspace = string
 118       -> call cmd_workspace_name($workspace)
 119
 120 state WORKSPACE_NUMBER:
 121   workspace = string
 122       -> call cmd_workspace_number($workspace)
 123
 124 # focus left|right|up|down
 125 # focus output <output>
 126 # focus tiling|floating|mode_toggle
 127 # focus parent|child
 128 # focus
 129 state FOCUS:
 130   direction = 'left', 'right', 'up', 'down'
 131       -> call cmd_focus_direction($direction)
 132   'output'
 133       -> FOCUS_OUTPUT
 134   window_mode = 'tiling', 'floating', 'mode_toggle'
 135       -> call cmd_focus_window_mode($window_mode)
 136   level = 'parent', 'child'
 137       -> call cmd_focus_level($level)
 138   end
 139       -> call cmd_focus()
 140
 141 state FOCUS_OUTPUT:
 142   output = string
 143       -> call cmd_focus_output($output)
 144
 145 # kill [window|client]
 146 state KILL:
 147   kill_mode = 'window', 'client'
 148       -> call cmd_kill($kill_mode)
 149   end
 150       -> call cmd_kill($kill_mode)
 151
 152 # fullscreen [global]
 153 state FULLSCREEN:
 154   fullscreen_mode = 'global'
 155       -> call cmd_fullscreen($fullscreen_mode)
 156   end
 157       -> call cmd_fullscreen($fullscreen_mode)
 158
 159 # split v|h|vertical|horizontal
 160 state SPLIT:
 161   direction = 'horizontal', 'vertical', 'v', 'h'
 162       -> call cmd_split($direction)
 163
 164 # floating enable|disable|toggle
 165 state FLOATING:
 166   floating = 'enable', 'disable', 'toggle'
 167       -> call cmd_floating($floating)
 168
 169 # mark <mark>
 170 state MARK:
 171   mark = string
 172       -> call cmd_mark($mark)
 173
 174 # resize
 175 state RESIZE:
 176   way = 'grow', 'shrink'
 177       -> RESIZE_DIRECTION
 178
 179 state RESIZE_DIRECTION:
 180   direction = 'up', 'down', 'left', 'right', 'width', 'height'
 181       -> RESIZE_PX
 182
 183 state RESIZE_PX:
 184   resize_px = word
 185       -> RESIZE_TILING
 186   end
 187       -> call cmd_resize($way, $direction, "10", "10")
 188
 189 state RESIZE_TILING:
 190   'px'
 191       ->
 192   'or'
 193       -> RESIZE_TILING_OR
 194   end
 195       -> call cmd_resize($way, $direction, $resize_px, "10")
 196
 197 state RESIZE_TILING_OR:
 198   'ppt'
 199       ->
 200   resize_ppt = word
 201       ->
 202   end
 203       -> call cmd_resize($way, $direction, $resize_px, $resize_ppt)
 204
 205 # rename workspace <name> to <name>
 206 # rename workspace to <name>
 207 state RENAME:
 208   'workspace'
 209       -> RENAME_WORKSPACE
 210
 211 state RENAME_WORKSPACE:
 212   old_name = 'to'
 213       -> RENAME_WORKSPACE_LIKELY_TO
 214   old_name = word
 215       -> RENAME_WORKSPACE_TO
 216
 217 state RENAME_WORKSPACE_LIKELY_TO:
 218   'to'
 219       -> RENAME_WORKSPACE_NEW_NAME
 220   new_name = word
 221       -> call cmd_rename_workspace(NULL, $new_name)
 222
 223 state RENAME_WORKSPACE_TO:
 224   'to'
 225       -> RENAME_WORKSPACE_NEW_NAME
 226
 227 state RENAME_WORKSPACE_NEW_NAME:
 228   end
 229       -> call cmd_rename_workspace(NULL, "to")
 230   new_name = string
 231       -> call cmd_rename_workspace($old_name, $new_name)
 232
 233 # move <direction> [<pixels> [px]]
 234 # move [window|container] [to] workspace [<str>|next|prev|next_on_output|prev_on_output|current]
 235 # move [window|container] [to] output <str>
 236 # move [window|container] [to] scratchpad
 237 # move workspace to [output] <str>
 238 # move scratchpad
 239 # move [window|container] [to] [absolute] position [ [<pixels> [px] <pixels> [px]] | center ]
 240 state MOVE:
 241   'window'
 242       ->
 243   'container'
 244       ->
 245   'to'
 246       ->
 247   'workspace'
 248       -> MOVE_WORKSPACE
 249   'output'
 250       -> MOVE_TO_OUTPUT
 251   'scratchpad'
 252       -> call cmd_move_scratchpad()
 253   direction = 'left', 'right', 'up', 'down'
 254       -> MOVE_DIRECTION
 255   method = 'position'
 256       -> MOVE_TO_POSITION
 257   method = 'absolute'
 258       -> MOVE_TO_ABSOLUTE_POSITION
 259
 260 state MOVE_DIRECTION:
 261   pixels = word
 262       -> MOVE_DIRECTION_PX
 263   end
 264       -> call cmd_move_direction($direction, "10")
 265
 266 state MOVE_DIRECTION_PX:
 267   'px'
 268       -> call cmd_move_direction($direction, $pixels)
 269   end
 270       -> call cmd_move_direction($direction, $pixels)
 271
 272 state MOVE_WORKSPACE:
 273   'to '
 274       -> MOVE_WORKSPACE_TO_OUTPUT
 275   workspace = 'next_on_output', 'prev_on_output', 'next', 'prev', 'current'
 276       -> call cmd_move_con_to_workspace($workspace)
 277   'back_and_forth'
 278       -> call cmd_move_con_to_workspace_back_and_forth()
 279   'number'
 280       -> MOVE_WORKSPACE_NUMBER
 281   workspace = string
 282       -> call cmd_move_con_to_workspace_name($workspace)
 283
 284 state MOVE_WORKSPACE_NUMBER:
 285   number = string
 286       -> call cmd_move_con_to_workspace_number($number)
 287
 288 state MOVE_TO_OUTPUT:
 289   output = string
 290       -> call cmd_move_con_to_output($output)
 291
 292 state MOVE_WORKSPACE_TO_OUTPUT:
 293   'output'
 294       ->
 295   output = string
 296       -> call cmd_move_workspace_to_output($output)
 297
 298 state MOVE_TO_ABSOLUTE_POSITION:
 299   'position'
 300       -> MOVE_TO_POSITION
 301
 302 state MOVE_TO_POSITION:
 303   'center'
 304       -> call cmd_move_window_to_center($method)
 305   coord_x = word
 306       -> MOVE_TO_POSITION_X
 307
 308 state MOVE_TO_POSITION_X:
 309   'px'
 310       ->
 311   coord_y = word
 312       -> MOVE_TO_POSITION_Y
 313
 314 state MOVE_TO_POSITION_Y:
 315   'px', end
 316       -> call cmd_move_window_to_position($method, $coord_x, $coord_y)
 317
 318 # mode <string>
 319 state MODE:
 320   mode = string
 321       -> call cmd_mode($mode)
 322
 323 state NOP:
 324   comment = string
 325       -> call cmd_nop($comment)
 326
 327 state SCRATCHPAD:
 328   'show'
 329       -> call cmd_scratchpad_show()
 330
 331 # bar (hidden_state hide|show|toggle)|(mode dock|hide|invisible|toggle) [<bar_id>]
 332 state BAR:
 333   bar_type = 'hidden_state'
 334       -> BAR_HIDDEN_STATE
 335   bar_type = 'mode'
 336       -> BAR_MODE
 337
 338 state BAR_HIDDEN_STATE:
 339   bar_value = 'hide', 'show', 'toggle'
 340       -> BAR_W_ID
 341
 342 state BAR_MODE:
 343   bar_value = 'dock', 'hide', 'invisible', 'toggle'
 344       -> BAR_W_ID
 345
 346 state BAR_W_ID:
 347   bar_id = word
 348       ->
 349   end
 350       -> call cmd_bar($bar_type, $bar_value, $bar_id)