aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLars Hjemli <hjemli@gmail.com>2011-06-18 16:01:25 +0200
committerLars Hjemli <hjemli@gmail.com>2011-06-18 16:11:55 +0200
commit344189a984f25894594c55c6eeb348b0604d23eb (patch)
tree7f9fa41c6a426e17fa15a4988ea554b6aa64b29f
parentdc6f7a345acceefa6b74e91bcf8b46f3d8245c71 (diff)
faq: prettify it
Signed-off-by: Lars Hjemli <hjemli@gmail.com>
-rw-r--r--faq36
1 files 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.