diff options
author | Hiltjo Posthuma <[email protected]> | 2017-10-31 23:25:35 +0100 |
---|---|---|
committer | Hiltjo Posthuma <[email protected]> | 2017-10-31 23:25:35 +0100 |
commit | 2a5669514088684bc9bfe1fddb5e353fb07ae6d6 (patch) | |
tree | ce587d5528643029e8c50cc9843d831fab4967fc /README | |
parent | cfbf4a11adc8c2e3b55724e7341b18b21fc5b6f7 (diff) | |
download | stagit-2a5669514088684bc9bfe1fddb5e353fb07ae6d6.tar.gz stagit-2a5669514088684bc9bfe1fddb5e353fb07ae6d6.zip |
README: clarify some cons
Diffstat (limited to 'README')
-rw-r--r-- | README | 21 |
1 files changed, 15 insertions, 6 deletions
@@ -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. |