git-annex/doc/git-annex-addunused.mdwn
Joey Hess 1a9af823bc
addunused, dropunused: Support --json and --json-error-messages
This also changes addunused to display the names of the files that it adds.
That seems like a general usability improvement, and not displaying the input
number does not seem likely to be a problem to a user, since the filename
is based on the key. Displaying the filename was necessary to get it and the key
included in the json.

dropunused does not include the key in the json. It would be possible to
add, but would need more changes. And I doubt that dropunused --json
would be used in a situation where a program cared which keys were
dropped. Note that drop --unused does have the key in its json, so such
a program could just use it. Or could just dropkey --batch with the
specific keys it wants to drop if it cares about specific keys.

Sponsored-By: the NIH-funded NICEMAN (ReproNim TR&D3) project
2023-05-05 14:01:40 -04:00

42 lines
809 B
Markdown

# NAME
git-annex addunused - add back unused files
# SYNOPSIS
git annex addunused `[number|range ...]`
# DESCRIPTION
Adds back files for the content corresponding to the numbers or ranges,
as listed by the last `git annex unused`.
The files will have names starting with "unused."
# OPTIONS
* `--json`
Enable JSON output. This is intended to be parsed by programs that use
git-annex. Each line of output is a JSON object.
* `--json-error-messages`
Messages that would normally be output to standard error are included in
the JSON instead.
* The [[git-annex-common-options]](1) can also be used.
# SEE ALSO
[[git-annex]](1)
[[git-annex-add]](1)
[[git-annex-unused]](1)
# AUTHOR
Joey Hess <id@joeyh.name>
Warning: Automatically converted into a man page by mdwn2man. Edit with care.