diff options
Diffstat (limited to 'man5/gitweb.conf.5')
-rw-r--r-- | man5/gitweb.conf.5 | 54 |
1 files changed, 27 insertions, 27 deletions
diff --git a/man5/gitweb.conf.5 b/man5/gitweb.conf.5 index cf59a190e..9507ab972 100644 --- a/man5/gitweb.conf.5 +++ b/man5/gitweb.conf.5 @@ -2,12 +2,12 @@ .\" Title: gitweb.conf .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 03/21/2023 +.\" Date: 03/28/2023 .\" Manual: Git Manual -.\" Source: Git 2.40.0.130.g27d43aaaf5 +.\" Source: Git 2.40.0.141.g8d90352acc .\" Language: English .\" -.TH "GITWEB\&.CONF" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITWEB\&.CONF" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -45,7 +45,7 @@ An example: # gitweb configuration file for http://git\&.example\&.org # our $projectroot = "/srv/git"; # FHS recommendation -our $site_name = \(aqExample\&.org >> Repos\(aq; +our $site_name = \*(AqExample\&.org >> Repos\*(Aq; .fi .if n \{\ .RE @@ -323,7 +323,7 @@ For example if repositories you are hosting use "phtml" extension for PHP files, .\} .nf our %highlight_ext; -$highlight_ext{\(aqphtml\(aq} = \(aqphp\(aq; +$highlight_ext{\*(Aqphtml\*(Aq} = \*(Aqphp\*(Aq; .fi .if n \{\ .RE @@ -439,8 +439,8 @@ For example, the following setting produces a breadcrumb trail like "home / dev .\} .nf our @extra_breadcrumbs = ( - [ \(aqhome\(aq => \(aqhttps://www\&.example\&.org/\(aq ], - [ \(aqdev\(aq => \(aqhttps://dev\&.example\&.org/\(aq ], + [ \*(Aqhome\*(Aq => \*(Aqhttps://www\&.example\&.org/\*(Aq ], + [ \*(Aqdev\*(Aq => \*(Aqhttps://dev\&.example\&.org/\*(Aq ], ); .fi .if n \{\ @@ -545,10 +545,10 @@ Gitweb assumes this charset when a line contains non\-UTF\-8 characters\&. The f .PP @diff_opts .RS 4 -Rename detection options for git\-diff and git\-diff\-tree\&. The default is (\(aq\-M\(aq); set it to (\(aq\-C\(aq) or (\(aq\-C\(aq, \(aq\-C\(aq) to also detect copies, or set it to () i\&.e\&. empty list if you don\(cqt want to have renames detection\&. +Rename detection options for git\-diff and git\-diff\-tree\&. The default is (\*(Aq\-M\*(Aq); set it to (\*(Aq\-C\*(Aq) or (\*(Aq\-C\*(Aq, \*(Aq\-C\*(Aq) to also detect copies, or set it to () i\&.e\&. empty list if you don\(cqt want to have renames detection\&. .sp \fBNote\fR -that rename and especially copy detection can be quite CPU\-intensive\&. Note also that non Git tools can have problems with patches generated with options mentioned above, especially when they involve file copies (\(aq\-C\(aq) or criss\-cross renames (\(aq\-B\(aq)\&. +that rename and especially copy detection can be quite CPU\-intensive\&. Note also that non Git tools can have problems with patches generated with options mentioned above, especially when they involve file copies (\*(Aq\-C\*(Aq) or criss\-cross renames (\*(Aq\-B\*(Aq)\&. .RE .SS "Some optional features and policies" .sp @@ -721,7 +721,7 @@ Some features cannot be overridden per project\&. For those features the structu .\} .sp .sp -As one can see it lacks the \(aqsub\(aq element\&. +As one can see it lacks the \*(Aqsub\*(Aq element\&. .sp The meaning of each part of feature configuration is described below: .PP @@ -731,7 +731,7 @@ List (array reference) of feature parameters (if there are any), used also to to .sp Note that it is currently \fBalways\fR -an array reference, even if feature doesn\(cqt accept any configuration parameters, and \(aqdefault\(aq is used only to turn it on or off\&. In such case you turn feature on by setting this element to +an array reference, even if feature doesn\(cqt accept any configuration parameters, and \*(Aqdefault\*(Aq is used only to turn it on or off\&. In such case you turn feature on by setting this element to \fB[1]\fR, and torn it off by setting it to \fB[0]\fR\&. See also the passage about the "blame" feature in the "Examples" section\&. .sp @@ -777,7 +777,7 @@ Enable and configure the "snapshot" action, which allows user to download a comp \fBgit-archive\fR(1) and possibly additionally compressed\&. This can potentially generate high traffic if you have large project\&. .sp -The value of \(aqdefault\(aq is a list of names of snapshot formats, defined in +The value of \*(Aqdefault\*(Aq is a list of names of snapshot formats, defined in \fB%known_snapshot_formats\fR hash, that you wish to offer\&. Supported formats include "tgz", "tbz2", "txz" (gzip/bzip2/xz compressed tar archive) and "zip"; please consult gitweb sources for a definitive list\&. By default only "tgz" is offered\&. .sp @@ -911,7 +911,7 @@ forks If this feature is enabled, gitweb considers projects in subdirectories of project root (basename) to be forks of existing projects\&. For each project \fB$projname\&.git\fR, projects in the \fB$projname/\fR -directory and its subdirectories will not be shown in the main projects list\&. Instead, a \(aq+\(aq mark is shown next to +directory and its subdirectories will not be shown in the main projects list\&. Instead, a \*(Aq+\*(Aq mark is shown next to \fB$projname\fR, which links to a "forks" view that lists all the forks (all projects in \fB$projname/\fR subdirectory)\&. Additionally a "forks" view for a project is linked from project summary page\&. @@ -932,7 +932,7 @@ expands to the project name, \fB%f\fR to the project path within the filesystem (i\&.e\&. "$projectroot/$project"), \fB%h\fR -to the current hash (\(aqh\(cq gitweb parameter) and \(oq%b` to the current hash base (\(aqhb\(cq gitweb parameter); \(oq%%` expands to \(aq%\(cq\&. +to the current hash (\*(Aqh\(cq gitweb parameter) and \(oq%b` to the current hash base (\*(Aqhb\(cq gitweb parameter); \(oq%%` expands to \*(Aq%\(cq\&. .sp For example, at the time this page was written, the \m[blue]\fBhttp://repo\&.or\&.cz\fR\m[] @@ -943,8 +943,8 @@ Git hosting site set it to the following to enable graphical log (using the thir .RS 4 .\} .nf -$feature{\(aqactions\(aq}{\(aqdefault\(aq} = - [ (\(aqgraphiclog\(aq, \(aq/git\-browser/by\-commit\&.html?r=%n\(aq, \(aqsummary\(aq)]; +$feature{\*(Aqactions\*(Aq}{\*(Aqdefault\*(Aq} = + [ (\*(Aqgraphiclog\*(Aq, \*(Aq/git\-browser/by\-commit\&.html?r=%n\*(Aq, \*(Aqsummary\*(Aq)]; .fi .if n \{\ .RE @@ -979,7 +979,7 @@ Typical gitweb config files will only change starting (default) time zone, and l .RS 4 .\} .nf -$feature{\(aqjavascript\-timezone\(aq}{\(aqdefault\(aq}[0] = "utc"; +$feature{\*(Aqjavascript\-timezone\*(Aq}{\*(Aqdefault\*(Aq}[0] = "utc"; .fi .if n \{\ .RE @@ -1000,8 +1000,8 @@ List of additional directories under "refs" which are going to be used as branch .RS 4 .\} .nf -$feature{\(aqextra\-branch\-refs\(aq}{\(aqdefault\(aq} = - [\(aqsandbox\(aq, \(aqwip\(aq, \(aqother\(aq]; +$feature{\*(Aqextra\-branch\-refs\*(Aq}{\*(Aqdefault\*(Aq} = + [\*(Aqsandbox\*(Aq, \*(Aqwip\*(Aq, \*(Aqother\*(Aq]; .fi .if n \{\ .RE @@ -1046,14 +1046,14 @@ To enable blame, pickaxe search, and snapshot support (allowing "tar\&.gz" and " .RS 4 .\} .nf -$feature{\(aqblame\(aq}{\(aqdefault\(aq} = [1]; -$feature{\(aqblame\(aq}{\(aqoverride\(aq} = 1; +$feature{\*(Aqblame\*(Aq}{\*(Aqdefault\*(Aq} = [1]; +$feature{\*(Aqblame\*(Aq}{\*(Aqoverride\*(Aq} = 1; -$feature{\(aqpickaxe\(aq}{\(aqdefault\(aq} = [1]; -$feature{\(aqpickaxe\(aq}{\(aqoverride\(aq} = 1; +$feature{\*(Aqpickaxe\*(Aq}{\*(Aqdefault\*(Aq} = [1]; +$feature{\*(Aqpickaxe\*(Aq}{\*(Aqoverride\*(Aq} = 1; -$feature{\(aqsnapshot\(aq}{\(aqdefault\(aq} = [\(aqzip\(aq, \(aqtgz\(aq]; -$feature{\(aqsnapshot\(aq}{\(aqoverride\(aq} = 1; +$feature{\*(Aqsnapshot\*(Aq}{\*(Aqdefault\*(Aq} = [\*(Aqzip\*(Aq, \*(Aqtgz\*(Aq]; +$feature{\*(Aqsnapshot\*(Aq}{\*(Aqoverride\*(Aq} = 1; .fi .if n \{\ .RE @@ -1066,8 +1066,8 @@ If you allow overriding for the snapshot feature, you can specify which snapshot .RS 4 .\} .nf -$known_snapshot_formats{\(aqzip\(aq}{\(aqdisabled\(aq} = 1; -$known_snapshot_formats{\(aqtgz\(aq}{\(aqcompressor\(aq} = [\(aqgzip\(aq,\(aq\-6\(aq]; +$known_snapshot_formats{\*(Aqzip\*(Aq}{\*(Aqdisabled\*(Aq} = 1; +$known_snapshot_formats{\*(Aqtgz\*(Aq}{\*(Aqcompressor\*(Aq} = [\*(Aqgzip\*(Aq,\*(Aq\-6\*(Aq]; .fi .if n \{\ .RE |