git-annex/doc/git-annex-findref.mdwn
Joey Hess 904be4e6be
add --branch option to git-annex find and mildly deprecate findref in favor of it
No deprecation warning at run time, just one on the man page.

One thing findref remains able to do that find cannot is to run in a bare
repo. Find was made to refuse to run in a bare repo because it seemed
confusing for it to not list any files ever in that situation. It would be
better for find --branch to work in a bare repo but not without --branch
but I don't currently have a way to do that.

Probably a better solution would be to make git-annex in a bare repo
default to --branch master or something like that instead of --all.

This commit was sponsored by Denis Dzyubenko on Patreon.
2018-12-09 14:10:37 -04:00

27 lines
470 B
Markdown

# NAME
git-annex findref - lists files in a git ref (deprecated)
# SYNOPSIS
git annex findref `[ref]`
# DESCRIPTION
This is the same as `git annex find` with the --branch option, and you're
encouraged to use that instead unless you need to support older versions of
git-annex.
# OPTIONS
Same as [[git-annex-find]](1)
# SEE ALSO
[[git-annex]](1)
# AUTHOR
Joey Hess <id@joeyh.name>
Warning: Automatically converted into a man page by mdwn2man. Edit with care.