summaryrefslogtreecommitdiffstats
path: root/man5/gitweb.conf.5
diff options
context:
space:
mode:
Diffstat (limited to 'man5/gitweb.conf.5')
-rw-r--r--man5/gitweb.conf.554
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