diff options
author | Sean Whitton <spwhitton@spwhitton.name> | 2022-08-21 09:16:46 -0700 |
---|---|---|
committer | Sean Whitton <spwhitton@spwhitton.name> | 2022-08-21 09:16:46 -0700 |
commit | 5404e49fc73a198bd3ed870b31ae8bebb9a46780 (patch) | |
tree | c13df00047f9c2f99c1a6b2abd90c033a733cad4 /README.rst | |
parent | bba438fff4e35fb2008c9efeba26d40985294422 (diff) | |
download | git-remote-gcrypt-5404e49fc73a198bd3ed870b31ae8bebb9a46780.tar.gz |
use stronger language regarding gitception/sftp vs. local/rsync
Signed-off-by: Sean Whitton <spwhitton@spwhitton.name>
Diffstat (limited to 'README.rst')
-rw-r--r-- | README.rst | 21 |
1 files changed, 14 insertions, 7 deletions
@@ -18,8 +18,8 @@ helper handles URIs prefixed with `gcrypt::`. Supported backends are `local`, `rsync://` and `sftp://`, where the repository is stored as a set of files, or instead any `<giturl>` where gcrypt will store the same representation in a git repository, -bridged over arbitrary git transport. See "Performance" below for -backends comparison. +bridged over arbitrary git transport. Prefer `local` or `rsync://` if +you can use one of those; see "Performance" below for discussion. There is also an experimental `rclone://` backend for early adoptors only (you have been warned). @@ -156,11 +156,18 @@ Remote ID Performance Using an arbitrary `<giturl>` or an `sftp://` URI requires - uploading the entire repository history with each push. If your - repository history is large or you are pushing over a slow link, - consider using the `rsync://` transport, which performs - incremental pushes. Note that the latter won't work with a - repository hosting service like Gitolite, GitHub or GitLab. + uploading the entire repository history with each push. This + means that pushes of your repository become slower over time, as + your git history becomes longer, and it can easily get to the + point that continued usage of git-remote-gcrypt is impractical. + + Thus, you should use these backends only when you know that your + repository will not ever grow very large, not just that it's not + large now. This means that these backends are inappropriate for + most repositories, and likely suitable only for unusual cases, + such as small credential stores. Even then, use `rsync://` if you + can. Note, however, that `rsync://` won't work with a repository + hosting service like Gitolite, GitHub or GitLab. rsync URIs The URI format for the rsync backend is ``rsync://user@host/path``, |