From f6d6df46476f5abddb46c45afb90fa7f7362fa0b Mon Sep 17 00:00:00 2001
From: Michele Calgaro <michele.calgaro@yahoo.it>
Date: Tue, 21 Aug 2018 00:08:41 +0900
Subject: [PATCH] Improved description of "what's this" for placeholder in Find
 and Replace dialog. This resolves to bug 2558.

Signed-off-by: Michele Calgaro <michele.calgaro@yahoo.it>
---
 doc/kate/part.docbook | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/kate/part.docbook b/doc/kate/part.docbook
index ad74be9c7..6d7524797 100644
--- a/doc/kate/part.docbook
+++ b/doc/kate/part.docbook
@@ -353,8 +353,10 @@ additional options:</para>
 <varlistentry id="replace-use-placeholders">
 <term><guilabel>Use placeholders</guilabel></term>
 <listitem>
-<para>If enabled, any occurrence of <keycap>\N</keycap> where 
-<keycap>N</keycap> is an integer number, will be replaced 
+<para>When regular expressions are enabled, you can select part of the searched text by enclosing it
+within parenthesis. Placeholders allow you to insert such text in the replacement string, similar to
+how backreferences are used in sed. When enabled, any occurrence of <keycap>\N</keycap> (where
+<keycap>N</keycap> is an integer number, e.g. \1, \2, ...) will be replaced
 with the corresponding string capture (parenthesized substring)
 from the search pattern. A button for listing all available string captures
 will also be enabled. You can click on any of the available string captures