summaryrefslogtreecommitdiffabout
path: root/cgitrc.5.txt
authorLars Hjemli <hjemli@gmail.com>2009-08-24 06:00:37 (UTC)
committer Lars Hjemli <hjemli@gmail.com>2009-08-24 06:00:37 (UTC)
commitb44c40ea720aee9ba4412e192877e9632a70a259 (patch) (unidiff)
tree12ee7b595c12454792ee54fb29da6a198839153b /cgitrc.5.txt
parent6445a3ad0987ba66eef555c9caa3fc378f99ee22 (diff)
downloadcgit-b44c40ea720aee9ba4412e192877e9632a70a259.zip
cgit-b44c40ea720aee9ba4412e192877e9632a70a259.tar.gz
cgit-b44c40ea720aee9ba4412e192877e9632a70a259.tar.bz2
cgitrc.5.txt: fix description and markup for 'snapshots' option
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.txt11
1 files changed, 3 insertions, 8 deletions
diff --git a/cgitrc.5.txt b/cgitrc.5.txt
index 3c35b02..0d18290 100644
--- a/cgitrc.5.txt
+++ b/cgitrc.5.txt
@@ -156,136 +156,131 @@ max-message-length::
156 156
157max-repo-count:: 157max-repo-count::
158 Specifies the number of entries to list per page on therepository 158 Specifies the number of entries to list per page on therepository
159 index page. Default value: "50". 159 index page. Default value: "50".
160 160
161max-repodesc-length:: 161max-repodesc-length::
162 Specifies the maximum number of repo description characters to display 162 Specifies the maximum number of repo description characters to display
163 on the repository index page. Default value: "80". 163 on the repository index page. Default value: "80".
164 164
165max-stats:: 165max-stats::
166 Set the default maximum statistics period. Valid values are "week", 166 Set the default maximum statistics period. Valid values are "week",
167 "month", "quarter" and "year". If unspecified, statistics are 167 "month", "quarter" and "year". If unspecified, statistics are
168 disabled. Default value: none. See also: "repo.max-stats". 168 disabled. Default value: none. See also: "repo.max-stats".
169 169
170mimetype.<ext>:: 170mimetype.<ext>::
171 Set the mimetype for the specified filename extension. This is used 171 Set the mimetype for the specified filename extension. This is used
172 by the `plain` command when returning blob content. 172 by the `plain` command when returning blob content.
173 173
174module-link:: 174module-link::
175 Text which will be used as the formatstring for a hyperlink when a 175 Text which will be used as the formatstring for a hyperlink when a
176 submodule is printed in a directory listing. The arguments for the 176 submodule is printed in a directory listing. The arguments for the
177 formatstring are the path and SHA1 of the submodule commit. Default 177 formatstring are the path and SHA1 of the submodule commit. Default
178 value: "./?repo=%s&page=commit&id=%s" 178 value: "./?repo=%s&page=commit&id=%s"
179 179
180nocache:: 180nocache::
181 If set to the value "1" caching will be disabled. This settings is 181 If set to the value "1" caching will be disabled. This settings is
182 deprecated, and will not be honored starting with cgit-1.0. Default 182 deprecated, and will not be honored starting with cgit-1.0. Default
183 value: "0". 183 value: "0".
184 184
185noplainemail:: 185noplainemail::
186 If set to "1" showing full author email adresses will be disabled. 186 If set to "1" showing full author email adresses will be disabled.
187 Default value: "0". 187 Default value: "0".
188 188
189noheader:: 189noheader::
190 Flag which, when set to "1", will make cgit omit the standard header 190 Flag which, when set to "1", will make cgit omit the standard header
191 on all pages. Default value: none. See also: "embedded". 191 on all pages. Default value: none. See also: "embedded".
192 192
193renamelimit:: 193renamelimit::
194 Maximum number of files to consider when detecting renames. The value 194 Maximum number of files to consider when detecting renames. The value
195 "-1" uses the compiletime value in git (for further info, look at 195 "-1" uses the compiletime value in git (for further info, look at
196 `man git-diff`). Default value: "-1". 196 `man git-diff`). Default value: "-1".
197 197
198repo.group:: 198repo.group::
199 A value for the current repository group, which all repositories 199 A value for the current repository group, which all repositories
200 specified after this setting will inherit. Default value: none. 200 specified after this setting will inherit. Default value: none.
201 201
202robots:: 202robots::
203 Text used as content for the "robots" meta-tag. Default value: 203 Text used as content for the "robots" meta-tag. Default value:
204 "index, nofollow". 204 "index, nofollow".
205 205
206root-desc:: 206root-desc::
207 Text printed below the heading on the repository index page. Default 207 Text printed below the heading on the repository index page. Default
208 value: "a fast webinterface for the git dscm". 208 value: "a fast webinterface for the git dscm".
209 209
210root-readme:: 210root-readme::
211 The content of the file specified with this option will be included 211 The content of the file specified with this option will be included
212 verbatim below the "about" link on the repository index page. Default 212 verbatim below the "about" link on the repository index page. Default
213 value: none. 213 value: none.
214 214
215root-title:: 215root-title::
216 Text printed as heading on the repository index page. Default value: 216 Text printed as heading on the repository index page. Default value:
217 "Git Repository Browser". 217 "Git Repository Browser".
218 218
219snapshots:: 219snapshots::
220 Text which specifies the default (and allowed) set of snapshot formats 220 Text which specifies the default set of snapshot formats generated by
221 supported by cgit. The value is a space-separated list of zero or more 221 cgit. The value is a space-separated list of zero or more of the
222 of the following values: 222 values "tar", "tar.gz", "tar.bz2" and "zip". Default value: none.
223 "tar" uncompressed tar-file
224 "tar.gz"gzip-compressed tar-file
225 "tar.bz2"bzip-compressed tar-file
226 "zip" zip-file
227 Default value: none.
228 223
229source-filter:: 224source-filter::
230 Specifies a command which will be invoked to format plaintext blobs 225 Specifies a command which will be invoked to format plaintext blobs
231 in the tree view. The command will get the blob content on its STDIN 226 in the tree view. The command will get the blob content on its STDIN
232 and the name of the blob as its only command line argument. The STDOUT 227 and the name of the blob as its only command line argument. The STDOUT
233 from the command will be included verbatim as the blob contents, i.e. 228 from the command will be included verbatim as the blob contents, i.e.
234 this can be used to implement e.g. syntax highlighting. Default value: 229 this can be used to implement e.g. syntax highlighting. Default value:
235 none. 230 none.
236 231
237summary-branches:: 232summary-branches::
238 Specifies the number of branches to display in the repository "summary" 233 Specifies the number of branches to display in the repository "summary"
239 view. Default value: "10". 234 view. Default value: "10".
240 235
241summary-log:: 236summary-log::
242 Specifies the number of log entries to display in the repository 237 Specifies the number of log entries to display in the repository
243 "summary" view. Default value: "10". 238 "summary" view. Default value: "10".
244 239
245summary-tags:: 240summary-tags::
246 Specifies the number of tags to display in the repository "summary" 241 Specifies the number of tags to display in the repository "summary"
247 view. Default value: "10". 242 view. Default value: "10".
248 243
249virtual-root:: 244virtual-root::
250 Url which, if specified, will be used as root for all cgit links. It 245 Url which, if specified, will be used as root for all cgit links. It
251 will also cause cgit to generate 'virtual urls', i.e. urls like 246 will also cause cgit to generate 'virtual urls', i.e. urls like
252 '/cgit/tree/README' as opposed to '?r=cgit&p=tree&path=README'. Default 247 '/cgit/tree/README' as opposed to '?r=cgit&p=tree&path=README'. Default
253 value: none. 248 value: none.
254 NOTE: cgit has recently learned how to use PATH_INFO to achieve the 249 NOTE: cgit has recently learned how to use PATH_INFO to achieve the
255 same kind of virtual urls, so this option will probably be deprecated. 250 same kind of virtual urls, so this option will probably be deprecated.
256 251
257REPOSITORY SETTINGS 252REPOSITORY SETTINGS
258------------------- 253-------------------
259repo.about-filter:: 254repo.about-filter::
260 Override the default about-filter. Default value: <about-filter>. 255 Override the default about-filter. Default value: <about-filter>.
261 256
262repo.clone-url:: 257repo.clone-url::
263 A list of space-separated urls which can be used to clone this repo. 258 A list of space-separated urls which can be used to clone this repo.
264 Default value: none. 259 Default value: none.
265 260
266repo.commit-filter:: 261repo.commit-filter::
267 Override the default commit-filter. Default value: <commit-filter>. 262 Override the default commit-filter. Default value: <commit-filter>.
268 263
269repo.defbranch:: 264repo.defbranch::
270 The name of the default branch for this repository. If no such branch 265 The name of the default branch for this repository. If no such branch
271 exists in the repository, the first branch name (when sorted) is used 266 exists in the repository, the first branch name (when sorted) is used
272 as default instead. Default value: "master". 267 as default instead. Default value: "master".
273 268
274repo.desc:: 269repo.desc::
275 The value to show as repository description. Default value: none. 270 The value to show as repository description. Default value: none.
276 271
277repo.enable-log-filecount:: 272repo.enable-log-filecount::
278 A flag which can be used to disable the global setting 273 A flag which can be used to disable the global setting
279 `enable-log-filecount'. Default value: none. 274 `enable-log-filecount'. Default value: none.
280 275
281repo.enable-log-linecount:: 276repo.enable-log-linecount::
282 A flag which can be used to disable the global setting 277 A flag which can be used to disable the global setting
283 `enable-log-linecount'. Default value: none. 278 `enable-log-linecount'. Default value: none.
284 279
285repo.max-stats:: 280repo.max-stats::
286 Override the default maximum statistics period. Valid values are equal 281 Override the default maximum statistics period. Valid values are equal
287 to the values specified for the global "max-stats" setting. Default 282 to the values specified for the global "max-stats" setting. Default
288 value: none. 283 value: none.
289 284
290repo.name:: 285repo.name::
291 The value to show as repository name. Default value: <repo.url>. 286 The value to show as repository name. Default value: <repo.url>.