aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorGravatar Joey Hess <joeyh@joeyh.name>2016-07-06 11:54:46 -0400
committerGravatar Joey Hess <joeyh@joeyh.name>2016-07-06 11:56:11 -0400
commit4017cd1928435bef10dcb5183ddcc08945ba8bef (patch)
treeccb0b0b675bd915e44d3be836734ef3039c148c0 /doc
parentc87785692855f40d1507da6eb2c52ade63365479 (diff)
drop: Add --batch and --json options.
Diffstat (limited to 'doc')
-rw-r--r--doc/git-annex-drop.mdwn10
-rw-r--r--doc/todo/batch_get__47__drop__47__etc.mdwn3
-rw-r--r--doc/todo/drop_--batch.mdwn3
3 files changed, 16 insertions, 0 deletions
diff --git a/doc/git-annex-drop.mdwn b/doc/git-annex-drop.mdwn
index 2e207cd8b..0bbbd78df 100644
--- a/doc/git-annex-drop.mdwn
+++ b/doc/git-annex-drop.mdwn
@@ -61,6 +61,16 @@ safe to do so.
when git-annex has to contact remotes to check if it can drop files.
For example: `-J4`
+* `--batch`
+
+ Enables batch mode, in which lines containing names of files to drop
+ are read from stdin.
+
+* `--json`
+
+ Enable JSON output. This is intended to be parsed by programs that use
+ git-annex. Each line of output is a JSON object.
+
# SEE ALSO
[[git-annex]](1)
diff --git a/doc/todo/batch_get__47__drop__47__etc.mdwn b/doc/todo/batch_get__47__drop__47__etc.mdwn
index 25da67c96..154d4aca6 100644
--- a/doc/todo/batch_get__47__drop__47__etc.mdwn
+++ b/doc/todo/batch_get__47__drop__47__etc.mdwn
@@ -1,3 +1,6 @@
in the spirit of [[todo/--batch_for_add/]], [[todo/--batch_for_info/]], [[todo/--batch_for_find/]] and [[todo/--batch_for_whereis/]], why not add `--batch` to get/drop/import operations?
I am writing a script to get a bunch of arbitrary files and i want to avoid the overhead of running git-annex multiple times. I know i can use `annex.alwayscommit=false` but that is rather counter-intuitive as well. --[[anarcat]]
+
+> [[done]] for add and drop. (Not for import, but if someone requests it
+> with a use case we'll see.) --[[Joey]]
diff --git a/doc/todo/drop_--batch.mdwn b/doc/todo/drop_--batch.mdwn
index 68c7a5a64..775798752 100644
--- a/doc/todo/drop_--batch.mdwn
+++ b/doc/todo/drop_--batch.mdwn
@@ -1,3 +1,6 @@
There is a dropkey --batch, so I guess I could workaround but probably would be nice for consistency to have --batch mode for drop itself as well
[[!meta author=yoh]]
+
+> [[done]]; went ahead and added drop --batch to be symmetric with get
+> --batch. --[[Joey]]