Locate versions of files in a dirvish vault
The index of each image specified vault] is searched for paths matching
pattern. Each path found matching the
pattern will be reported followed by a modification time of each version of the
file and all images having a link to it.
The optional branch] specification will restrict
searching to the specified branch.
Images with an error status will be skipped as will any
without index files. The index file may be compressed by
gzip or bzip2.
dirvish.conf(5) for details.
pattern is a
perl regular expression to match the final component of the path.
.* to the end of the pattern if you wish to match any substring
of the whole path
$ if you wish to anchor the pattern to the end of the path.
See perlre(1) for details.
Directories are excluded from matching as they would wind up
matching every file within them anyway.
Symlinks are also excluded from matching.
pattern matches too many paths
dirvish-locate will only report the paths matched and not versions.
As a sanity check if the number of matches is really excessive
dirvish-locate will limit the number of images searched.
Excessive matches is an indication of an insufficiently
pattern. Use the resulting path list to compose a more specific one.