i3/include/assignments.h

/*
 * vim:ts=4:sw=4:expandtab
 *
 * i3 - an improved dynamic tiling window manager
 * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
 *
 * assignments.c: Assignments for specific windows (for_window).
 *
 */
#pragma once

#include <config.h>

/**
 * Checks the list of assignments for the given window and runs all matching
 * ones (unless they have already been run for this specific window).
 *
 */
void run_assignments(i3Window *window);

/**
 * Returns the first matching assignment for the given window.
 *
 */
Assignment *assignment_for(i3Window *window, int type);
Time Lord technology: for_window config directive to run arbitrary cmds An example to set all XTerms floating: for_window [class="XTerm"] mode floating To make all urxvts use a 1-pixel border: for_window [class="urxvt"] border 1pixel A less useful, but rather funny example: for_window [title="x200: ~/work"] mode floating The commands are not completely arbitrary. The commands above were tested, others may need some fixing. Internally, windows are compared against your criteria (class, title, …) when they are initially managed and whenever one of the relevant values change. Then, the specified command is run once (per window). It gets prefixed with a criteria to make it match only the specific window that triggered it. So, if you configure "mode floating", i3 runs something like '[id="8393923"] mode floating'. 2011-05-15 22:10:25 +04:00			`/*`
			`* vim:ts=4:sw=4:expandtab`
			`*`
normalize file headers across */.{h,c} 2011-10-26 00:19:38 +04:00			`* i3 - an improved dynamic tiling window manager`
Update copyright notices and get rid of ranges The script used to make these changes can be found at: https://gist.github.com/Deiz/32322020f76d23e2bf8f 2015-04-04 03:17:56 +03:00			`* © 2009 Michael Stapelberg and contributors (see also: LICENSE)`
normalize file headers across */.{h,c} 2011-10-26 00:19:38 +04:00			`*`
			`* assignments.c: Assignments for specific windows (for_window).`
			`*`
Time Lord technology: for_window config directive to run arbitrary cmds An example to set all XTerms floating: for_window [class="XTerm"] mode floating To make all urxvts use a 1-pixel border: for_window [class="urxvt"] border 1pixel A less useful, but rather funny example: for_window [title="x200: ~/work"] mode floating The commands are not completely arbitrary. The commands above were tested, others may need some fixing. Internally, windows are compared against your criteria (class, title, …) when they are initially managed and whenever one of the relevant values change. Then, the specified command is run once (per window). It gets prefixed with a criteria to make it match only the specific window that triggered it. So, if you configure "mode floating", i3 runs something like '[id="8393923"] mode floating'. 2011-05-15 22:10:25 +04:00			`*/`
Use #pragma once #pragma once is safer and simpler. According to Wikipedia it's supported by all major compilers. 2013-12-29 06:11:50 +04:00			`#pragma once`
Time Lord technology: for_window config directive to run arbitrary cmds An example to set all XTerms floating: for_window [class="XTerm"] mode floating To make all urxvts use a 1-pixel border: for_window [class="urxvt"] border 1pixel A less useful, but rather funny example: for_window [title="x200: ~/work"] mode floating The commands are not completely arbitrary. The commands above were tested, others may need some fixing. Internally, windows are compared against your criteria (class, title, …) when they are initially managed and whenever one of the relevant values change. Then, the specified command is run once (per window). It gets prefixed with a criteria to make it match only the specific window that triggered it. So, if you configure "mode floating", i3 runs something like '[id="8393923"] mode floating'. 2011-05-15 22:10:25 +04:00
Ensure all *.[ch] files include config.h Including config.h is necessary to get e.g. the _GNU_SOURCE define and any other definitions that autoconf declares. Hence, config.h needs to be included as the first header in each file. This is done either via: 1. Including "common.h" (i3bar) 2. Including "libi3.h" 3. Including "all.h" (i3) 4. Including <config.h> directly Also remove now-unused I3__FILE__, add copyright/license statement where missing and switch include/all.h to #pragma once. 2016-10-11 10:13:35 +03:00			`#include <config.h>`

Time Lord technology: for_window config directive to run arbitrary cmds An example to set all XTerms floating: for_window [class="XTerm"] mode floating To make all urxvts use a 1-pixel border: for_window [class="urxvt"] border 1pixel A less useful, but rather funny example: for_window [title="x200: ~/work"] mode floating The commands are not completely arbitrary. The commands above were tested, others may need some fixing. Internally, windows are compared against your criteria (class, title, …) when they are initially managed and whenever one of the relevant values change. Then, the specified command is run once (per window). It gets prefixed with a criteria to make it match only the specific window that triggered it. So, if you configure "mode floating", i3 runs something like '[id="8393923"] mode floating'. 2011-05-15 22:10:25 +04:00			`/**`
			`* Checks the list of assignments for the given window and runs all matching`
			`* ones (unless they have already been run for this specific window).`
			`*`
			`*/`
			`void run_assignments(i3Window *window);`

Implement assignments for (named) workspaces, with '~' compatibility (floating) 2011-05-23 20:41:17 +04:00			`/**`
			`* Returns the first matching assignment for the given window.`
			`*`
			`*/`
			`Assignment assignment_for(i3Window window, int type);`