Message: previous - next
Month: December 2015

kwrite/kate - help - find/replace - no documentation on "Placeholders"

From: "David C. Rankin" <drankinatty@...>
Date: Sat, 12 Dec 2015 13:18:11 -0600

   The help documentation for kde3/trinity does not include information on the 
katepart find/replace dialog "Placeholders" text entry box, checkbox or button. 
Searching, I found where it was later added in KDE4.

   A somewhat expanded version of that help is included below. I opened a eature 
request (dunno if Darrell 
is still the help Maestro, so it is there for anyone to patch/submit - I don't 
have a current clone of the repo or I'd do it.):

Replacement Text

     Here you may enter the text to replace the text or expression entered in 
the "Text to find:" entry combobox.

     You can reuse all or part of the "Text to find:" text or expression in the 
"Replacement text" by selecting the "Use placeholders" checkbox. Placeholders, 
also known as 'backreferences', are a special character sequence that will be 
replaced with all or part of the original text or expression. They offer a 
short-cut to entering a full "Replacement text" expression. For instance, by 
default "\0" represents the complete 'pattern space' matched as a result of the 
text or expression entered in the "Text to find:" box. (a backreference to the 
entire matched string).

     You may insert placeholders into the "Replacement text" box by clicking the 
"Insert Placeholder" button, then selecting an option from the menu like 
'Complete Match'. For example, if you are searching for "message", and you want 
to replace it with messages insert the Complete Match placeholder and add and 
"s". The replace field will then contain "\0s".

     If Kate is installed, you can learn more about placeholders in the 'Regular 
Expressions' appendix of its documentation.

David C. Rankin, J.D.,P.E.