-rw-r--r-- | cgitrc.5.txt | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/cgitrc.5.txt b/cgitrc.5.txt index 187031a..ce78d41 100644 --- a/cgitrc.5.txt +++ b/cgitrc.5.txt | |||
@@ -237,96 +237,102 @@ project-list:: | |||
237 | readme:: | 237 | readme:: |
238 | Text which will be used as default value for "repo.readme". Default | 238 | Text which will be used as default value for "repo.readme". Default |
239 | value: none. | 239 | value: none. |
240 | 240 | ||
241 | remove-suffix:: | 241 | remove-suffix:: |
242 | If set to "1" and scan-path is enabled, if any repositories are found | 242 | If set to "1" and scan-path is enabled, if any repositories are found |
243 | with a suffix of ".git", this suffix will be removed for the url and | 243 | with a suffix of ".git", this suffix will be removed for the url and |
244 | name. Default value: "0". See also: scan-path. | 244 | name. Default value: "0". See also: scan-path. |
245 | 245 | ||
246 | renamelimit:: | 246 | renamelimit:: |
247 | Maximum number of files to consider when detecting renames. The value | 247 | Maximum number of files to consider when detecting renames. The value |
248 | "-1" uses the compiletime value in git (for further info, look at | 248 | "-1" uses the compiletime value in git (for further info, look at |
249 | `man git-diff`). Default value: "-1". | 249 | `man git-diff`). Default value: "-1". |
250 | 250 | ||
251 | repo.group:: | 251 | repo.group:: |
252 | Legacy alias for "section". This option is deprecated and will not be | 252 | Legacy alias for "section". This option is deprecated and will not be |
253 | supported in cgit-1.0. | 253 | supported in cgit-1.0. |
254 | 254 | ||
255 | robots:: | 255 | robots:: |
256 | Text used as content for the "robots" meta-tag. Default value: | 256 | Text used as content for the "robots" meta-tag. Default value: |
257 | "index, nofollow". | 257 | "index, nofollow". |
258 | 258 | ||
259 | root-desc:: | 259 | root-desc:: |
260 | Text printed below the heading on the repository index page. Default | 260 | Text printed below the heading on the repository index page. Default |
261 | value: "a fast webinterface for the git dscm". | 261 | value: "a fast webinterface for the git dscm". |
262 | 262 | ||
263 | root-readme:: | 263 | root-readme:: |
264 | The content of the file specified with this option will be included | 264 | The content of the file specified with this option will be included |
265 | verbatim below the "about" link on the repository index page. Default | 265 | verbatim below the "about" link on the repository index page. Default |
266 | value: none. | 266 | value: none. |
267 | 267 | ||
268 | root-title:: | 268 | root-title:: |
269 | Text printed as heading on the repository index page. Default value: | 269 | Text printed as heading on the repository index page. Default value: |
270 | "Git Repository Browser". | 270 | "Git Repository Browser". |
271 | 271 | ||
272 | scan-path:: | 272 | scan-path:: |
273 | A path which will be scanned for repositories. If caching is enabled, | 273 | A path which will be scanned for repositories. If caching is enabled, |
274 | the result will be cached as a cgitrc include-file in the cache | 274 | the result will be cached as a cgitrc include-file in the cache |
275 | directory. If project-list has been defined prior to scan-path, | 275 | directory. If project-list has been defined prior to scan-path, |
276 | scan-path loads only the directories listed in the file pointed to by | 276 | scan-path loads only the directories listed in the file pointed to by |
277 | project-list. Default value: none. See also: cache-scanrc-ttl, | 277 | project-list. Default value: none. See also: cache-scanrc-ttl, |
278 | project-list. | 278 | project-list. |
279 | 279 | ||
280 | section:: | 280 | section:: |
281 | The name of the current repository section - all repositories defined | 281 | The name of the current repository section - all repositories defined |
282 | after this option will inherit the current section name. Default value: | 282 | after this option will inherit the current section name. Default value: |
283 | none. | 283 | none. |
284 | 284 | ||
285 | section-from-path:: | ||
286 | A number which, if specified before scan-path, specifies how many | ||
287 | path elements from each repo path to use as a default section name. | ||
288 | If negative, cgit will discard the specified number of path elements | ||
289 | above the repo directory. Default value: 0. | ||
290 | |||
285 | side-by-side-diffs:: | 291 | side-by-side-diffs:: |
286 | If set to "1" shows side-by-side diffs instead of unidiffs per | 292 | If set to "1" shows side-by-side diffs instead of unidiffs per |
287 | default. Default value: "0". | 293 | default. Default value: "0". |
288 | 294 | ||
289 | snapshots:: | 295 | snapshots:: |
290 | Text which specifies the default set of snapshot formats generated by | 296 | Text which specifies the default set of snapshot formats generated by |
291 | cgit. The value is a space-separated list of zero or more of the | 297 | cgit. The value is a space-separated list of zero or more of the |
292 | values "tar", "tar.gz", "tar.bz2" and "zip". Default value: none. | 298 | values "tar", "tar.gz", "tar.bz2" and "zip". Default value: none. |
293 | 299 | ||
294 | source-filter:: | 300 | source-filter:: |
295 | Specifies a command which will be invoked to format plaintext blobs | 301 | Specifies a command which will be invoked to format plaintext blobs |
296 | in the tree view. The command will get the blob content on its STDIN | 302 | in the tree view. The command will get the blob content on its STDIN |
297 | and the name of the blob as its only command line argument. The STDOUT | 303 | and the name of the blob as its only command line argument. The STDOUT |
298 | from the command will be included verbatim as the blob contents, i.e. | 304 | from the command will be included verbatim as the blob contents, i.e. |
299 | this can be used to implement e.g. syntax highlighting. Default value: | 305 | this can be used to implement e.g. syntax highlighting. Default value: |
300 | none. | 306 | none. |
301 | 307 | ||
302 | summary-branches:: | 308 | summary-branches:: |
303 | Specifies the number of branches to display in the repository "summary" | 309 | Specifies the number of branches to display in the repository "summary" |
304 | view. Default value: "10". | 310 | view. Default value: "10". |
305 | 311 | ||
306 | summary-log:: | 312 | summary-log:: |
307 | Specifies the number of log entries to display in the repository | 313 | Specifies the number of log entries to display in the repository |
308 | "summary" view. Default value: "10". | 314 | "summary" view. Default value: "10". |
309 | 315 | ||
310 | summary-tags:: | 316 | summary-tags:: |
311 | Specifies the number of tags to display in the repository "summary" | 317 | Specifies the number of tags to display in the repository "summary" |
312 | view. Default value: "10". | 318 | view. Default value: "10". |
313 | 319 | ||
314 | virtual-root:: | 320 | virtual-root:: |
315 | Url which, if specified, will be used as root for all cgit links. It | 321 | Url which, if specified, will be used as root for all cgit links. It |
316 | will also cause cgit to generate 'virtual urls', i.e. urls like | 322 | will also cause cgit to generate 'virtual urls', i.e. urls like |
317 | '/cgit/tree/README' as opposed to '?r=cgit&p=tree&path=README'. Default | 323 | '/cgit/tree/README' as opposed to '?r=cgit&p=tree&path=README'. Default |
318 | value: none. | 324 | value: none. |
319 | NOTE: cgit has recently learned how to use PATH_INFO to achieve the | 325 | NOTE: cgit has recently learned how to use PATH_INFO to achieve the |
320 | same kind of virtual urls, so this option will probably be deprecated. | 326 | same kind of virtual urls, so this option will probably be deprecated. |
321 | 327 | ||
322 | REPOSITORY SETTINGS | 328 | REPOSITORY SETTINGS |
323 | ------------------- | 329 | ------------------- |
324 | repo.about-filter:: | 330 | repo.about-filter:: |
325 | Override the default about-filter. Default value: none. See also: | 331 | Override the default about-filter. Default value: none. See also: |
326 | "enable-filter-overrides". | 332 | "enable-filter-overrides". |
327 | 333 | ||
328 | repo.clone-url:: | 334 | repo.clone-url:: |
329 | A list of space-separated urls which can be used to clone this repo. | 335 | A list of space-separated urls which can be used to clone this repo. |
330 | Default value: none. | 336 | Default value: none. |
331 | 337 | ||
332 | repo.commit-filter:: | 338 | repo.commit-filter:: |