a532f5ac39
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
68 lines
2.7 KiB
C
68 lines
2.7 KiB
C
/*
|
|
* vim:ts=4:sw=4:expandtab
|
|
*
|
|
* i3 - an improved dynamic tiling window manager
|
|
* © 2009-2012 Michael Stapelberg and contributors (see also: LICENSE)
|
|
*
|
|
* commands.c: all command functions (see commands_parser.c)
|
|
*
|
|
*/
|
|
#ifndef _COMMANDS_H
|
|
#define _COMMANDS_H
|
|
|
|
/*
|
|
* Helper data structure for an operation window (window on which the operation
|
|
* will be performed). Used to build the TAILQ owindows.
|
|
*
|
|
*/
|
|
typedef struct owindow {
|
|
Con *con;
|
|
TAILQ_ENTRY(owindow) owindows;
|
|
} owindow;
|
|
|
|
typedef TAILQ_HEAD(owindows_head, owindow) owindows_head;
|
|
|
|
void cmd_MIGRATION_enable();
|
|
void cmd_MIGRATION_disable();
|
|
void cmd_MIGRATION_save_new_parameters(Match *current_match, ...);
|
|
void cmd_MIGRATION_save_old_parameters(Match *current_match, ...);
|
|
void cmd_MIGRATION_validate();
|
|
|
|
char *cmd_criteria_init(Match *current_match);
|
|
char *cmd_criteria_match_windows(Match *current_match);
|
|
char *cmd_criteria_add(Match *current_match, char *ctype, char *cvalue);
|
|
|
|
char *cmd_move_con_to_workspace(Match *current_match, char *which);
|
|
char *cmd_move_con_to_workspace_name(Match *current_match, char *name);
|
|
char *cmd_resize(Match *current_match, char *way, char *direction, char *resize_px, char *resize_ppt);
|
|
char *cmd_border(Match *current_match, char *border_style_str);
|
|
char *cmd_nop(Match *current_match, char *comment);
|
|
char *cmd_append_layout(Match *current_match, char *path);
|
|
char *cmd_workspace(Match *current_match, char *which);
|
|
char *cmd_workspace_back_and_forth(Match *current_match);
|
|
char *cmd_workspace_name(Match *current_match, char *name);
|
|
char *cmd_mark(Match *current_match, char *mark);
|
|
char *cmd_mode(Match *current_match, char *mode);
|
|
char *cmd_move_con_to_output(Match *current_match, char *name);
|
|
char *cmd_floating(Match *current_match, char *floating_mode);
|
|
char *cmd_move_workspace_to_output(Match *current_match, char *name);
|
|
char *cmd_split(Match *current_match, char *direction);
|
|
char *cmd_kill(Match *current_match, char *kill_mode);
|
|
char *cmd_exec(Match *current_match, char *nosn, char *command);
|
|
char *cmd_focus_direction(Match *current_match, char *direction);
|
|
char *cmd_focus_window_mode(Match *current_match, char *window_mode);
|
|
char *cmd_focus_level(Match *current_match, char *level);
|
|
char *cmd_focus(Match *current_match);
|
|
char *cmd_fullscreen(Match *current_match, char *fullscreen_mode);
|
|
char *cmd_move_direction(Match *current_match, char *direction, char *px);
|
|
char *cmd_layout(Match *current_match, char *layout);
|
|
char *cmd_exit(Match *current_match);
|
|
char *cmd_reload(Match *current_match);
|
|
char *cmd_restart(Match *current_match);
|
|
char *cmd_open(Match *current_match);
|
|
char *cmd_focus_output(Match *current_match, char *name);
|
|
char *cmd_move_scratchpad(Match *current_match);
|
|
char *cmd_scratchpad_show(Match *current_match);
|
|
|
|
#endif
|