diff options
| -rw-r--r-- | faq.7 | 58 |
1 files changed, 58 insertions, 0 deletions
diff --git a/faq.7 b/faq.7 new file mode 100644 index 0000000..6bda5de --- /dev/null +++ b/faq.7 @@ -0,0 +1,58 @@ +.Dd February 13, 2022 +.Dt FAQ 7 +.Os "Causal Agency" +. +.Sh Frequently Asked Questions +This is a compilation of +frequently asked questions +on the cgit mailing list. +. +.Ss Why doesn't cgit find/show my repo? +This is most likely +due to permission problems: +cgit runs under your webserver user account +and will need read access to your repo +(and all of the parent directories). +. +.Ss Why does cgit complain that my repo is not a git repository? +The most common cause of this +is permission problems \(em +see the previous FAQ entry. +.Pp +The second most common cause +is that you've set +.Cm repo.path +to point at the working-directory +of your git repo \(em +it should point at the +.Ev $GITDIR , +i.e. the +.Pa .git +directory. +.Pp +A less likely cause is that the repo is, +in fact, +not a valid repo. +Try to run +.Ql git show +in the offending repo +to see if git also thinks +your repo has issues. +. +.Ss Why is the idle time for my repository wrong? +By default cgit uses the modification time +of the default branch's ref file +as a quick method of determining +when the repository was last changed. +If you primarily work on other branches +then this work will not be reflected +in the idle time. +.Pp +You can use a post-receive hook +to run a script that tells cgit +the correct modification time +by writing to +.Pa info/web/last-modified . +An example is provided +in the cgit repository at +.Pa contrib/hooks/post-receive.agefile . |