From: Ingo Bürk <admin@airblader.de>
Date: Sun, 12 Feb 2017 19:24:35 +0000 (+0100)
Subject: Add troubleshooting for title attributes during layout restoring. (#2679)
X-Git-Tag: 4.14~52
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=ad9c879cbd5a9cc7f41484ea4651cf02c17335f5;p=i3%2Fi3

Add troubleshooting for title attributes during layout restoring. (#2679)
---

diff --git a/docs/layout-saving b/docs/layout-saving
index 5897036e..6ca08fa2 100644
--- a/docs/layout-saving
+++ b/docs/layout-saving
@@ -259,3 +259,27 @@ container:
     ]
 }
 --------------------------------------------------------------------------------
+
+=== Placeholders using window title matches don't swallow the window
+
+If you use the +title+ attribute to match a window and find that it doesn't
+work or only works sometimes, the reason might be that the application sets the
+title only after making the window visible. This will be especially true for
+programs running inside terminal emulators, e.g., +urxvt -e irssi+ when
+matching on +title: "irssi"+.
+
+One way to deal with this is to not rely on the title, but instead use, e.g.,
+the +instance+ attribute and running the program to set this window instance to
+that value:
+
+--------------------------------------------------------------------------------
+# Run irssi via
+# urxvt -name "irssi-container" -e irssi
+
+"swallows": [
+    {
+        "class": "URxvt",
+        "instance": "irssi-container"
+    }
+]
+--------------------------------------------------------------------------------