borg/docs/usage/general/repository-locations.rst.inc

Repository / Archive Locations
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Many commands want either a repository (just give the repo URL, see above) or
an archive location, which is a repo URL followed by ``::archive_name``.

Archive names must not contain the ``/`` (slash) character. For simplicity,
maybe also avoid blanks or other characters that have special meaning on the
shell or in a filesystem (borg mount will use the archive name as directory
name).

If you have set BORG_REPO (see above) and an archive location is needed, use
``::archive_name`` - the repo URL part is then read from BORG_REPO.
[DOCS] #4587 – Make Sphinx warnings break docs build general.rst and man_intro.rst both included usage_general.rst.inc, which resulted in three Sphinx warning "WARNING: duplicate label". To prevent this we move all sections of usage_general into own include files and add a second usage_general file without the three labels. 2020-03-16 18:17:16 +00:00			`Repository / Archive Locations`
			`~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~`

			`Many commands want either a repository (just give the repo URL, see above) or`
			an archive location, which is a repo URL followed by ``::archive_name``.

			Archive names must not contain the ``/`` (slash) character. For simplicity,
			`maybe also avoid blanks or other characters that have special meaning on the`
			`shell or in a filesystem (borg mount will use the archive name as directory`
			`name).`

			`If you have set BORG_REPO (see above) and an archive location is needed, use`
			``::archive_name`` - the repo URL part is then read from BORG_REPO.