cv find

Usage

Each line on stdout is a ref that holds the text, how often when it is more than once, and the words around it. A line on stderr says whether an edit with this find matches once, nowhere, or in several places.

Several places, or none

A find edit must match exactly one place. In several, the edit fails with ambiguous; add a ref to look in one part, or set all to true to change every place.

When the text is nowhere, stdout is empty and stderr says why a find can miss. cv find exits 0 when it runs, whatever it finds.

How text is matched

• A find matches the text of a part as units[].text in the JSON view has it: the refs view without its marks, such as the ref tags ([p3]), automatic numbers and the quotes around sheet text that looks like a number.
• Send it with the same case and spaces. It also matches inside longer words.
• --scope looks only in those parts, like the ref of a find edit. A scope covers exactly the parts it names.
• In a PDF form a find looks in field labels first. A field found by its label is marked (label), and an edit there fills the field.

Flags

With --json

data has total and found, a list of {ref, count, text} in the order a find edit sees them, with the whole text of each part. It also has find, rev, format and warnings.