Skip to content

Commit c4ac5fa

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 4f68a40 commit c4ac5fa

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
@@ -319,6 +319,20 @@ You can also see what references it offers:
319319
$ git ls-remote mybundle
320320
----------------
321321

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

0 commit comments

Comments
 (0)