summaryrefslogtreecommitdiffabout
path: root/cgitrc.5.txt
authorJason A. Donenfeld <Jason@zx2c4.com>2010-07-29 17:47:50 (UTC)
committer Lars Hjemli <hjemli@gmail.com>2010-08-04 01:09:32 (UTC)
commit2e4a941626c240bc7858aa7564882c01f657f4e8 (patch) (unidiff)
tree505c17fab5afcb99cfddf2c4aad0b95c8670f001 /cgitrc.5.txt
parent3516502aa0df95ecc241caa30161741f59e4e600 (diff)
downloadcgit-2e4a941626c240bc7858aa7564882c01f657f4e8.zip
cgit-2e4a941626c240bc7858aa7564882c01f657f4e8.tar.gz
cgit-2e4a941626c240bc7858aa7564882c01f657f4e8.tar.bz2
Add support for 'remove-suffix' option
When this option is enabled, the '.git' suffix of repository directories found while processing the 'scan-path' option will be removed. Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com> Signed-off-by: Lars Hjemli <hjemli@gmail.com>
Diffstat (limited to 'cgitrc.5.txt') (more/less context) (ignore whitespace changes)
-rw-r--r--cgitrc.5.txt6
1 files changed, 6 insertions, 0 deletions
diff --git a/cgitrc.5.txt b/cgitrc.5.txt
index ec004d4..6fb1083 100644
--- a/cgitrc.5.txt
+++ b/cgitrc.5.txt
@@ -168,128 +168,133 @@ logo::
168 on all cgit pages. Default value: "/cgit.png". 168 on all cgit pages. Default value: "/cgit.png".
169 169
170logo-link:: 170logo-link::
171 Url loaded when clicking on the cgit logo image. If unspecified the 171 Url loaded when clicking on the cgit logo image. If unspecified the
172 calculated url of the repository index page will be used. Default 172 calculated url of the repository index page will be used. Default
173 value: none. 173 value: none.
174 174
175max-atom-items:: 175max-atom-items::
176 Specifies the number of items to display in atom feeds view. Default 176 Specifies the number of items to display in atom feeds view. Default
177 value: "10". 177 value: "10".
178 178
179max-commit-count:: 179max-commit-count::
180 Specifies the number of entries to list per page in "log" view. Default 180 Specifies the number of entries to list per page in "log" view. Default
181 value: "50". 181 value: "50".
182 182
183max-message-length:: 183max-message-length::
184 Specifies the maximum number of commit message characters to display in 184 Specifies the maximum number of commit message characters to display in
185 "log" view. Default value: "80". 185 "log" view. Default value: "80".
186 186
187max-repo-count:: 187max-repo-count::
188 Specifies the number of entries to list per page on therepository 188 Specifies the number of entries to list per page on therepository
189 index page. Default value: "50". 189 index page. Default value: "50".
190 190
191max-repodesc-length:: 191max-repodesc-length::
192 Specifies the maximum number of repo description characters to display 192 Specifies the maximum number of repo description characters to display
193 on the repository index page. Default value: "80". 193 on the repository index page. Default value: "80".
194 194
195max-blob-size:: 195max-blob-size::
196 Specifies the maximum size of a blob to display HTML for in KBytes. 196 Specifies the maximum size of a blob to display HTML for in KBytes.
197 Default value: "0" (limit disabled). 197 Default value: "0" (limit disabled).
198 198
199max-stats:: 199max-stats::
200 Set the default maximum statistics period. Valid values are "week", 200 Set the default maximum statistics period. Valid values are "week",
201 "month", "quarter" and "year". If unspecified, statistics are 201 "month", "quarter" and "year". If unspecified, statistics are
202 disabled. Default value: none. See also: "repo.max-stats". 202 disabled. Default value: none. See also: "repo.max-stats".
203 203
204mimetype.<ext>:: 204mimetype.<ext>::
205 Set the mimetype for the specified filename extension. This is used 205 Set the mimetype for the specified filename extension. This is used
206 by the `plain` command when returning blob content. 206 by the `plain` command when returning blob content.
207 207
208module-link:: 208module-link::
209 Text which will be used as the formatstring for a hyperlink when a 209 Text which will be used as the formatstring for a hyperlink when a
210 submodule is printed in a directory listing. The arguments for the 210 submodule is printed in a directory listing. The arguments for the
211 formatstring are the path and SHA1 of the submodule commit. Default 211 formatstring are the path and SHA1 of the submodule commit. Default
212 value: "./?repo=%s&page=commit&id=%s" 212 value: "./?repo=%s&page=commit&id=%s"
213 213
214nocache:: 214nocache::
215 If set to the value "1" caching will be disabled. This settings is 215 If set to the value "1" caching will be disabled. This settings is
216 deprecated, and will not be honored starting with cgit-1.0. Default 216 deprecated, and will not be honored starting with cgit-1.0. Default
217 value: "0". 217 value: "0".
218 218
219noplainemail:: 219noplainemail::
220 If set to "1" showing full author email adresses will be disabled. 220 If set to "1" showing full author email adresses will be disabled.
221 Default value: "0". 221 Default value: "0".
222 222
223noheader:: 223noheader::
224 Flag which, when set to "1", will make cgit omit the standard header 224 Flag which, when set to "1", will make cgit omit the standard header
225 on all pages. Default value: none. See also: "embedded". 225 on all pages. Default value: none. See also: "embedded".
226 226
227project-list:: 227project-list::
228 A list of subdirectories inside of scan-path, relative to it, that 228 A list of subdirectories inside of scan-path, relative to it, that
229 should loaded as git repositories. This must be defined prior to 229 should loaded as git repositories. This must be defined prior to
230 scan-path. Default value: none. See also: scan-path. 230 scan-path. Default value: none. See also: scan-path.
231 231
232remove-suffix::
233 If set to "1" and scan-path is enabled, if any repositories are found
234 with a suffix of ".git", this suffix will be removed for the url and
235 name. Default value: "0". See also: scan-path.
236
232renamelimit:: 237renamelimit::
233 Maximum number of files to consider when detecting renames. The value 238 Maximum number of files to consider when detecting renames. The value
234 "-1" uses the compiletime value in git (for further info, look at 239 "-1" uses the compiletime value in git (for further info, look at
235 `man git-diff`). Default value: "-1". 240 `man git-diff`). Default value: "-1".
236 241
237repo.group:: 242repo.group::
238 Legacy alias for "section". This option is deprecated and will not be 243 Legacy alias for "section". This option is deprecated and will not be
239 supported in cgit-1.0. 244 supported in cgit-1.0.
240 245
241robots:: 246robots::
242 Text used as content for the "robots" meta-tag. Default value: 247 Text used as content for the "robots" meta-tag. Default value:
243 "index, nofollow". 248 "index, nofollow".
244 249
245root-desc:: 250root-desc::
246 Text printed below the heading on the repository index page. Default 251 Text printed below the heading on the repository index page. Default
247 value: "a fast webinterface for the git dscm". 252 value: "a fast webinterface for the git dscm".
248 253
249root-readme:: 254root-readme::
250 The content of the file specified with this option will be included 255 The content of the file specified with this option will be included
251 verbatim below the "about" link on the repository index page. Default 256 verbatim below the "about" link on the repository index page. Default
252 value: none. 257 value: none.
253 258
254root-title:: 259root-title::
255 Text printed as heading on the repository index page. Default value: 260 Text printed as heading on the repository index page. Default value:
256 "Git Repository Browser". 261 "Git Repository Browser".
257 262
258scan-path:: 263scan-path::
259 A path which will be scanned for repositories. If caching is enabled, 264 A path which will be scanned for repositories. If caching is enabled,
260 the result will be cached as a cgitrc include-file in the cache 265 the result will be cached as a cgitrc include-file in the cache
261 directory. If project-list has been defined prior to scan-path, 266 directory. If project-list has been defined prior to scan-path,
262 scan-path loads only the directories listed in the file pointed to by 267 scan-path loads only the directories listed in the file pointed to by
263 project-list. Default value: none. See also: cache-scanrc-ttl, 268 project-list. Default value: none. See also: cache-scanrc-ttl,
264 project-list. 269 project-list.
265 270
266section:: 271section::
267 The name of the current repository section - all repositories defined 272 The name of the current repository section - all repositories defined
268 after this option will inherit the current section name. Default value: 273 after this option will inherit the current section name. Default value:
269 none. 274 none.
270 275
271side-by-side-diffs:: 276side-by-side-diffs::
272 If set to "1" shows side-by-side diffs instead of unidiffs per 277 If set to "1" shows side-by-side diffs instead of unidiffs per
273 default. Default value: "0". 278 default. Default value: "0".
274 279
275snapshots:: 280snapshots::
276 Text which specifies the default set of snapshot formats generated by 281 Text which specifies the default set of snapshot formats generated by
277 cgit. The value is a space-separated list of zero or more of the 282 cgit. The value is a space-separated list of zero or more of the
278 values "tar", "tar.gz", "tar.bz2" and "zip". Default value: none. 283 values "tar", "tar.gz", "tar.bz2" and "zip". Default value: none.
279 284
280source-filter:: 285source-filter::
281 Specifies a command which will be invoked to format plaintext blobs 286 Specifies a command which will be invoked to format plaintext blobs
282 in the tree view. The command will get the blob content on its STDIN 287 in the tree view. The command will get the blob content on its STDIN
283 and the name of the blob as its only command line argument. The STDOUT 288 and the name of the blob as its only command line argument. The STDOUT
284 from the command will be included verbatim as the blob contents, i.e. 289 from the command will be included verbatim as the blob contents, i.e.
285 this can be used to implement e.g. syntax highlighting. Default value: 290 this can be used to implement e.g. syntax highlighting. Default value:
286 none. 291 none.
287 292
288summary-branches:: 293summary-branches::
289 Specifies the number of branches to display in the repository "summary" 294 Specifies the number of branches to display in the repository "summary"
290 view. Default value: "10". 295 view. Default value: "10".
291 296
292summary-log:: 297summary-log::
293 Specifies the number of log entries to display in the repository 298 Specifies the number of log entries to display in the repository
294 "summary" view. Default value: "10". 299 "summary" view. Default value: "10".
295 300
@@ -477,64 +482,65 @@ repo.desc=the master foo repository
477repo.owner=fooman@foobar.com 482repo.owner=fooman@foobar.com
478repo.readme=info/web/about.html 483repo.readme=info/web/about.html
479 484
480 485
481repo.url=bar 486repo.url=bar
482repo.path=/pub/git/bar.git 487repo.path=/pub/git/bar.git
483repo.desc=the bars for your foo 488repo.desc=the bars for your foo
484repo.owner=barman@foobar.com 489repo.owner=barman@foobar.com
485repo.readme=info/web/about.html 490repo.readme=info/web/about.html
486 491
487 492
488# The next repositories will be displayed under the 'extras' heading 493# The next repositories will be displayed under the 'extras' heading
489section=extras 494section=extras
490 495
491 496
492repo.url=baz 497repo.url=baz
493repo.path=/pub/git/baz.git 498repo.path=/pub/git/baz.git
494repo.desc=a set of extensions for bar users 499repo.desc=a set of extensions for bar users
495 500
496repo.url=wiz 501repo.url=wiz
497repo.path=/pub/git/wiz.git 502repo.path=/pub/git/wiz.git
498repo.desc=the wizard of foo 503repo.desc=the wizard of foo
499 504
500 505
501# Add some mirrored repositories 506# Add some mirrored repositories
502section=mirrors 507section=mirrors
503 508
504 509
505repo.url=git 510repo.url=git
506repo.path=/pub/git/git.git 511repo.path=/pub/git/git.git
507repo.desc=the dscm 512repo.desc=the dscm
508 513
509 514
510repo.url=linux 515repo.url=linux
511repo.path=/pub/git/linux.git 516repo.path=/pub/git/linux.git
512repo.desc=the kernel 517repo.desc=the kernel
513 518
514# Disable adhoc downloads of this repo 519# Disable adhoc downloads of this repo
515repo.snapshots=0 520repo.snapshots=0
516 521
517# Disable line-counts for this repo 522# Disable line-counts for this repo
518repo.enable-log-linecount=0 523repo.enable-log-linecount=0
519 524
520# Restrict the max statistics period for this repo 525# Restrict the max statistics period for this repo
521repo.max-stats=month 526repo.max-stats=month
522.... 527....
523 528
524 529
525BUGS 530BUGS
526---- 531----
527Comments currently cannot appear on the same line as a setting; the comment 532Comments currently cannot appear on the same line as a setting; the comment
528will be included as part of the value. E.g. this line: 533will be included as part of the value. E.g. this line:
529 534
530 robots=index # allow indexing 535 robots=index # allow indexing
531 536
532will generate the following html element: 537will generate the following html element:
533 538
534 <meta name='robots' content='index # allow indexing'/> 539 <meta name='robots' content='index # allow indexing'/>
535 540
536 541
537 542
538AUTHOR 543AUTHOR
539------ 544------
540Lars Hjemli <hjemli@gmail.com> 545Lars Hjemli <hjemli@gmail.com>
546Jason A. Donenfeld <Jason@zx2c4.com>