Skip to content

Commit

Permalink
Add warning on find/replace form usage
Browse files Browse the repository at this point in the history
  • Loading branch information
molsonkiko committed Jul 23, 2024
1 parent 287d784 commit 89b3d6e
Showing 1 changed file with 2 additions and 0 deletions.
2 changes: 2 additions & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,6 +98,8 @@ Let's look at the file one last time, this time with previews.

You can use a form to search for text in the huge file that you've chosen. This form will find matches for simple text or a regular expression. This plugin uses [.NET regular expressions](https://learn.microsoft.com/en-us/dotnet/standard/base-types/regular-expression-language-quick-reference), not the Boost regex engine used by Notepad++.

__WARNING:__ Because each find/replace operation is done chunk-by-chunk, this form *will not find or replace any matches that cross chunk boundaries.* Because of this limitation, __you should not use this form to search for regular expressions that can match multiple lines,__ and before doing any replacements, you should make sure that no chunk boundaries occur in unexpected locations.

__NOTE__: For all releases up to and including [0.4.0](/CHANGELOG.md#040---2023-02-24), a syntactically incorrect regular expression (e.g., unmatched parentheses, bad escape sequence) will cause the plugin, and possibly Notepad++ as a whole, to crash. [Consult this reference](https://learn.microsoft.com/en-us/dotnet/standard/base-types/regular-expression-language-quick-reference) to see what kinds of regular expressions can be used.

The search form caps out at 100 search results per chunk. This is in place to avoid excessive memory consumption when searching very large files. Starting in version [0.4.1](/CHANGELOG.md#041---2023-03-08), the form will show how many results were found in total, but it will still only show at most 100 results per chunk.
Expand Down

0 comments on commit 89b3d6e

Please sign in to comment.