Find - Revision history

Jsimlo at 15:35, 31 May 2026

2026-05-31T15:35:20Z

Jsimlo at 15:26, 31 May 2026

2026-05-31T15:26:05Z

Jsimlo at 15:22, 31 May 2026

2026-05-31T15:22:50Z

Jsimlo at 12:28, 31 May 2026

2026-05-31T12:28:52Z

Jsimlo at 18:40, 30 May 2026

2026-05-30T18:40:21Z

Jsimlo at 18:23, 30 May 2026

2026-05-30T18:23:28Z

Jsimlo at 18:20, 30 May 2026

2026-05-30T18:20:13Z

Jsimlo at 18:16, 30 May 2026

2026-05-30T18:16:06Z

Jsimlo at 20:43, 29 May 2026

2026-05-29T20:43:41Z

Jsimlo at 00:46, 29 May 2026

2026-05-29T00:46:47Z

@@ Line 24: / Line 24: @@
 {{version}} Prior to version 6.0, this option was available within the {{dialog|Settings}} dialog. It has been moved to {{dialog|Search}} dialog in version 6.0 for convenience.
 '''{{field|Search|Use 2nd search}}''' option can be used to switch between entering {{feature|primary search}} and {{feature|secondary search}}. Whenever searching, search phrase and search options are automatically remembered into either {{feature|primary search}} or into {{feature|secondary search}}, and can be re-used later, for example by {{feature|Find Next}} (using {{feature|primary search}}) or {{feature|Look for Next}} (using {{feature|secondary search}}) respectively. Most available search commands are coupled this way, e.g. {{feature|Find Previous}} and {{feature|Look for Previous}}, {{feature|Find Selected}} and {{feature|Look for Selected}}, {{feature|Find Later}} and {{feature|Look for Later}}, etc.
@@ Line 31: / Line 29: @@
 {{version}} Prior to version 6.0, this option was not available and the {{dialog|Search}} dialog was restricted to the {{feature|primary search}} only.
-=====Highlight all=====
+'''{{field|Search|Highlight all}}''' option can be used to automatically get all occurrences of the entered {{field|Search|Find}} pattern highlighted whenever the {{dialog|Search bar}} is open.
 '''{{field|Search|Keep history}}''' option can be used to start collecting search patterns, with respective search options, and also replace patterns, with respective replacing options. Both {{field|Search|Find}} and {{field|Replace|Replace}} have small drop-downs attached to them, where up to 50 recent search patterns, or replace patterns, respectively, are stored.
 Buttons '''{{button|Search|Next}}''' and '''{{button|Search|Previous}}''' can be used to search downwards or upwards from the current position. Several hotkeys are available in the {{dialog|Search}} dialog as well as described below.

← Older revision		Revision as of 15:26, 31 May 2026
Line 54:		Line 54:

	{{tip}} Choosing a pattern from the history also restores the related checkboxes, e.g. {{field\|Search\|Match case}}, {{field\|Search\|Whole words}}, {{field\|Search\|RegExps}}, etc.		{{tip}} Choosing a pattern from the history also restores the related checkboxes, e.g. {{field\|Search\|Match case}}, {{field\|Search\|Whole words}}, {{field\|Search\|RegExps}}, etc.
		+
		+	See also {{field\|Settings:Search\|Keep search history}} and {{field\|Settings:Search\|Include searches via Find Selected}} settings on the [[Search page]] of the {{dialog\|Settings}} dialog.

	{{tip}} Search patterns and their options are collected separately to replacing patterns and their options. Which means there are up to 50 searches retained, and also up to 50 replacements retained.		{{tip}} Search patterns and their options are collected separately to replacing patterns and their options. Which means there are up to 50 searches retained, and also up to 50 replacements retained.

@@ Line 33: / Line 33: @@
 =====Highlight all=====
-'''{{field|Search|Highlight all}}''' option can be used to {{todo|describe Highlight all, 2nd search, refreshing, counting, etc.}}
+'''{{field|Search|Highlight all}}''' option can be used to automatically get all occurrences of the entered {{field|Search|Find}} pattern highlighted whenever the {{dialog|Search bar}} is open. Note: Closing the dialog erases all highlighting.
-{{todo|Incremental search highlighting occurences vs Regular search moving the selection}}
+Highlighting is updated whenever the search pattern (or any of the related options), incrementally changes, i.e. occurrences are highlighted as the user types the search pattern or changes options like {{field|Search|Match case}}, {{field|Search|Whole words}}, {{field|Search|RegExps}}, etc.
-{{tip}} {{field|Search|Highlight all}} shows <q>Total matches</q> directly in the {{feature|Search}} Bar. This value only gets updated when the {{feature|Search}} Bar actually runs an incremental search. Editing the document, e.g. removing the highlighted occurrences, does not immediately change the number shown. Toggle {{field|Search|Match case}} (or another checkbox related to the {{field|Search|Find}} pattern) to refresh the number whenever needed.
+Users can freely modify the document while highlighting is in place. Individual pieces of highlighted text may get unhighlighted when directly modified. Note: Highlighting does not refresh itself automatically even when new potential occurrences are created in the text. Toggle {{field|Search|Match case}} (or another checkbox related to the {{field|Search|Find}} pattern) to refresh the highlighting properly.
 {{tip}} {{field|Search|Highlight all}} usually runs the incremental search in two phases. The first phase quickly finds as much as it can within a short period of time, to avoid interfering with typing new search patterns. The second phase, running through the rest of the document, is then delayed by a few seconds (and the delay gets even longer with bigger documents, up to 5 seconds in total).

@@ Line 37: / Line 37: @@
 {{todo|Incremental search highlighting occurences vs Regular search moving the selection}}
-{{tip}} {{field|Search|Highlight all}} shows <q>Total matches</q> directly in the {{feature|Search}} Bar. This value only gets updated when the {{feature|Search}} Bar actually runs an incremental search. Editing the document, e.g. removing the highlighted occurrences, does not immediately change the number shown. Toggle {{field|Search|Match case}} (or another checkbox related to the {{field|Search|Find}} pattern to refresh the number whenever needed).
+{{tip}} {{field|Search|Highlight all}} shows <q>Total matches</q> directly in the {{feature|Search}} Bar. This value only gets updated when the {{feature|Search}} Bar actually runs an incremental search. Editing the document, e.g. removing the highlighted occurrences, does not immediately change the number shown. Toggle {{field|Search|Match case}} (or another checkbox related to the {{field|Search|Find}} pattern) to refresh the number whenever needed.
 {{tip}} {{field|Search|Highlight all}} usually runs the incremental search in two phases. The first phase quickly finds as much as it can within a short period of time, to avoid interfering with typing new search patterns. The second phase, running through the rest of the document, is then delayed by a few seconds (and the delay gets even longer with bigger documents, up to 5 seconds in total).

← Older revision		Revision as of 18:40, 30 May 2026
Line 36:		Line 36:

	{{todo\|Incremental search highlighting occurences vs Regular search moving the selection}}		{{todo\|Incremental search highlighting occurences vs Regular search moving the selection}}
		+
		+	{{tip}} {{field\|Search\|Highlight all}} shows <q>Total matches</q> directly in the {{feature\|Search}} Bar. This value only gets updated when the {{feature\|Search}} Bar actually runs an incremental search. Editing the document, e.g. removing the highlighted occurrences, does not immediately change the number shown. Toggle {{field\|Search\|Match case}} (or another checkbox related to the {{field\|Search\|Find}} pattern to refresh the number whenever needed).
		+
		+	{{tip}} {{field\|Search\|Highlight all}} usually runs the incremental search in two phases. The first phase quickly finds as much as it can within a short period of time, to avoid interfering with typing new search patterns. The second phase, running through the rest of the document, is then delayed by a few seconds (and the delay gets even longer with bigger documents, up to 5 seconds in total).

	=====Search history=====		=====Search history=====

@@ Line 3: / Line 3: @@
 Shows the {{dialog|Search}} dialog at the bottom of the window, also called the {{dialog|Search bar}}.
-After entering search conditions, searches for specified {{field|Search|Find}} phrase within the document.
+After entering search conditions, searches for specified '''{{field|Search|Find}}''' phrase within the document.
 {{tip}} Several settings in the {{dialog|Settings}} dialog can alter, what phrase and options are preloaded into the {{dialog|Search}} dialog upon invoking. See chapter [[Search page]] of the {{dialog|Settings}} dialog.
-{{field|Search|Match case}} option can be used to {{defined|match case}} upon searching. By default, character case is ignored upon searching.
+'''{{field|Search|Match case}}''' option can be used to {{defined|match case}} upon searching. By default, character case is ignored upon searching.
-{{field|Search|Whole words}} option can be used to check for {{defined|word boundaries}} upon searching, i.e. a phrase is located in the document only if no {{defined|word letters}} are found directly before and after the phrase, and the phrase begins and ends with {{defined|word letters}}.
+'''{{field|Search|Whole words}}''' option can be used to check for {{defined|word boundaries}} upon searching, i.e. a phrase is located in the document only if no {{defined|word letters}} are found directly before and after the phrase, and the phrase begins and ends with {{defined|word letters}}.
 {{version}} Prior to version 6.0, only characters directly before and after the phrase were checked. Since version 6.0, phrase beginning and end is checked as well. So, if searching for whole words, the phrase itself must start and end with a {{defined|word}}.
-{{field|Search|Escapes}} option can be used to allow entering newlines and Tab characters into the {{field|Search|Find}} phrase. Use {{string|\n}} sequence to encode a newline, use {{string|\t}} to encode a Tab character, and use {{string|\\}} to encode a simple backslash ({{string|\}}) character wherever a confusion with other escapes could arise.
+'''{{field|Search|Escapes}}''' option can be used to allow entering newlines and Tab characters into the {{field|Search|Find}} phrase. Use {{string|\n}} sequence to encode a newline, use {{string|\t}} to encode a Tab character, and use {{string|\\}} to encode a simple backslash ({{string|\}}) character wherever a confusion with other escapes could arise.
 Note: A newline escape ({{string|\n}}) matches any kind of newline (Windows, Unix, Mac). A newline escape matches exactly one newline, i.e. use {{string|\n\n}} in order to match two consecutive newlines, etc.
-{{field|Search|RegExps}} option can be used to turn the {{feature|Regular expressions}} engine on. When {{feature|Regular expressions}} are enabled, {{field|Search|Find}} is parsed as a ''regular expression pattern''. See chapter [[Regular expressions]] for more details on supported regular expressions syntax.
+'''{{field|Search|RegExps}}''' option can be used to turn the {{feature|Regular expressions}} engine on. When {{feature|Regular expressions}} are enabled, {{field|Search|Find}} is parsed as a ''regular expression pattern''. See chapter [[Regular expressions]] for more details on supported regular expressions syntax.
 Note: Since [[regular expressions]] can take a long time to find match, {{hotkey|Esc}} can be used to interrupt a search.
-{{field|Search|Wrap around}} option can be used to allow searching even beyond the edge of the document. If the search encounters the end or the beginning of the document, it automatically wraps around the document edge and continues from the beginning or the end of the document respectively.
+'''{{field|Search|Wrap around}}''' option can be used to allow searching even beyond the edge of the document. If the search encounters the end or the beginning of the document, it automatically wraps around the document edge and continues from the beginning or the end of the document respectively.
 {{version}} Prior to version 6.0, this option was available within the {{dialog|Settings}} dialog. It has been moved to {{dialog|Search}} dialog in version 6.0 for convenience.
@@ Line 27: / Line 27: @@
 =====Primary vs Secondary search=====
-{{field|Search|Use 2nd search}} option can be used to switch between entering {{feature|primary search}} and {{feature|secondary search}}. Whenever searching, search phrase and search options are automatically remembered into either {{feature|primary search}} or into {{feature|secondary search}}, and can be re-used later, for example by {{feature|Find Next}} (using {{feature|primary search}}) or {{feature|Look for Next}} (using {{feature|secondary search}}) respectively. Most available search commands are coupled this way, e.g. {{feature|Find Previous}} and {{feature|Look for Previous}}, {{feature|Find Selected}} and {{feature|Look for Selected}}, {{feature|Find Later}} and {{feature|Look for Later}}, etc.
+'''{{field|Search|Use 2nd search}}''' option can be used to switch between entering {{feature|primary search}} and {{feature|secondary search}}. Whenever searching, search phrase and search options are automatically remembered into either {{feature|primary search}} or into {{feature|secondary search}}, and can be re-used later, for example by {{feature|Find Next}} (using {{feature|primary search}}) or {{feature|Look for Next}} (using {{feature|secondary search}}) respectively. Most available search commands are coupled this way, e.g. {{feature|Find Previous}} and {{feature|Look for Previous}}, {{feature|Find Selected}} and {{feature|Look for Selected}}, {{feature|Find Later}} and {{feature|Look for Later}}, etc.
 {{version}} Prior to version 6.0, this option was not available and the {{dialog|Search}} dialog was restricted to the {{feature|primary search}} only.
@@ Line 33: / Line 33: @@
 =====Highlight all=====
-{{field|Search|Highlight all}} option can be used to {{todo|describe Highlight all, 2nd search, refreshing, counting, etc.}}
+'''{{field|Search|Highlight all}}''' option can be used to {{todo|describe Highlight all, 2nd search, refreshing, counting, etc.}}
 {{todo|Incremental search highlighting occurences vs Regular search moving the selection}}
@@ Line 39: / Line 39: @@
 =====Search history=====
-{{field|Search|Keep history}} option can be used to start collecting search patterns, with respective search options, and also replace patterns, with respective replacing options. Both {{field|Search|Find}} and {{field|Replace|Replace}} have small drop-downs attached to them, where up to 50 recent search patterns, or replace patterns, respectively, are stored.
+'''{{field|Search|Keep history}}''' option can be used to start collecting search patterns, with respective search options, and also replace patterns, with respective replacing options. Both {{field|Search|Find}} and {{field|Replace|Replace}} have small drop-downs attached to them, where up to 50 recent search patterns, or replace patterns, respectively, are stored.
 {{tip}} Turning the {{field|Search|Keep history}} option off erases all the history.
@@ Line 49: / Line 49: @@
 =====Searching=====
-Buttons {{button|Search|Next}} and {{button|Search|Previous}} can be used to search downwards or upwards from the current position. Several hotkeys are available in the {{dialog|Search}} dialog as well as described below.
+Buttons '''{{button|Search|Next}}''' and '''{{button|Search|Previous}}''' can be used to search downwards or upwards from the current position. Several hotkeys are available in the {{dialog|Search}} dialog as well as described below.
 Note: Works with the {{feature|primary search}} definition, unless {{field|Search|Use 2nd search}} option specifies otherwise.

← Older revision		Revision as of 20:43, 29 May 2026
Line 30:		Line 30:

	{{field\|Search\|Highlight all}} option can be used to {{todo\|describe Highlight all, 2nd search, refreshing, counting, etc.}}		{{field\|Search\|Highlight all}} option can be used to {{todo\|describe Highlight all, 2nd search, refreshing, counting, etc.}}
		+
		+	{{todo\|Incremental search highlighting occurences vs Regular search moving the selection}}

	{{field\|Search\|Keep history}} option can be used to {{todo\|describe Keep history, search vs replace, combo boxes, limit, etc.}}		{{field\|Search\|Keep history}} option can be used to {{todo\|describe Keep history, search vs replace, combo boxes, limit, etc.}}

@@ Line 29: / Line 29: @@
 {{version}} Prior to version 6.0, this option was not available and the {{dialog|Search}} dialog was restricted to the {{feature|primary search}} only.
-{{field|Search|Highlight all}} option can be used to {{todo|describe Highlight all}}
+{{field|Search|Highlight all}} option can be used to {{todo|describe Highlight all, 2nd search, refreshing, counting, etc.}}
-{{field|Search|Keep history}} option can be used to {{todo|describe Keep history}}
+{{field|Search|Keep history}} option can be used to {{todo|describe Keep history, search vs replace, combo boxes, limit, etc.}}
 Buttons {{button|Search|Next}} and {{button|Search|Previous}} can be used to search downwards or upwards from the current position. Several hotkeys are available in the {{dialog|Search}} dialog as well as described below.