Skip to content

docs: add docs for "key add", "key list" and "key remove"#9769

Merged
ThomasWaldmann merged 1 commit into
borgbackup:masterfrom
ThomasWaldmann:docs-key-subcommands
Jun 13, 2026
Merged

docs: add docs for "key add", "key list" and "key remove"#9769
ThomasWaldmann merged 1 commit into
borgbackup:masterfrom
ThomasWaldmann:docs-key-subcommands

Conversation

@ThomasWaldmann

Copy link
Copy Markdown
Member

The multi-key feature (#9743) added the borg key add, borg key list and borg key remove subcommands but never wired up their documentation.

Changes

  • scripts/make.py: map key_add/key_list/key_remove to the key usage group, so build_man can locate their examples. Previously build_man aborted with FileNotFoundError: docs/usage/key_add.rst.
  • docs/usage/key.rst: include the three new generated snippets so the subcommands show up on the HTML key page.
  • Regenerated the affected docs:
    • new key_{add,list,remove}.rst.inc usage snippets
    • new borg-key-{add,list,remove}.1 man pages
    • borg-key.1 (SYNOPSIS + SEE ALSO now reference the new subcommands)

Docs-only; no code changes.

🤖 Generated with Claude Code

The multi-key feature (borgbackup#9743) added the "borg key add", "borg key list"
and "borg key remove" subcommands but never wired up their docs:

- scripts/make.py: map key_add/key_list/key_remove to the "key" usage
  group, so build_man can locate their examples (it previously aborted
  with FileNotFoundError: docs/usage/key_add.rst).
- docs/usage/key.rst: include the three new generated snippets so they
  show up on the HTML key page.
- regenerate the affected docs: new key_{add,list,remove}.rst.inc usage
  snippets, new borg-key-{add,list,remove}.1 man pages, and borg-key.1
  (SYNOPSIS + SEE ALSO now reference the new subcommands).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@codecov

codecov Bot commented Jun 13, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 84.85%. Comparing base (af0904f) to head (d5cd72b).
⚠️ Report is 8 commits behind head on master.
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #9769   +/-   ##
=======================================
  Coverage   84.85%   84.85%           
=======================================
  Files          92       92           
  Lines       15172    15172           
  Branches     2273     2273           
=======================================
  Hits        12874    12874           
  Misses       1593     1593           
  Partials      705      705           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

@ThomasWaldmann ThomasWaldmann merged commit 5e2da15 into borgbackup:master Jun 13, 2026
31 of 32 checks passed
@ThomasWaldmann ThomasWaldmann deleted the docs-key-subcommands branch June 13, 2026 21:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant