Merge branch 'release-4.16.1'

[i3/i3] / include / scratchpad.h

diff --git a/include/scratchpad.h b/include/scratchpad.h
index 4fb7523a0bf4df581c25c2831d23380a774ce4e2..b24ffc080ec4d0600718ff2887ca919cf779ca60 100644 (file)
--- a/include/scratchpad.h
+++ b/include/scratchpad.h
@@ -2,13 +2,14 @@
  * vim:ts=4:sw=4:expandtab
  *
  * i3 - an improved dynamic tiling window manager
- * © 2009-2011 Michael Stapelberg and contributors (see also: LICENSE)
+ * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
  *
  * scratchpad.c: Scratchpad functions (TODO: more description)
  *
  */
-#ifndef _SCRATCHPAD_H
-#define _SCRATCHPAD_H
+#pragma once
+
+#include <config.h>
 
 /**
  * Moves the specified window to the __i3_scratch workspace, making it floating
@@ -28,6 +29,14 @@ void scratchpad_move(Con *con);
  * can press the same key to quickly look something up).
  *
  */
-void scratchpad_show(Con *con);
+bool scratchpad_show(Con *con);
 
-#endif
+/**
+ * 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);