git-annex/doc/git-annex-findref.mdwn

# 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.
finished splitting out man pages for all commands 2015-03-25 16:09:49 +00:00			`# NAME`

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 18:10:37 +00:00			`git-annex findref - lists files in a git ref (deprecated)`
finished splitting out man pages for all commands 2015-03-25 16:09:49 +00:00
			`# SYNOPSIS`

			git annex findref `[ref]`

			`# DESCRIPTION`

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 18:10:37 +00:00			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.`
finished splitting out man pages for all commands 2015-03-25 16:09:49 +00:00
			`# 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.`