-rw-r--r-- | cgitrc.5.txt | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/cgitrc.5.txt b/cgitrc.5.txt index ab9ab66..09f56a6 100644 --- a/cgitrc.5.txt +++ b/cgitrc.5.txt | |||
@@ -120,24 +120,29 @@ max-commit-count | |||
120 | max-message-length | 120 | max-message-length |
121 | Specifies the maximum number of commit message characters to display in | 121 | Specifies the maximum number of commit message characters to display in |
122 | "log" view. Default value: "80". | 122 | "log" view. Default value: "80". |
123 | 123 | ||
124 | max-repo-count | 124 | max-repo-count |
125 | Specifies the number of entries to list per page on therepository | 125 | Specifies the number of entries to list per page on therepository |
126 | index page. Default value: "50". | 126 | index page. Default value: "50". |
127 | 127 | ||
128 | max-repodesc-length | 128 | max-repodesc-length |
129 | Specifies the maximum number of repo description characters to display | 129 | Specifies the maximum number of repo description characters to display |
130 | on the repository index page. Default value: "80". | 130 | on the repository index page. Default value: "80". |
131 | 131 | ||
132 | max-stats | ||
133 | Set the default maximum statistics period. Valid values are "week", | ||
134 | "month", "quarter" and "year". If unspecified, statistics are | ||
135 | disabled. Default value: none. See also: "repo.max-stats". | ||
136 | |||
132 | module-link | 137 | module-link |
133 | Text which will be used as the formatstring for a hyperlink when a | 138 | Text which will be used as the formatstring for a hyperlink when a |
134 | submodule is printed in a directory listing. The arguments for the | 139 | submodule is printed in a directory listing. The arguments for the |
135 | formatstring are the path and SHA1 of the submodule commit. Default | 140 | formatstring are the path and SHA1 of the submodule commit. Default |
136 | value: "./?repo=%s&page=commit&id=%s" | 141 | value: "./?repo=%s&page=commit&id=%s" |
137 | 142 | ||
138 | nocache | 143 | nocache |
139 | If set to the value "1" caching will be disabled. This settings is | 144 | If set to the value "1" caching will be disabled. This settings is |
140 | deprecated, and will not be honored starting with cgit-1.0. Default | 145 | deprecated, and will not be honored starting with cgit-1.0. Default |
141 | value: "0". | 146 | value: "0". |
142 | 147 | ||
143 | renamelimit | 148 | renamelimit |
@@ -209,24 +214,29 @@ repo.defbranch | |||
209 | 214 | ||
210 | repo.desc | 215 | repo.desc |
211 | The value to show as repository description. Default value: none. | 216 | The value to show as repository description. Default value: none. |
212 | 217 | ||
213 | repo.enable-log-filecount | 218 | repo.enable-log-filecount |
214 | A flag which can be used to disable the global setting | 219 | A flag which can be used to disable the global setting |
215 | `enable-log-filecount'. Default value: none. | 220 | `enable-log-filecount'. Default value: none. |
216 | 221 | ||
217 | repo.enable-log-linecount | 222 | repo.enable-log-linecount |
218 | A flag which can be used to disable the global setting | 223 | A flag which can be used to disable the global setting |
219 | `enable-log-linecount'. Default value: none. | 224 | `enable-log-linecount'. Default value: none. |
220 | 225 | ||
226 | repo.max-stats | ||
227 | Override the default maximum statistics period. Valid values are equal | ||
228 | to the values specified for the global "max-stats" setting. Default | ||
229 | value: none. | ||
230 | |||
221 | repo.name | 231 | repo.name |
222 | The value to show as repository name. Default value: <repo.url>. | 232 | The value to show as repository name. Default value: <repo.url>. |
223 | 233 | ||
224 | repo.owner | 234 | repo.owner |
225 | A value used to identify the owner of the repository. Default value: | 235 | A value used to identify the owner of the repository. Default value: |
226 | none. | 236 | none. |
227 | 237 | ||
228 | repo.path | 238 | repo.path |
229 | An absolute path to the repository directory. For non-bare repositories | 239 | An absolute path to the repository directory. For non-bare repositories |
230 | this is the .git-directory. Default value: none. | 240 | this is the .git-directory. Default value: none. |
231 | 241 | ||
232 | repo.readme | 242 | repo.readme |
@@ -267,24 +277,28 @@ enable-log-filecount=1 | |||
267 | # Show number of added/removed lines per commit on the log pages | 277 | # Show number of added/removed lines per commit on the log pages |
268 | enable-log-linecount=1 | 278 | enable-log-linecount=1 |
269 | 279 | ||
270 | 280 | ||
271 | # Add a cgit favicon | 281 | # Add a cgit favicon |
272 | favicon=/favicon.ico | 282 | favicon=/favicon.ico |
273 | 283 | ||
274 | 284 | ||
275 | # Use a custom logo | 285 | # Use a custom logo |
276 | logo=/img/mylogo.png | 286 | logo=/img/mylogo.png |
277 | 287 | ||
278 | 288 | ||
289 | # Enable statistics per week, month and quarter | ||
290 | max-stats=quarter | ||
291 | |||
292 | |||
279 | # Set the title and heading of the repository index page | 293 | # Set the title and heading of the repository index page |
280 | root-title=foobar.com git repositories | 294 | root-title=foobar.com git repositories |
281 | 295 | ||
282 | 296 | ||
283 | # Set a subheading for the repository index page | 297 | # Set a subheading for the repository index page |
284 | root-desc=tracking the foobar development | 298 | root-desc=tracking the foobar development |
285 | 299 | ||
286 | 300 | ||
287 | # Include some more info about foobar.com on the index page | 301 | # Include some more info about foobar.com on the index page |
288 | root-readme=/var/www/htdocs/about.html | 302 | root-readme=/var/www/htdocs/about.html |
289 | 303 | ||
290 | 304 | ||
@@ -339,24 +353,27 @@ repo.desc=the dscm | |||
339 | 353 | ||
340 | 354 | ||
341 | repo.url=linux | 355 | repo.url=linux |
342 | repo.path=/pub/git/linux.git | 356 | repo.path=/pub/git/linux.git |
343 | repo.desc=the kernel | 357 | repo.desc=the kernel |
344 | 358 | ||
345 | # Disable adhoc downloads of this repo | 359 | # Disable adhoc downloads of this repo |
346 | repo.snapshots=0 | 360 | repo.snapshots=0 |
347 | 361 | ||
348 | # Disable line-counts for this repo | 362 | # Disable line-counts for this repo |
349 | repo.enable-log-linecount=0 | 363 | repo.enable-log-linecount=0 |
350 | 364 | ||
365 | # Restrict the max statistics period for this repo | ||
366 | repo.max-stats=month | ||
367 | |||
351 | 368 | ||
352 | BUGS | 369 | BUGS |
353 | ---- | 370 | ---- |
354 | Comments currently cannot appear on the same line as a setting; the comment | 371 | Comments currently cannot appear on the same line as a setting; the comment |
355 | will be included as part of the value. E.g. this line: | 372 | will be included as part of the value. E.g. this line: |
356 | 373 | ||
357 | robots=index # allow indexing | 374 | robots=index # allow indexing |
358 | 375 | ||
359 | will generate the following html element: | 376 | will generate the following html element: |
360 | 377 | ||
361 | <meta name='robots' content='index # allow indexing'/> | 378 | <meta name='robots' content='index # allow indexing'/> |
362 | 379 | ||