From ad9c879cbd5a9cc7f41484ea4651cf02c17335f5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ingo=20B=C3=BCrk?= <admin@airblader.de>
Date: Sun, 12 Feb 2017 20:24:35 +0100
Subject: [PATCH] Add troubleshooting for title attributes during layout
 restoring. (#2679)

---
 docs/layout-saving | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

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"
+    }
+]
+--------------------------------------------------------------------------------