;csv: emphasize regular expressions features and doc

This commit is contained in:
Simon Michael 2020-05-10 13:01:59 -07:00
parent 6b2dfad98c
commit f167c223a2
2 changed files with 8 additions and 6 deletions

View File

@ -543,8 +543,10 @@ REGEX
```
REGEX is a case-insensitive regular expression which tries to match anywhere within the CSV record.
It is a POSIX extended regular expressions with some additions (see
[Regular expressions](https://hledger.org/hledger.html#regular-expressions) in the hledger manual).
It is a POSIX ERE (extended regular expression)
that also supports GNU word boundaries (`\b`, `\B`, `\<`, `\>`),
and nothing else.
If you have trouble, be sure to check our https://hledger.org/hledger.html#regular-expressions doc.
Important note: the record that is matched is not the original record, but a synthetic one,
with any enclosing double quotes (but not enclosing whitespace) removed, and always comma-separated

View File

@ -832,18 +832,18 @@ If they're not doing what you expect, it's important to know exactly what they s
#. they are case insensitive
#. they are infix matching (they do not need to match the entire thing being matched)
#. they are [POSIX extended regular expressions][]
#. they also support [word boundaries][] (`\<`, `\>`, `\b`, `\B`)
#. they are [POSIX ERE][] (extended regular expressions)
#. they also support [GNU word boundaries][] (`\b`, `\B`, `\<`, `\>`)
#. they do not support [mode modifiers][] (like `(?s)`)
#. when searching, they do not support [capturing groups][] and [backreferences][] (`\1`).
But when used for text replacement (eg in [account aliases](journal.html#regex-aliases)),
they do support [capturing groups][] in the search string and [backreferences][] in the replacement string.
[POSIX extended regular expressions]: http://www.regular-expressions.info/posix.html#ere
[POSIX ERE]: http://www.regular-expressions.info/posix.html#ere
[backreferences]: https://www.regular-expressions.info/backref.html
[capturing groups]: http://www.regular-expressions.info/refcapture.html
[mode modifiers]: http://www.regular-expressions.info/modifiers.html
[word boundaries]: http://www.regular-expressions.info/wordboundaries.html
[GNU word boundaries]: http://www.regular-expressions.info/wordboundaries.html
Some things to note: