git-annex/doc/git-annex-trust.mdwn
Joey Hess 365dbc89dc
expire, trust et al, dead, describe: Support --json and --json-error-messages
For expire, the normal output is unchanged, but the --json output includes the uuid
in machine parseable form. Which could be very useful for this somewhat obscure
command. That needed ActionItemUUID to be implemented, which seemed like a lot
of work, but then ---

I had been going to skip implementing them for trust, untrust, dead, semitrust,
and describe, but putting the uuid in the json is useful information, it tells
what uuid git-annex picked given the input. It was not hard to support
these once ActionItemUUID was implemented.

Sponsored-By: the NIH-funded NICEMAN (ReproNim TR&D3) project
2023-05-05 15:33:30 -04:00

52 lines
1.2 KiB
Markdown

# NAME
git-annex trust - trust a repository
# SYNOPSIS
git annex trust `[repository ...]`
# DESCRIPTION
Records that a repository is trusted to not unexpectedly lose
content. Use with care.
Repositories can be specified using their remote name, their
description, or their UUID. To trust the current repository, use "here".
Before trusting a repository, consider this scenario. Repository A
is trusted and B is not; both contain the same content. `git-annex drop`
is run on repository A, which checks that B still contains the content,
and so the drop proceeds. Then `git-annex drop` is run on repository B,
which trusts A to still contain the content, so the drop succeeds. Now
the content has been lost.
# 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.
* Also the [[git-annex-common-options]](1) can be used.
# SEE ALSO
[[git-annex]](1)
[[git-annex-semitrust]](1)
[[git-annex-untrust]](1)
[[git-annex-dead]](1)
# AUTHOR
Joey Hess <id@joeyh.name>
Warning: Automatically converted into a man page by mdwn2man. Edit with care.