From a717d50684c39b1cffc3484131fd0bc238ec6006 Mon Sep 17 00:00:00 2001 From: James Moger Date: Wed, 21 Mar 2012 21:33:54 -0400 Subject: [PATCH] Documentation --- docs/01_setup.mkd | 37 ++++++++++++++++++++++++++++--------- 1 file changed, 28 insertions(+), 9 deletions(-) diff --git a/docs/01_setup.mkd b/docs/01_setup.mkd index 51921e02..09ddabbd 100644 --- a/docs/01_setup.mkd +++ b/docs/01_setup.mkd @@ -148,7 +148,7 @@ ProxyPreserveHost On #ProxyPassreverse /gitblit http://localhost:8080/gitblit # If your httpd frontend is https but you are proxying http Gitblit WAR or GO -#Header edit Location ^http://([^/]+)/gitblit/ https://$1/gitblit/ +#Header edit Location ^http://([^⁄]+)/gitblit/ https://$1/gitblit/ #ProxyPass /gitblit ajp://localhost:8009/gitblit %ENDCODE% @@ -376,18 +376,37 @@ Care should be taken when devising your notification scheme as it relates to any *SINCE 0.9.0* -Repositories may optionally be indexed using the Lucene search engine. Lucene indexing is an opt-in feature which means that no repositories are automatically indexed. Like anything else, this has benefits and drawbacks. +Repositories may optionally be indexed using the Lucene search engine. The Lucene search offers several advantages over commit-traversal search: -You may specify which branches should be indexed per-repository in the *Edit Repository* page. New/empty repositories can not pre-specify indexed branches; you can only specify indexed branches for a repository with commits. Indexes are built and incrementally updated on a 2 minute cycle so you may have to wait a few minutes before your index is built or before your latest pushes get indexed. +1. very fast commit and blob searches +2. multi-term searches +3. term-highlighted and syntax-highlighted fragment matches +4. multi-repository searches -**NOTE:** -Repositories that specify indexed branches will redirect to the Lucene search page from the search box in the upper right corner of a repository page. Repositories that do not specify any indexed branches will use the traditional commit search. +### How do I use it? + +Lucene indexing is an opt-in feature which means that no repositories are automatically indexed. +Like anything else, this design has pros and cons. + +#### Pros +1. no wasted cycles on repositories you will never search +2. you specify exactly what branches are indexed; experimental/dead/personal branches can be ignored + +#### Cons +1. you have to opt-in a repository _after_ it is created and has some commits +2. you specify exactly what branches are indexed -The Lucene search offers several advantages over the traditional commit search: +#### Why does Gitblit check every 2 mins for repository/branch changes? -1. multi-term searches -2. term-highlighted and syntax-highlighted fragment matches -3. multi-repository searches +Gitblit has to balance its design as a complete, integrated Git server and its utility as a repository viewer in an existing Git setup. + +Gitblit could build indexes immediately on *edit repository* or on *receiving pushes*, but that design would not work if someone is pushing via ssh://, git://, or file:// (i.e. not pushing to Gitblit http(s)://). For this reason Gitblit has a polling mechanism to check for ref changes every 2 mins. This design works well for all use cases, aside from adding a little lag in updating the index. + +#### Indexing Branches +You may specify which branches should be indexed per-repository in the *Edit Repository* page. New/empty repositories can not pre-specify indexed branches; you can only specify indexed branches for a repository with commits. Indexes are built and incrementally updated on a 2 minute cycle so you may have to wait a few minutes before your index is built or before your latest pushes get indexed. + +**NOTE:** +After specifying branches, only the content from those branches can be searched via Gitblit. Gitblit will automatically redirect any queries entered on a repository's search box to the Lucene search page. Repositories that do not specify any indexed branches will use the traditional commit-traversal search. ## Client Setup and Configuration ### Https with Self-Signed Certificates -- 2.39.5