### ----------------------------------------------------
### -- App::Rak
### -- Licenses: Artistic-2.0
### -- Authors: Elizabeth Mattijsen
### -- File: resources/help/string.txt
### ----------------------------------------------------
String search pattern modifiers:
‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒‒

--ignorecase

If specified with a True value, will cause the pattern matcher (if
it is *not* a Callable) to ignore the distinction between upper,
lower and title case letters.

Example:
# search for "foo" without taking case into account
$ rak --ignorecase foo

--ignoremark

If specified with a True value, will cause the pattern matcher (if
it is *not* a Callable) to only use the base character, ignoring any
additional marks and/or accents.

Example:
# search for "foo" without taking accents into account
$ rak --ignoremark foo

--smartcase

If specified with a True value, will cause the pattern matcher (if
it is a literal text) to ignore the distinction between upper,
lower and title case letters (like --ignorecase), but only if the
pattern does **NOT** contain any uppercase letters.

Example:
# search for "foo" without taking case into account
$ rak --smartcase foo

# search for "Foo" while *still* taking case into account
$ rak --smartcase Foo

--smartmark

If specified with a True value, will cause the pattern matcher (if
it is a literal text) to ignore any accents on letters (like --ignormark),
but only if the pattern does **NOT** contain any accented letters.

Example:
# search for "foo" without taking accents into account
$ rak --smartmark foo

# search for "Foo" while *still* taking accents into account
$ rak --smartmark fóö

--type=[auto|contains|words|starts-with|ends-with|equal|regex|code]

Expects one of the following literal values:

 - auto         allow for shortcuts in pattern (default)
 - contains     accept if literal pattern occurs anywhere
 - words        accept if literal pattern is on word/non-word boundaries
 - starts-with  accept if literal pattern is at the start of an item
 - ends-with    accept if literal pattern is at the end of an item
 - equal        accept if literal pattern is same as line
 - regex        accept if pattern as regex matches an item
 - code         accept if pattern as code produces a result for an item

Examples:
# search for "foo" anywhere in an item (default case)
$ rak foo

# search for "foo" anywhere in an item
$ rak --type=contains foo

# search for "foo" as a word
$ rak --type=words foo

# search for "foo" at the start of a line
$ rak --type=starts-with foo

# search for "foo" at the end of a line
$ rak --type=ends-with foo

# search for lines consisting of "foo"
$ rak --type=equal foo

# search for /i.e/ in a line
$ rak --type=regex i.e

# return all lines in uppercase
$ rak --type=code .uc


