Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

#6231: Clarify where paths are relative to #7737

Open
wants to merge 10 commits into
base: master
Choose a base branch
from
Open

#6231: Clarify where paths are relative to #7737

Changes from 2 commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
0da1e34
Clarify where paths are relative to
jefft Jul 25, 2023
b2cf0df
Use 'absolute' in the absolute path
jefft Jul 25, 2023
0a38fd3
Merge branch 'master' of github.com:borgbackup/borg into docfix-6231
jefft Jul 25, 2023
c65f2cb
Further clarifications
jefft Jul 25, 2023
66037af
Typo
jefft Jul 25, 2023
b44193d
Simplify
jefft Jul 25, 2023
81b8a5a
Also mention that the matching pattern can be absolute
jefft Jul 25, 2023
a94a15f
Doc clarifications
jefft Jul 25, 2023
e00c125
Merge branch 'master' of github.com:borgbackup/borg into docfix-6231
jefft Jul 26, 2023
d8724c7
Reorder sentence
jefft Jul 26, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/usage/help.rst.inc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,12 +18,12 @@ unwanted ones. Patterns can be used
- for ``PATH`` arguments that explicitly support them.

Borg always stores all file paths normalized and relative to the
current recursion root. The recursion root is also named ``PATH`` in
Borg commands like `borg create` that do a file discovery, so do not
confuse the root with the ``PATH`` argument of e.g. `borg extract`.
first directory of the current recursion root. The recursion root is also named
``PATH`` in Borg commands like `borg create` that do a file discovery, so do
not confuse the root with the ``PATH`` argument of e.g. `borg extract`.

Starting with Borg 1.2, paths that are matched against patterns always
appear relative. If you give ``/absolute/`` as root, the paths going
appear relative. If you give ``/absolute/path/`` as root, the paths going
into the matcher will start with ``absolute/``.
If you give ``../../relative`` as root, the paths will be normalized
as ``relative/``.
Expand Down