aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorHiltjo Posthuma <[email protected]>2017-10-31 23:25:35 +0100
committerHiltjo Posthuma <[email protected]>2017-10-31 23:25:35 +0100
commit2a5669514088684bc9bfe1fddb5e353fb07ae6d6 (patch)
treece587d5528643029e8c50cc9843d831fab4967fc /README
parentcfbf4a11adc8c2e3b55724e7341b18b21fc5b6f7 (diff)
downloadstagit-2a5669514088684bc9bfe1fddb5e353fb07ae6d6.tar.gz
stagit-2a5669514088684bc9bfe1fddb5e353fb07ae6d6.zip
README: clarify some cons
Diffstat (limited to 'README')
-rw-r--r--README21
1 files changed, 15 insertions, 6 deletions
diff --git a/README b/README
index c3eea1a..d916cc8 100644
--- a/README
+++ b/README
@@ -149,15 +149,24 @@ Cons
----
- Not suitable for large repositories (2000+ commits), because diffstats are
- an expensive operation.
+ an expensive operation, the cache (-c flag) is a workaround for this in
+ some cases.
+- Not suitable for large repositories with many files, because all files are
+ written for each execution of stagit. This is because stagit shows the lines
+ of textfiles and there is no "cache" for file metadata (this would add more
+ complexity to the code).
- Not suitable for repositories with many branches, a quite linear history is
assumed (from HEAD).
+
+ In these cases it is better to just use cgit or possibly change stagit to
+ run as a CGI program.
+
- Relatively slow to run the first time (about 3 seconds for sbase,
1500+ commits), incremental updates are faster.
- Does not support some of the dynamic features cgit has, like:
- - snapshot tarballs.
- - file tree per commit.
- - history log of branches diverged from HEAD.
- - stats (git shortlog -s).
+ - Snapshot tarballs per commit.
+ - File tree per commit.
+ - History log of branches diverged from HEAD.
+ - Stats (git shortlog -s).
- this is by design, just use git locally.
+ This is by design, just use git locally.