mirror of
https://github.com/borgbackup/borg.git
synced 2026-10-12 02:11:36 +00:00
Thomas WaldmannandClaude Fable 5
39d0e27f56
Add an "environment" help topic (alias: "env") showing the documentation about the environment variables borg supports, like borg help already does for patterns, placeholders, compression and match-archives. The help topic is now the single source of that documentation: scripts/make.py build_usage generates docs/usage/general/environment.rst.inc from it (and skips it on the misc. help docs page, where it would duplicate the "General" chapter's section), and build_man already generates a borg-environment(1) man page from any help topic. The text was adapted a bit so that it renders well both via sphinx and via nanorst on the terminal: the list-table, note directive and hyperlink targets were replaced by constructs nanorst understands. nanorst: end a code block when a following line is less indented than the code block's contents (instead of the hardcoded "less than 4 spaces" rule), so code blocks nested inside definition lists do not swallow the text following them any more. Also, borg help <topic> now resolves :ref: references like the command epilogs already did. Co-Authored-By: Claude Fable 5 <[email protected]>