Skip to content

Commit e3367e4

Browse files
LemmingAvalanchettaylorr
authored andcommitted
Documentation/git-bundle.txt: discuss naïve backups
It might be naïve to think that those who need this education would end up here in the first place. But I think it’s good to mention this high-level concept here on a command which provides a backup strategy. Signed-off-by: Kristoffer Haugsbakk <[email protected]> Signed-off-by: Taylor Blau <[email protected]>
1 parent 18e96b6 commit e3367e4

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

Documentation/git-bundle.txt

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -324,6 +324,20 @@ You can also see what references it offers:
324324
$ git ls-remote mybundle
325325
----------------
326326

327+
DISCUSSION
328+
----------
329+
330+
A naive way to make a full backup of a repository is to use something to
331+
the effect of `cp -a <repo> <destination>`. This is discouraged since
332+
the repository could be written to during the copy operation. In turn
333+
some files at `<destination>` could be corrupted.
334+
335+
This is why it is recommended to use Git tooling for making repository
336+
backups, either with this command or with e.g. linkgit:git-clone[1].
337+
338+
See also linkgit:gitfaq[1], section "TRANSFERS" for a discussion of the
339+
problems associated with file syncing across systems.
340+
327341
FILE FORMAT
328342
-----------
329343

0 commit comments

Comments
 (0)