Document relative path usage #1868

This commit is contained in:
kmq 2017-02-26 20:33:15 +02:00
parent 9f07d13c4a
commit 96ebb096e9
No known key found for this signature in database
GPG Key ID: 51B2ECDB459EDD45
2 changed files with 11 additions and 4 deletions

View File

@ -1355,9 +1355,12 @@ class Archiver:
create_epilog = textwrap.dedent(""" create_epilog = textwrap.dedent("""
This command creates a backup archive containing all files found while recursively This command creates a backup archive containing all files found while recursively
traversing all paths specified. When giving '-' as path, borg will read data traversing all paths specified. Paths are added to the archive as they are given,
from standard input and create a file 'stdin' in the created archive from that that means if relative paths are desired, the command has to be run from the correct
data. directory.
When giving '-' as path, borg will read data from standard input and create a
file 'stdin' in the created archive from that data.
The archive will consume almost no disk space for files or parts of files that The archive will consume almost no disk space for files or parts of files that
have already been stored in other archives. have already been stored in other archives.

View File

@ -435,6 +435,11 @@ Examples
# As above, but add nanoseconds # As above, but add nanoseconds
$ borg create /path/to/repo::{hostname}-{user}-{now:%Y-%m-%dT%H:%M:%S.%f} ~ $ borg create /path/to/repo::{hostname}-{user}-{now:%Y-%m-%dT%H:%M:%S.%f} ~
# Backing up relative paths by moving into the correct directory first
$ cd /home/user/Documents
# The root directory of the archive will be "projectA"
$ borg create /path/to/repo::daily-projectA-{now:%Y-%m-%d} projectA
Notes Notes
~~~~~ ~~~~~
@ -443,7 +448,6 @@ Notes
'\*/.bundler/gems' to get the same effect. See ``borg help patterns`` for '\*/.bundler/gems' to get the same effect. See ``borg help patterns`` for
more information. more information.
.. include:: usage/extract.rst.inc .. include:: usage/extract.rst.inc
Examples Examples