gri3-wm/include/scratchpad.h

/*
 * vim:ts=4:sw=4:expandtab
 *
 * i3 - an improved dynamic tiling window manager
 * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
 *
 * scratchpad.c: Scratchpad functions (TODO: more description)
 *
 */
#pragma once

#include <config.h>

/**
 * Moves the specified window to the __i3_scratch workspace, making it floating
 * and setting the appropriate scratchpad_state.
 *
 * Gets called upon the command 'move scratchpad'.
 *
 */
void scratchpad_move(Con *con);

/**
 * Either shows the top-most scratchpad window (con == NULL) or shows the
 * specified con (if it is scratchpad window).
 *
 * When called with con == NULL and the currently focused window is a
 * scratchpad window, this serves as a shortcut to hide it again (so the user
 * can press the same key to quickly look something up).
 *
 */
bool scratchpad_show(Con *con);

/**
 * When starting i3 initially (and after each change to the connected outputs),
 * this function fixes the resolution of the __i3 pseudo-output. When that
 * resolution is not set to a function which shares a common divisor with every
 * active output’s resolution, floating point calculation errors will lead to
 * the scratchpad window moving when shown repeatedly.
 *
 */
void scratchpad_fix_resolution(void);
-												add missing scratchpad.{c,h}

											
										
										
											2011-12-22 00:17:52 +01:00
+								/*
 								 * vim:ts=4:sw=4:expandtab
 								 *
 								 * 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 02:17:56 +02:00
+								 * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
-												add missing scratchpad.{c,h}

											
										
										
											2011-12-22 00:17:52 +01:00
+								 *
 								 * scratchpad.c: Scratchpad functions (TODO: more description)
 								 *
 								 */
-												Use #pragma once

 #pragma once is safer and simpler. According to Wikipedia it's supported by all major compilers.

											
										
										
											2013-12-29 03:11:50 +01:00
+								#pragma once
-												add missing scratchpad.{c,h}

											
										
										
											2011-12-22 00:17:52 +01: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 09:13:35 +02:00
+								#include <config.h>
-												add missing scratchpad.{c,h}

											
										
										
											2011-12-22 00:17:52 +01:00
+								/**
 								 * Moves the specified window to the __i3_scratch workspace, making it floating
 								 * and setting the appropriate scratchpad_state.
 								 *
 								 * Gets called upon the command 'move scratchpad'.
 								 *
 								 */
 								void scratchpad_move(Con *con);
 								/**
 								 * Either shows the top-most scratchpad window (con == NULL) or shows the
 								 * specified con (if it is scratchpad window).
 								 *
 								 * When called with con == NULL and the currently focused window is a
 								 * scratchpad window, this serves as a shortcut to hide it again (so the user
 								 * can press the same key to quickly look something up).
 								 *
 								 */
-												Make "scratchpad show" return correct info

Fix the issue #3227(https://github.com/i3/i3/issues/3227).

1).Make cmd_scratchpad_show() use the information coming from scratchpad_show().
2).Add a test case 298-scratchpad-show.t.

											
										
										
											2018-04-06 18:00:38 +02:00
+								bool scratchpad_show(Con *con);
-												add missing scratchpad.{c,h}

											
										
										
											2011-12-22 00:17:52 +01:00
-												scratchpad: fix moving scratchpad window

From the source:

    When starting i3 initially (and after each change to the connected
    outputs), this function fixes the resolution of the __i3
    pseudo-output. When that resolution is not set to a function which
    shares a common divisor with every active output’s resolution,
    floating point calculation errors will lead to the scratchpad window
    moving when shown repeatedly.

fixes #632

											
										
										
											2012-08-08 16:22:03 +02:00
+								/**
 								 * When starting i3 initially (and after each change to the connected outputs),
 								 * this function fixes the resolution of the __i3 pseudo-output. When that
 								 * resolution is not set to a function which shares a common divisor with every
 								 * active output’s resolution, floating point calculation errors will lead to
 								 * the scratchpad window moving when shown repeatedly.
 								 *
 								 */
 								void scratchpad_fix_resolution(void);