From 344189a984f25894594c55c6eeb348b0604d23eb Mon Sep 17 00:00:00 2001 From: Lars Hjemli Date: Sat, 18 Jun 2011 16:01:25 +0200 Subject: faq: prettify it Signed-off-by: Lars Hjemli --- faq | 36 +++++++++++++++++++++--------------- 1 file changed, 21 insertions(+), 15 deletions(-) diff --git a/faq b/faq index 3fb623d..3dbb545 100644 --- a/faq +++ b/faq @@ -1,22 +1,28 @@ Frequently Asked Questions -========================== +-------------------------- -* I'm using the "scan-path" option, but cgit doesn't find my repo +This is a compilation of frequently asked questions on the cgit mailing +list. If you've got a cgit problem and cannot find an answer here, please +send a request to cgit@hjemli.net (and consider sending a patch to the +cgit wiki branch to update this faq if you get a nice answer to your +question). - * This is most likely due to permission problems: cgit usually runs under - your webserver user account and will need read access to your repo (and - all of the parent directories) +### Why doesn't cgit find/show my repo? -* My repo shows up in the list of repositories, but when clicking the - repo name, cgit complains that it's "Not a git repository" +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) - * The most common cause of this is permission problems - see the previous - faq entry for more details. - * The second most common cause is that you've set repo.path to point - at the working-directory of your git repo - it should point at the - $GITDIR, i.e. the .git directory. +### Why does cgit complain that my repo is "Not a git repository"? - * A less likely cause is that the repo is, infact, not a valid repo. Try - to run a 'git show' in the offending repo to see if git also reports - about problems. +The most common cause of this is permission problems - see the previous +faq entry for more details. + +The second most common cause is that you've set repo.path to point at the +working-directory of your git repo - it should point at the $GITDIR, i.e. +the .git directory. + +A less likely cause is that the repo is, infact, not a valid repo. Try +to run 'git show' in the offending repo to see if git also thinks your +repo has issues. -- cgit v1.2.3-56-ge451