TXT_FIND documentation || Using TXT_FIND in <ISINDEX> searchable indices

### Search a file for selected words and phrases

This demonstates TXT_FIND: an SREhttp/2 addon for searching ascii-text documents.

Enter name of file(s) to search:
(* wildcards are allowed)

Enter search string: (Usage hints)

### Advanced options .....

Paragraph delimiter :
- Leave blank for "blank lines define paragraphs"
- Use $ for "each line is a paragraph"
- Enter custom delimiter (i.e. the ; character )

Display the first lines of each paragraph

Do not display line/paragraph number
Do not draw horizontal bars at the end of
Do not underline matches each paragraph
Use expert mode (when processing searchlist)
Case sensitive search

### Usage hints

#### Non-expert mode (with highlighting)

Two "meta commands" and 4 target specific instructions are recognized.
Meta commands are signified by *& or *\ at the beginning of the search string.
- *& means "find paragraphs that match ALL targets in the search string"
- *\ means "find paragraphs that match NONE of the targets in the search string"
If there are no meta commands, the following "target specific" commands are recognized.
- & means paragraphs MUST have this target
- | means accept paragraph if it has this target
- Note that | is the default (assumed if no target specific command entered).
- \ means paragraph must NOT have this target
- % means accept paragraph if it does NOT have this target

##### Summarizing ..

To be a "found" paragraph:
- Any | must be present, or
- All of the % are missing
- Given the above is satisfied, then
- None of the \ can be present, and
- All of the & must be present
If present, all & and | targets will be highlighted

Examples:

( The best car)
  Finds paragraphs containing the phrase `the best car`
car truck motorcycle
  Finds paragraphs that contain one (or more) of `car, truck` or `motorcycle`
dog cat & store (pet pig)
  Finds paragraphs that contain one (or more) of `dog, cat` or the phrase `pet pig`; and that also contain `store`
*& computer price memory
  Finds paragraphs that contain `computer, price`, and `memory` (must have all of them, but can be in any order)

#### Expert mode (no highlighting)

The user enters a logical expression using the following operators:
- & = AND
- | = OR
- \ = NOT
- @ = XOR
- ( ) to group expressions
A sequence of words without any operators is treated as a phrase -- to treat each word as a seperate subword, put ( ) around each one. Basically, when using this mode, be liberal in your use of ( ), and complete in your placement of operators.

Examples:

The best car
  Finds paragraphs containing the phrase `the best car`
car | truck | motorcycle
  Finds paragraphs that contain one (or more) of `car, truck` or `motorcycle`
( (dog & cat) | (pet pig) ) & stores
  Finds paragraphs that contain `stores`, and that contain either both `dog` and `cat`, or the phrase `pet pig`