diff options
author | Joey Hess <joeyh@joeyh.name> | 2016-01-20 13:04:07 -0400 |
---|---|---|
committer | Joey Hess <joeyh@joeyh.name> | 2016-01-20 13:04:07 -0400 |
commit | 91c9f6f086cf6d503c3ecb10a211c0c946e554eb (patch) | |
tree | a4e5409d432176937b326f6bf9056c440c40dee1 /doc | |
parent | c48b1434d1443ea1421fa474a6a5aecbf60ac83a (diff) |
find --batch
Diffstat (limited to 'doc')
-rw-r--r-- | doc/git-annex-find.mdwn | 29 | ||||
-rw-r--r-- | doc/todo/--batch_for_find.mdwn | 2 |
2 files changed, 21 insertions, 10 deletions
diff --git a/doc/git-annex-find.mdwn b/doc/git-annex-find.mdwn index 4c1501e96..9c578c245 100644 --- a/doc/git-annex-find.mdwn +++ b/doc/git-annex-find.mdwn @@ -13,6 +13,19 @@ finds files in the current directory and its subdirectories. # OPTIONS +* matching options + + The [[git-annex-matching-options]](1) + can be used to specify files to list. + + By default, the find command only lists annexed files whose content is + currently present. Specifying any of the matching options will override + this default behavior. + + To list all annexed files, present or not, specify `--include "*"`. + + To list annexed files whose content is not present, specify `--not --in=here` + * `--print0` Output filenames terminated with nulls, for use with `xargs -0` @@ -41,18 +54,14 @@ finds files in the current directory and its subdirectories. This is intended to be parsed by programs that use git-annex. Each line of output is a JSON object. -* matching options - - The [[git-annex-matching-options]](1) - can be used to specify files to list. +* `--batch` - By default, the find command only lists annexed files whose content is - currently present. Specifying any of the matching options will override - this default behavior. + Enables batch mode, in which a file is read in a line from stdin, + its information displayed, and repeat. - To list all annexed files, present or not, specify `--include "*"`. - - To list annexed files whose content is not present, specify `--not --in=here` + Note that if the file is not an annexed file, or is not present, + or otherwise doesn't meet the matching options, an empty line + will be output instead. # SEE ALSO diff --git a/doc/todo/--batch_for_find.mdwn b/doc/todo/--batch_for_find.mdwn index 89f6e3de5..825ca560f 100644 --- a/doc/todo/--batch_for_find.mdwn +++ b/doc/todo/--batch_for_find.mdwn @@ -1,3 +1,5 @@ I am using `annex find filename` after running 'annex add` to figure out if file was added to annex or to git. [[!meta author=yoh]] + +> [[done]] --[[Joey]] |