|
|
README: clarify some cons - stagit - static git page generator |
|
|
 |
git clone git://git.codemadness.org/stagit (git://git.codemadness.org) |
|
|
 |
Log |
|
|
|
Files |
|
|
|
Refs |
|
|
|
README |
|
|
|
LICENSE |
|
|
|
--- |
|
|
|
commit 2a5669514088684bc9bfe1fddb5e353fb07ae6d6 |
|
|
|
parent cfbf4a11adc8c2e3b55724e7341b18b21fc5b6f7 |
|
|
|
Author: Hiltjo Posthuma <hiltjo@codemadness.org> (mailto://) |
application/vnd.lotus-organizer |
|
|
Date: Tue, 31 Oct 2017 23:25:35 +0100 |
|
|
|
|
|
|
|
README: clarify some cons |
|
|
|
|
|
|
|
Diffstat: |
|
|
|
M README | 21 +++++++++++++++------ |
|
|
|
|
|
|
|
1 file changed, 15 insertions(+), 6 deletions(-) |
|
|
|
--- |
|
|
|
diff --git 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. |
|