opendev/gerrit
Code Issues Proposed changes

Make all external links in the documentation open in a new window

Browse Source 
To make it easier to stay on track when reading documentation, I
added ",role=external,window=_blank" to all links in the
documentation directory that were not pointing at another piece of documentation.

Change-Id: I94bf254c90f8ebce067c765be0a2932b755a045a
This commit is contained in:
Marian Harbach 2019-12-10 18:01:31 +01:00
parent 73b226647f
commit 34253376e6
76 changed files with 471 additions and 471 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
Documentation/access-control.txt
View File

@ -7,10 +7,10 @@ users.
To view/edit the access controls for a specific project, first
navigate to the projects page: for example,
https://gerrit-review.googlesource.com/admin/repos/ . Then click on
https://gerrit-review.googlesource.com/admin/repos/[role=external,window=_blank]. Then click on
the individual project, and then click Access. This will bring you
to a url that looks like
https://gerrit-review.googlesource.com/admin/repos/gerrit,access
https://gerrit-review.googlesource.com/admin/repos/gerrit,access[role=external,window=_blank]
[[system_groups]]
== System Groups
@ -218,7 +218,7 @@ by prefixing the reference name with `^`. For example
`^refs/heads/[a-z]{1,8}` matches all lower case branch names
between 1 and 8 characters long. Within a regular expression `.`
is a wildcard matching any character, but may be escaped as `\.`.
The link:http://www.brics.dk/automaton/[dk.brics.automaton library]
The link:http://www.brics.dk/automaton/[dk.brics.automaton library,role=external,window=_blank]
is used for evaluation of regular expression access control
rules. See the library documentation for details on this
particular regular expression flavor. One quirk is that the
@ -979,7 +979,7 @@ A typical Continuous Integration system should be able to download new changes
to build and then leave a verdict somehow.
As an example, the popular
link:https://wiki.jenkins-ci.org/display/JENKINS/Gerrit+Trigger[gerrit-trigger plugin]
link:https://wiki.jenkins-ci.org/display/JENKINS/Gerrit+Trigger[gerrit-trigger plugin,role=external,window=_blank]
for Jenkins/Hudson can set labels at:
* The start of a build

20
Documentation/backup.txt
View File

@ -47,7 +47,7 @@ for production installations.
+
If you have chosen to use _Elastic Search_ for indexing,
refer to its
link:https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-snapshots.html[backup documentation].
link:https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-snapshots.html[backup documentation,role=external,window=_blank].
[#optional-backup-cache]
Caches::
@ -70,7 +70,7 @@ directory also contains secrets which should be handled separately
* public and private SSH host keys
+
You may consider to use the
link:https://gerrit.googlesource.com/plugins/secure-config/[secure-config plugin]
link:https://gerrit.googlesource.com/plugins/secure-config/[secure-config plugin,role=external,window=_blank]
to encrypt these secrets.
[#optional-backup-plugin-data]
@ -144,7 +144,7 @@ server is read-only or down as short as possible.
Make the server read-only before taking the backup. This means read-access
is still available during backup, because only write operations have to be
stopped to ensure consistency. This can be implemented using the
link:https://gerrit.googlesource.com/plugins/readonly/[_readonly_] plugin.
link:https://gerrit.googlesource.com/plugins/readonly/[_readonly_,role=external,window=_blank] plugin.
[#cons-backup-replicate]
=== Replicate data for backup
@ -156,9 +156,9 @@ file, ref-logs, git configs, and alternate configs.
Replicate all git repositories to another file system using
`git clone --mirror`,
or the
link:https://gerrit.googlesource.com/plugins/replication[replication plugin]
link:https://gerrit.googlesource.com/plugins/replication[replication plugin,role=external,window=_blank]
or the
link:https://gerrit.googlesource.com/plugins/pull-replication[pull-replication plugin].
link:https://gerrit.googlesource.com/plugins/pull-replication[pull-replication plugin,role=external,window=_blank].
Best you use a filesystem supporting snapshots to create a backup archive
of such a replica.
@ -173,7 +173,7 @@ with the backup of the git repositories.
Do not skip backing up the replica, the replica alone IS NOT a backup.
Imagine someone deleted a project by mistake and this deletion got replicated.
Replication of repository deletions can be switched off using the
link:https://gerrit.googlesource.com/plugins/replication/+/refs/heads/master/src/main/resources/Documentation/config.md[server option]
link:https://gerrit.googlesource.com/plugins/replication/+/refs/heads/master/src/main/resources/Documentation/config.md[server option,role=external,window=_blank]
`remote.NAME.replicateProjectDeletions`.
If you are using Gerrit replica to offload read traffic you can use one of these
@ -195,13 +195,13 @@ repositories) which affect the repositories may need to be shut down.
Filesystems supporting copy on write snapshots::
+
Use a file system supporting copy-on-write snapshots like
link:https://btrfs.wiki.kernel.org/index.php/SysadminGuide#Snapshots[btrfs]
link:https://btrfs.wiki.kernel.org/index.php/SysadminGuide#Snapshots[btrfs,role=external,window=_blank]
or
https://wiki.debian.org/ZFS#Snapshots[zfs].
https://wiki.debian.org/ZFS#Snapshots[zfs,role=external,window=_blank].
Other filesystems supporting snapshots::
https://wiki.archlinux.org/index.php/LVM#Snapshots[lvm] or nfs.
https://wiki.archlinux.org/index.php/LVM#Snapshots[lvm,role=external,window=_blank] or nfs.
+
Create a snapshot and then archive the snapshot to another storage.
+
@ -257,7 +257,7 @@ And fire drill restoring a new site using the backup.
[#backup-dr-multi-site]
=== Multi-site setup
Use the https://gerrit.googlesource.com/plugins/multi-site[multi-site plugin]
Use the https://gerrit.googlesource.com/plugins/multi-site[multi-site plugin,role=external,window=_blank]
to install Gerrit with multiple sites installed in different datacenters
across different regions. This ensures that in case of a severe problem with
one of the sites, the other sites can still serve your repositories.

4
Documentation/cmd-hook-commit-msg.txt
View File

@ -86,8 +86,8 @@ $ chmod u+x ~/duhproject/.git/hooks/commit-msg
* link:user-changeid.html[Change-Id Lines]
* link:http://www.kernel.org/pub/software/scm/git/docs/git-commit.html[git-commit(1)]
* link:http://www.kernel.org/pub/software/scm/git/docs/githooks.html[githooks(5)]
* link:http://www.kernel.org/pub/software/scm/git/docs/git-commit.html[git-commit(1),role=external,window=_blank]
* link:http://www.kernel.org/pub/software/scm/git/docs/githooks.html[githooks(5),role=external,window=_blank]
== IMPLEMENTATION

2
Documentation/concept-refs-for-namespace.txt
View File

@ -1,7 +1,7 @@
= The refs/for namespace
When pushing a new or updated commit to Gerrit, you push that commit using a
link:https://www.kernel.org/pub/software/scm/git/docs/gitglossary.html#def_ref[reference],
link:https://www.kernel.org/pub/software/scm/git/docs/gitglossary.html#def_ref[reference,role=external,window=_blank],
in the `refs/for` namespace. This reference must also define
the target branch, such as `refs/for/[BRANCH_NAME]`.

4
Documentation/config-accounts.txt
View File

@ -143,7 +143,7 @@ Stores the link:#project-watches[project watches] of the account.
In addition it contains an
link:https://en.wikibooks.org/wiki/OpenSSH/Client_Configuration_Files#.7E.2F.ssh.2Fauthorized_keys[
authorized_keys] file with the link:#ssh-keys[SSH keys] of the account.
authorized_keys,role=external,window=_blank] file with the link:#ssh-keys[SSH keys] of the account.
[[account-properties]]
=== Account Properties
@ -256,7 +256,7 @@ matches the change and the event.
SSH keys are stored in the user branch in an `authorized_keys` file,
which is the
link:https://en.wikibooks.org/wiki/OpenSSH/Client_Configuration_Files#.7E.2F.ssh.2Fauthorized_keys[
standard OpenSSH file format] for storing SSH keys:
standard OpenSSH file format,role=external,window=_blank] for storing SSH keys:
----
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQCgug5VyMXQGnem2H1KVC4/HcRcD4zzBqSuJBRWVonSSoz3RoAZ7bWXCVVGwchtXwUURD689wFYdiPecOrWOUgeeyRq754YWRhU+W28vf8IZixgjCmiBhaL2gt3wff6pP+NXJpTSA4aeWE5DfNK5tZlxlSxqkKOS8JRSUeNQov5Tw== john.doe@example.com

68
Documentation/config-gerrit.txt
View File

@ -174,7 +174,7 @@ values are:
+
The default setting. Gerrit uses any valid OpenID
provider chosen by the end-user. For more information see
http://openid.net/[openid.net].
http://openid.net/[openid.net,role=external,window=_blank].
+
* `OpenID_SSO`
+
@ -286,7 +286,7 @@ is set to `OpenID` (the default).
+
Patterns may be either a
link:http://download.oracle.com/javase/6/docs/api/java/util/regex/Pattern.html[standard
Java regular expression (java.util.regex)] (start with `^` and
Java regular expression (java.util.regex),role=external,window=_blank] (start with `^` and
end with `$`) or be a simple prefix (any other string).
+
By default, the list contains two values, `http://` and `https://`,
@ -304,7 +304,7 @@ pattern from this list.
+
Patterns may be either a
link:http://download.oracle.com/javase/6/docs/api/java/util/regex/Pattern.html[standard
Java regular expression (java.util.regex)] (start with `^` and
Java regular expression (java.util.regex),role=external,window=_blank] (start with `^` and
end with `$`) or be a simple prefix (any other string).
+
By default, the list contains two values, `http://` and `https://`,
@ -695,7 +695,7 @@ caused by the H2 database using too much memory.
+
Technically the H2 cache size is configured using the CACHE_SIZE parameter in
the H2 JDBC connection URL, as described
link:http://www.h2database.com/html/features.html#cache_settings[here]
link:http://www.h2database.com/html/features.html#cache_settings[here,role=external,window=_blank]
+
Default is unset, using up to half of the available memory.
+
@ -708,7 +708,7 @@ Common unit suffixes of 'k', 'm', or 'g' are supported.
If set to true, enable H2 autoserver mode for the H2-backed persistent cache
databases.
+
See link:http://www.h2database.com/html/features.html#auto_mixed_mode[here]
See link:http://www.h2database.com/html/features.html#auto_mixed_mode[here,role=external,window=_blank]
for detail.
+
Default is false.
@ -1712,7 +1712,7 @@ projects that allow content merges.
+
As explained in this
link:http://codicesoftware.blogspot.com/2011/09/merge-recursive-strategy.html[
blog], the recursive merge produces better results if the two commits
blog,role=external,window=_blank], the recursive merge produces better results if the two commits
that are merged have more than one common predecessor.
+
Default is true.
@ -2245,9 +2245,9 @@ By default, Gerrit will use hexadecimal encoding for slashes in project and
branch names. Some web servers, such as Tomcat, reject this hexadecimal
encoding in the URL.
+
Some alternative gitweb services, such as link:http://gitblit.com[Gitblit],
Some alternative gitweb services, such as link:http://gitblit.com[Gitblit,role=external,window=_blank],
allow using an alternative path separator character. In Gitblit, this can be
configured through the property link:http://gitblit.com/properties.html[web.forwardSlashCharacter].
configured through the property link:http://gitblit.com/properties.html[web.forwardSlashCharacter,role=external,window=_blank].
In Gerrit, the alternative path separator can be configured correspondingly
using the property `gitweb.pathSeparator`.
+
@ -2397,7 +2397,7 @@ supplied, defaults to 8080.
Like `http://`, but additional header parsing features are
enabled to honor `X-Forwarded-For`, `X-Forwarded-Host` and
`X-Forwarded-Server`. These headers are typically set by Apache's
link:https://httpd.apache.org/docs/2.4/mod/mod_proxy.html#x-headers[mod_proxy].
link:https://httpd.apache.org/docs/2.4/mod/mod_proxy.html#x-headers[mod_proxy,role=external,window=_blank].
+
[NOTE]
--
@ -2748,7 +2748,7 @@ A link:http://lucene.apache.org/[Lucene] index is used.
+
* `ELASTICSEARCH` look into link:#elasticsearch[Elasticsearch section]
+
An link:https://www.elastic.co/products/elasticsearch[Elasticsearch] index is
An link:https://www.elastic.co/products/elasticsearch[Elasticsearch,role=external,window=_blank] index is
used. Refer to the link:#elasticsearch[Elasticsearch section] for further
configuration details.
@ -2912,7 +2912,7 @@ The following settings are only used when the index type is `LUCENE`.
Determines the amount of RAM that may be used for buffering added documents
and deletions before they are flushed to the index. See the
link:http://lucene.apache.org/core/4_6_0/core/org/apache/lucene/index/LiveIndexWriterConfig.html#setRAMBufferSizeMB(double)[
Lucene documentation] for further details.
Lucene documentation,role=external,window=_blank] for further details.
+
Defaults to 16M.
@ -2922,7 +2922,7 @@ Determines the minimal number of documents required before the buffered
in-memory documents are flushed to the index. Large values generally
give faster indexing. See the
link:http://lucene.apache.org/core/4_6_0/core/org/apache/lucene/index/LiveIndexWriterConfig.html#setMaxBufferedDocs(int)[
Lucene documentation] for further details.
Lucene documentation,role=external,window=_blank] for further details.
+
Defaults to -1, meaning no maximum is set and the writer will flush
according to RAM usage.
@ -2955,7 +2955,7 @@ is necessary yet we already have this many threads running, the incoming thread
completed. Note that Lucene will only run the smallest maxThreadCount merges
at a time. See the
link:https://lucene.apache.org/core/5_5_0/core/org/apache/lucene/index/ConcurrentMergeScheduler.html#setDefaultMaxMergesAndThreads(boolean)[
Lucene documentation] for further details.
Lucene documentation,role=external,window=_blank] for further details.
+
Defaults to -1 for (auto detection).
@ -2965,13 +2965,13 @@ Defaults to -1 for (auto detection).
Determines the max number of simultaneous Lucene merge threads that should be running at
once. This must be less than or equal to maxMergeCount. See the
link:https://lucene.apache.org/core/5_5_0/core/org/apache/lucene/index/ConcurrentMergeScheduler.html#setDefaultMaxMergesAndThreads(boolean)[
Lucene documentation] for further details.
Lucene documentation,role=external,window=_blank] for further details.
+
For further details on Lucene index configuration (auto detection) which
affects maxThreadCount and maxMergeCount settings.
See the
link:https://lucene.apache.org/core/5_5_0/core/org/apache/lucene/index/ConcurrentMergeScheduler.html#AUTO_DETECT_MERGES_AND_THREADS[
Lucene documentation]
Lucene documentation,role=external,window=_blank]
+
Defaults to -1 for (auto detection).
@ -2982,7 +2982,7 @@ default in the lucene merge queue. Automatic dynamic IO throttling, which when
on is used to adaptively rate limit writes bytes/sec to the minimal rate necessary
so merges do not fall behind. See the
link:https://lucene.apache.org/core/5_5_0/core/org/apache/lucene/index/ConcurrentMergeScheduler.html#enableAutoIOThrottle()[
Lucene documentation] for further details.
Lucene documentation,role=external,window=_blank] for further details.
+
Defaults to true (throttling enabled).
@ -3012,7 +3012,7 @@ Sample Lucene index configuration:
WARNING: Support for Elasticsearch is still experimental and is not recommended
for production use. For compatibility information, please refer to the
link:https://www.gerritcodereview.com/elasticsearch.html[project homepage].
link:https://www.gerritcodereview.com/elasticsearch.html[project homepage,role=external,window=_blank].
When using Elasticsearch version 5.6, the open and closed changes are
indexed in a single index, separated into types `open_changes` and `closed_changes`
@ -3047,7 +3047,7 @@ manually.
+
Sets the number of shards to use per index. Refer to the
link:https://www.elastic.co/guide/en/elasticsearch/reference/current/getting-started-concepts.html#getting-started-shards-and-replicas[
Elasticsearch documentation] for details.
Elasticsearch documentation,role=external,window=_blank] for details.
+
Defaults to 5 for Elasticsearch versions 5 and 6, and to 1 starting with Elasticsearch 7.
@ -3055,7 +3055,7 @@ Defaults to 5 for Elasticsearch versions 5 and 6, and to 1 starting with Elastic
+
Sets the number of replicas to use per index. Refer to the
link:https://www.elastic.co/guide/en/elasticsearch/reference/current/getting-started-concepts.html#getting-started-shards-and-replicas[
Elasticsearch documentation] for details.
Elasticsearch documentation,role=external,window=_blank] for details.
+
Defaults to 1.
@ -3066,12 +3066,12 @@ Note that the same username and password are used for all servers.
For further information about Elasticsearch security, please refer to the documentation:
* link:https://www.elastic.co/guide/en/x-pack/5.6/security-getting-started.html[Elasticsearch 5.6]
* link:https://www.elastic.co/guide/en/x-pack/6.2/security-getting-started.html[Elasticsearch 6.2]
* link:https://www.elastic.co/guide/en/elastic-stack-overview/6.3/security-getting-started.html[Elasticsearch 6.3]
* link:https://www.elastic.co/guide/en/elastic-stack-overview/6.4/security-getting-started.html[Elasticsearch 6.4]
* link:https://www.elastic.co/guide/en/elastic-stack-overview/6.5/security-getting-started.html[Elasticsearch 6.5]
* link:https://www.elastic.co/guide/en/elastic-stack-overview/6.6/security-getting-started.html[Elasticsearch 6.6]
* link:https://www.elastic.co/guide/en/x-pack/5.6/security-getting-started.html[Elasticsearch 5.6,role=external,window=_blank]
* link:https://www.elastic.co/guide/en/x-pack/6.2/security-getting-started.html[Elasticsearch 6.2,role=external,window=_blank]
* link:https://www.elastic.co/guide/en/elastic-stack-overview/6.3/security-getting-started.html[Elasticsearch 6.3,role=external,window=_blank]
* link:https://www.elastic.co/guide/en/elastic-stack-overview/6.4/security-getting-started.html[Elasticsearch 6.4,role=external,window=_blank]
* link:https://www.elastic.co/guide/en/elastic-stack-overview/6.5/security-getting-started.html[Elasticsearch 6.5,role=external,window=_blank]
* link:https://www.elastic.co/guide/en/elastic-stack-overview/6.6/security-getting-started.html[Elasticsearch 6.6,role=external,window=_blank]
[[elasticsearch.username]]elasticsearch.username::
+
@ -3122,8 +3122,8 @@ An example LDAP configuration follows, and then discussion of
the parameters introduced here. Suitable defaults for most
parameters are automatically guessed based on the type of server
detected during startup. The guessed defaults support
link:http://www.ietf.org/rfc/rfc2307.txt[RFC 2307], Active
Directory and link:https://www.freeipa.org[FreeIPA].
link:http://www.ietf.org/rfc/rfc2307.txt[RFC 2307,role=external,window=_blank], Active
Directory and link:https://www.freeipa.org[FreeIPA,role=external,window=_blank].
----
[ldap]
@ -3477,8 +3477,8 @@ needed. When a Context instance is done with a connection (closed or
garbage collected), the connection is returned to the pool for future use.
+
For details, see link:http://docs.oracle.com/javase/tutorial/jndi/ldap/pool.html[
LDAP connection management (Pool)] and link:http://docs.oracle.com/javase/tutorial/jndi/ldap/config.html[
LDAP connection management (Configuration)]
LDAP connection management (Pool),role=external,window=_blank] and link:http://docs.oracle.com/javase/tutorial/jndi/ldap/config.html[
LDAP connection management (Configuration),role=external,window=_blank]
+
By default, false.
@ -3497,7 +3497,7 @@ Once LDAP connection pooling is enabled by setting the link:#ldap.useConnectionP
ldap.useConnectionPooling] configuration property to `true`, the connection pool
can be configured using JVM system properties as explained in the
link:http://docs.oracle.com/javase/7/docs/technotes/guides/jndi/jndi-ldap.html#POOL[
Java SE Documentation].
Java SE Documentation,role=external,window=_blank].
For standalone Gerrit (running with the embedded Jetty), JVM system properties
are specified in the link:#container[container section]:
@ -3515,7 +3515,7 @@ are specified in the link:#container[container section]:
+
The name of a plugin which serves the
link:https://github.com/github/git-lfs/blob/master/docs/api/v1/http-v1-batch.md[
LFS protocol] on the `<project-name>/info/lfs/objects/batch` endpoint. When
LFS protocol,role=external,window=_blank] on the `<project-name>/info/lfs/objects/batch` endpoint. When
not configured Gerrit will respond with `501 Not Implemented` on LFS protocol
requests.
+
@ -3926,7 +3926,7 @@ Key fingerprints can be displayed with `gpg --list-keys
+
Trust signatures can be added to a key using the `tsign` command to
link:https://www.gnupg.org/documentation/manuals/gnupg/OpenPGP-Key-Management.html[
`gpg --edit-key`], after which the signed key should be re-uploaded.
`gpg --edit-key`,role=external,window=_blank], after which the signed key should be re-uploaded.
+
If no keys are specified, web-of-trust checks are disabled. This is the
default behavior.
@ -4379,7 +4379,7 @@ Reply-To if inbound email is enabled and the review's author otherwise.
[[sendemail.allowTLD]]sendemail.allowTLD::
+
List of custom TLDs to allow sending emails to in addition to those specified
in the link:http://data.iana.org/TLD/[IANA list].
in the link:http://data.iana.org/TLD/[IANA list,role=external,window=_blank].
+
Defaults to an empty list, meaning no additional TLDs are allowed.
@ -4889,7 +4889,7 @@ The trailing ":" is optional.
[[trackingid.name.match]]trackingid.<name>.match::
+
A link:http://download.oracle.com/javase/6/docs/api/java/util/regex/Pattern.html[standard
Java regular expression (java.util.regex)] used to match the
Java regular expression (java.util.regex),role=external,window=_blank] used to match the
external tracking id part of the footer line. The match can
result in several entries in the DB. If grouping is used in the
regex the first group will be interpreted as the tracking id.

12
Documentation/config-gitweb.txt
View File

@ -167,21 +167,21 @@ link:http://localhost/gitweb[http://localhost/gitweb]
Instructions are available for installing the gitweb module distributed with
MsysGit:
link:https://github.com/msysgit/msysgit/wiki/GitWeb[GitWeb]
link:https://github.com/msysgit/msysgit/wiki/GitWeb[GitWeb,role=external,window=_blank]
If you don't have Apache installed, you can download the appropriate build for
Windows from link:http://www.apachelounge.com/download[apachelounge.org].
After you have installed Apache, you will want to create a link:http://httpd.apache.org/docs/2.0/platform/windows.html#winsvc[new service user
account] to use with Apache.
account,role=external,window=_blank] to use with Apache.
If you're still having difficulty setting up permissions, you may find this
tech note useful for configuring Apache Service to run under another account.
You must grant the new account link:http://technet.microsoft.com/en-us/library/cc794944(WS.10).aspx["run as service"] permission:
You must grant the new account link:http://technet.microsoft.com/en-us/library/cc794944(WS.10).aspx["run as service",role=external,window=_blank] permission:
The gitweb version in msysgit is missing several important and required
perl modules, including CGI.pm. The perl included with the msysgit distro 1.7.8
is broken.. The link:http://groups.google.com/group/msysgit/browse_thread/thread/ba3501f1f0ed95af[unicore folder is missing along with utf8_heavy.pl and CGI.pm]. You can
is broken.. The link:http://groups.google.com/group/msysgit/browse_thread/thread/ba3501f1f0ed95af[unicore folder is missing along with utf8_heavy.pl and CGI.pm,role=external,window=_blank]. You can
verify by checking for perl modules. From an msys console, execute the
following to check:
@ -202,7 +202,7 @@ failed--compilation aborted.
If you're missing CGI.pm, you'll have to deploy the module to the msys
environment: You will have to retrieve them from the 5.8.8 distro on :
http://strawberryperl.com/releases.html
http://strawberryperl.com/releases.html[role=external,window=_blank]
File: strawberry-perl-5.8.8.3.zip
@ -272,7 +272,7 @@ It is also possible to define custom patterns.
=== SEE ALSO
* link:config-gerrit.html#gitweb[Section gitweb]
* link:http://git.zx2c4.com/cgit/about/[cgit]
* link:http://git.zx2c4.com/cgit/about/[cgit,role=external,window=_blank]
GERRIT
------

2
Documentation/config-hooks.txt
View File

@ -3,7 +3,7 @@
Gerrit does not run any of the standard git hooks in the repositories
it works with, but it does have its own hook mechanism included via
the link:https://gerrit-review.googlesource.com/admin/repos/plugins/hooks[
hooks plugin].
hooks plugin,role=external,window=_blank].
GERRIT
------

2
Documentation/config-mail.txt
View File

@ -1,6 +1,6 @@
= Gerrit Code Review - Mail Templates
Gerrit uses link:https://developers.google.com/closure/templates/[Closure Templates]
Gerrit uses link:https://developers.google.com/closure/templates/[Closure Templates,role=external,window=_blank]
(Soy) for the bulk of the standard mails it sends out.
There are builtin default templates which are used if they are not overridden.
These defaults are also provided as examples so that administrators may copy

286
Documentation/config-plugins.txt
View File

@ -25,10 +25,10 @@ Plugin Development Guide].
If you want to share your plugin under the link:licenses.html#Apache2_0[
Apache License 2.0] you can host your plugin development on the
link:https://gerrit-review.googlesource.com[gerrit-review] Gerrit
link:https://gerrit-review.googlesource.com[gerrit-review,role=external,window=_blank] Gerrit
Server. You can request the creation of a new Project by email
to the link:https://groups.google.com/forum/#!forum/repo-discuss[Gerrit
mailing list]. You would be assigned as project owner of the new plugin
mailing list,role=external,window=_blank]. You would be assigned as project owner of the new plugin
project so that you can submit changes on your own. It is the
responsibility of the project owner to maintain the plugin, e.g. to
make sure that it works with new Gerrit versions and to create stable
@ -51,7 +51,7 @@ revision for the Gerrit version you are using.
CodeMirror plugin for polygerrit.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/codemirror-editor[
Project] |
Project,role=external,window=_blank] |
[[commit-message-length-validator]]
=== commit-message-length-validator
@ -61,11 +61,11 @@ message body, and reports warnings or errors to the git client if the
lengths are exceeded.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/commit-message-length-validator[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/commit-message-length-validator/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/commit-message-length-validator/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[delete-project]]
=== delete-project
@ -73,11 +73,11 @@ Configuration]
Provides the ability to delete a project.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/delete-project[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/delete-project/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/delete-project/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[download-commands]]
=== download-commands
@ -86,11 +86,11 @@ This plugin defines commands for downloading changes in different
download schemes (for downloading via different network protocols).
link:https://gerrit-review.googlesource.com/admin/repos/plugins/download-commands[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/download-commands/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/download-commands/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[gitiles]]
=== gitiles
@ -98,7 +98,7 @@ Configuration]
Plugin running Gitiles alongside a Gerrit server.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/gitiles[
Project]
Project,role=external,window=_blank]
[[hooks]]
=== hooks
@ -106,11 +106,11 @@ Project]
This plugin runs server-side hooks on events.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/hooks[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/hooks/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/hooks/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[plugin-manager]]
=== plugin-manager
@ -120,11 +120,11 @@ Per default GerritForge CI is used to download the plugin artifacts from, but
this can be changed per plugin configuration.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/plugin-manager[
Project]
Project,role=external,window=_blank]
link:https://gerrit.googlesource.com/plugins/plugin-manager/+doc/master/src/main/resources/Documentation/about.md[
Documentation]
Documentation,role=external,window=_blank]
link:https://gerrit.googlesource.com/plugins/plugin-manager/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[replication]]
=== replication
@ -135,11 +135,11 @@ be configured to provide mirroring of changes, for warm-standby
backups, or a load-balanced public mirror farm.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/replication[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/replication/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/replication/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[reviewnotes]]
=== reviewnotes
@ -148,9 +148,9 @@ Stores review information for Gerrit changes in the `refs/notes/review`
branch.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/reviewnotes[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/reviewnotes/+doc/master/src/main/resources/Documentation/about.md[
Documentation]
Documentation,role=external,window=_blank]
[[singleusergroup]]
=== singleusergroup
@ -165,11 +165,11 @@ only be assigned to groups.
This plugin allows to propagate Gerrit events to remote http endpoints.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/webhooks[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/webhooks/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/webhooks/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[other-plugins]]
== Other Plugins
@ -183,12 +183,12 @@ The Gerrit Project doesn't provide binaries for these plugins, but
there is one public service that offers the download of pre-built
plugin jars:
* link:https://gerrit-ci.gerritforge.com[CI Server from GerritForge]
* link:https://gerrit-ci.gerritforge.com[CI Server from GerritForge,role=external,window=_blank]
The following list gives an overview of available plugins, but the
list may not be complete. You may discover more plugins on
link:https://gerrit-review.googlesource.com/admin/repos/?filter=plugins%252F[
gerrit-review].
gerrit-review,role=external,window=_blank].
Note that the documentation and configuration links in the list below are
to the plugins' master branch. Please refer to the appropriate branch for
@ -205,9 +205,9 @@ information. Also providing access control information by project or
project/account.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/admin-console[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/admin-console/+doc/master/src/main/resources/Documentation/about.md[
Documentation]
Documentation,role=external,window=_blank]
[[analytics]]
=== analytics
@ -218,8 +218,8 @@ Metrics are extracted in JSON format with one record per line, ready to be
archived and processed with popular BigData transformation tools such
Apache Spark or published and visualized in dashboards.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/analytics[Project] |
link:https://gerrit.googlesource.com/plugins/analytics/+doc/master/README.md[Documentation]
link:https://gerrit-review.googlesource.com/admin/repos/plugins/analytics[Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/analytics/+doc/master/README.md[Documentation,role=external,window=_blank]
[[avatars-external]]
=== avatars-external
@ -228,11 +228,11 @@ This plugin allows to use an external url to load the avatar images
from.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/avatars-external[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/avatars-external/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/avatars-external/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[avatars-gravatar]]
=== avatars-gravatar
@ -240,7 +240,7 @@ Configuration]
Plugin to display user icons from Gravatar.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/avatars-gravatar[
Project]
Project,role=external,window=_blank]
[[branch-network]]
=== branch-network
@ -250,11 +250,11 @@ graphical HTML5 Canvas. It is mainly intended to be used as a
"project link" in a gitweb configuration.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/branch-network[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/branch-network/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/branch-network/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[changemessage]]
=== changemessage
@ -262,11 +262,11 @@ Configuration]
This plugin allows to display a static info message on the change screen.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/changemessage[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/changemessage/+doc/master/src/main/resources/Documentation/about.md[
Plugin Documentation] |
Plugin Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/changemessage/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[checks]]
=== checks
@ -275,9 +275,9 @@ The checks plugin provides a REST API and UI extensions for integrating
CI systems with Gerrit.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/checks[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/checks/+doc/master/README.md[
Plugin Documentation]
Plugin Documentation,role=external,window=_blank]
[[egit]]
=== egit
@ -289,9 +289,9 @@ the change ref into the clipboard. The change ref is needed for
downloading a Gerrit change from within EGit.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/egit[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/egit/+doc/master/src/main/resources/Documentation/about.md[
Documentation]
Documentation,role=external,window=_blank]
[[emoticons]]
=== emoticons
@ -299,11 +299,11 @@ Documentation]
This plugin allows users to see emoticons in comments as images.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/emoticons[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/emoticons/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/emoticons/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[find-owners]]
=== find-owners
@ -312,9 +312,9 @@ that shows owners of changed files to be included as code reviewers, and
(2) Prolog predicates to make sure that a CL is submittable
only with owner Code-Review +1 votes.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/find-owners[Project] |
link:https://gerrit.googlesource.com/plugins/find-owners/+doc/master/src/main/resources/Documentation/about.md[Documentation] |
link:https://gerrit.googlesource.com/plugins/find-owners/+doc/master/src/main/resources/Documentation/config.md[Configuration]
link:https://gerrit-review.googlesource.com/admin/repos/plugins/find-owners[Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/find-owners/+doc/master/src/main/resources/Documentation/about.md[Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/find-owners/+doc/master/src/main/resources/Documentation/config.md[Configuration,role=external,window=_blank]
[[gitblit]]
=== gitblit
@ -322,7 +322,7 @@ link:https://gerrit.googlesource.com/plugins/find-owners/+doc/master/src/main/re
GitBlit code-viewer plugin with SSO and Security Access Control.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/gitblit[
Project]
Project,role=external,window=_blank]
[[github]]
=== github
@ -330,7 +330,7 @@ Project]
Plugin to integrate with GitHub: replication, pull-request to Change-Sets
link:https://gerrit-review.googlesource.com/admin/repos/plugins/github[
Project]
Project,role=external,window=_blank]
[[healthcheck]]
=== healthcheck
@ -346,11 +346,11 @@ Healthcheck metrics (latency and subsystem healthiness) are published as
Gerrit internal metrics and can be published to dashboards.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/healthcheck[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/healthcheck/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/healthcheck/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[imagare]]
=== imagare
@ -358,11 +358,11 @@ Configuration]
The imagare plugin allows Gerrit users to upload and share images.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/imagare[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/imagare/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/imagare/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[importer]]
=== importer
@ -386,9 +386,9 @@ server, and in combination with the link:#delete-project[delete-project]
plugin it can be used to rename a project.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/importer[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/importer/+doc/master/src/main/resources/Documentation/about.md[
Documentation]
Documentation,role=external,window=_blank]
[[its-plugins]]
=== Issue Tracker System Plugins
@ -402,11 +402,11 @@ the `its-base` project. `its-base` is not a plugin, but just a
framework for the ITS plugins which is packaged within each ITS plugin.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/its-base[
its-base Project] |
its-base Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/its-base/+doc/master/src/main/resources/Documentation/about.md[
its-base Documentation] |
its-base Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/its-base/+doc/master/src/main/resources/Documentation/config.md[
its-base Configuration]
its-base Configuration,role=external,window=_blank]
[[its-bugzilla]]
==== its-bugzilla
@ -414,9 +414,9 @@ its-base Configuration]
Plugin to integrate with Bugzilla.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/its-bugzilla[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/its-bugzilla/+doc/master/src/main/resources/Documentation/about.md[
Documentation]
Documentation,role=external,window=_blank]
[[its-jira]]
==== its-jira
@ -424,9 +424,9 @@ Documentation]
Plugin to integrate with Jira.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/its-jira[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/its-jira/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[its-phabricator]]
==== its-phabricator
@ -434,9 +434,9 @@ Configuration]
Plugin to integrate with Phabricator.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/its-phabricator[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/its-phabricator/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[its-rtc]]
==== its-rtc
@ -444,9 +444,9 @@ Configuration]
Plugin to integrate with IBM Rational Team Concert (RTC).
link:https://gerrit-review.googlesource.com/admin/repos/plugins/its-rtc[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/its-rtc/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[its-storyboard]]
==== its-storyboard
@ -454,9 +454,9 @@ Configuration]
Plugin to integrate with Storyboard task tracking system.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/its-storyboard[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/its-storyboard/+doc/master/src/main/resources/Documentation/about.md[
Documentation]
Documentation,role=external,window=_blank]
[[javamelody]]
=== javamelody
@ -467,11 +467,11 @@ This plugin integrates JavaMelody in Gerrit in order to retrieve live
instrumentation data from Gerrit.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/javamelody[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/javamelody/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
https://gerrit.googlesource.com/plugins/javamelody/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[labelui]]
=== labelui
@ -482,9 +482,9 @@ table control to render the labels/approvals on the change screen
screen).
link:https://gerrit-review.googlesource.com/admin/repos/plugins/labelui[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/labelui/+doc/master/src/main/resources/Documentation/about.md[
Documentation]
Documentation,role=external,window=_blank]
[[menuextender]]
=== menuextender
@ -493,11 +493,11 @@ The menuextender plugin allows Gerrit administrators to configure
additional menu entries from the WebUI.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/menuextender[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/menuextender/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/menuextender/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[metrics-reporter-elasticsearch]]
=== metrics-reporter-elasticsearch
@ -505,7 +505,7 @@ Configuration]
This plugin reports Gerrit metrics to Elasticsearch.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/metrics-reporter-elasticsearch[
Project].
Project,role=external,window=_blank].
[[metrics-reporter-graphite]]
=== metrics-reporter-graphite
@ -513,7 +513,7 @@ Project].
This plugin reports Gerrit metrics to Graphite.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/metrics-reporter-graphite[
Project].
Project,role=external,window=_blank].
[[metrics-reporter-jmx]]
=== metrics-reporter-jmx
@ -521,7 +521,7 @@ Project].
This plugin reports Gerrit metrics to JMX.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/metrics-reporter-jmx[
Project].
Project,role=external,window=_blank].
[[metrics-reporter-prometheus]]
=== metrics-reporter-prometheus
@ -529,7 +529,7 @@ Project].
This plugin exposes Gerrit metrics for consumption by Prometheus.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/metrics-reporter-prometheus[
Project].
Project,role=external,window=_blank].
[[motd]]
=== motd
@ -541,11 +541,11 @@ the user (usually prefixed by “remote: ”), but will be silently
discarded otherwise.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/motd[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/motd/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/motd/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[oauth-authentication-provider]]
=== OAuth authentication provider
@ -563,16 +563,16 @@ Several OAuth2 providers are supported:
* Keycloak
* Office365
link:https://gerrit-review.googlesource.com/admin/repos/plugins/oauth[Project] |
link:https://gerrit.googlesource.com/plugins/oauth/+doc/master/src/main/resources/Documentation/config.md[Configuration]
link:https://gerrit-review.googlesource.com/admin/repos/plugins/oauth[Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/oauth/+doc/master/src/main/resources/Documentation/config.md[Configuration,role=external,window=_blank]
[[owners]]
=== owners
This plugin provides a Prolog predicate `add_owner_approval/3` that
appends `label('Owner-Approval', need(_))` to a provided list.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/owners[Project] |
link:https://gerrit.googlesource.com/plugins/owners/+doc/master/README.md[Documentation]
link:https://gerrit-review.googlesource.com/admin/repos/plugins/owners[Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/owners/+doc/master/README.md[Documentation,role=external,window=_blank]
[[project-download-commands]]
=== project-download-commands
@ -584,11 +584,11 @@ are inherited by the child projects. Child projects can overwrite the
inherited download command or remove it by assigning no value to it.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/project-download-commands[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/project-download-commands/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/project-download-commands/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[quota]]
=== quota
@ -600,21 +600,21 @@ that a project or group can consume. To do this a Gerrit administrator
can use this plugin to define quotas on project namespaces.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/quota[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/quota/+doc/master/src/main/resources/Documentation/about.md[
Documentation]
Documentation,role=external,window=_blank]
link:https://gerrit.googlesource.com/plugins/quota/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[rabbitmq]]
=== rabbitmq
A plugin that publishes Gerrit events to a
link:https://www.rabbitmq.com/[RabbitMQ] exchange.
link:https://www.rabbitmq.com/[RabbitMQ,role=external,window=_blank] exchange.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/rabbitmq[Project]
link:https://gerrit-review.googlesource.com/admin/repos/plugins/rabbitmq[Project,role=external,window=_blank]
link:https://gerrit.googlesource.com/plugins/rabbitmq/+/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[readonly]]
=== readonly
@ -623,11 +623,11 @@ A plugin that makes the Gerrit server read-only by rejecting git pushes,
blocking HTTP PUT/POST/DELETE requests, and disabling SSH commands.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/readonly[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/readonly/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/readonly/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[ref-protection]]
=== ref-protection
@ -638,9 +638,9 @@ Backups of deleted or non-fast-forward updated refs are created under the
`refs/backups/` namespace.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/ref-protection[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/ref-protection/+doc/master/src/main/resources/Documentation/about.md[
Documentation]
Documentation,role=external,window=_blank]
[[reparent]]
=== reparent
@ -648,11 +648,11 @@ Documentation]
A plugin that provides project reparenting as a self-service for project owners.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/reparent[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/reparent/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/reparent/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[review-strategy]]
=== review-strategy
@ -660,9 +660,9 @@ Configuration]
This plugin allows users to configure different review strategies.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/review-strategy[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/review-strategy/+doc/master/src/main/resources/Documentation/about.md[
Documentation]
Documentation,role=external,window=_blank]
[[reviewers]]
=== reviewers
@ -670,11 +670,11 @@ Documentation]
A plugin that allows adding default reviewers to a change.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/reviewers[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/reviewers/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/reviewers/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[reviewers-by-blame]]
=== reviewers-by-blame
@ -686,11 +686,11 @@ users should be familiar with the code and can mostly review the
change.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/reviewers-by-blame[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/reviewers-by-blame/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/reviewers-by-blame/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[groovy-provider]]
=== scripting/groovy-provider
@ -698,16 +698,16 @@ Configuration]
This plugin provides a Groovy runtime environment for Gerrit plugins in Groovy.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/scripting/groovy-provider[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/scripting/groovy-provider/+doc/master/src/main/resources/Documentation/about.md[
Documentation]
Documentation,role=external,window=_blank]
[[saml-authentication-provider]]
=== SAML2 authentication provider
This plugin enables Gerrit to use SAML2 protocol for authentication.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/saml[Project]
link:https://gerrit-review.googlesource.com/admin/repos/plugins/saml[Project,role=external,window=_blank]
[[scala-provider]]
=== scripting/scala-provider
@ -715,9 +715,9 @@ link:https://gerrit-review.googlesource.com/admin/repos/plugins/saml[Project]
This plugin provides a Scala runtime environment for Gerrit plugins in Scala.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/scripting/scala-provider[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/scripting/scala-provider/+doc/master/src/main/resources/Documentation/about.md[
Documentation]
Documentation,role=external,window=_blank]
[[scripts]]
=== scripts
@ -728,8 +728,8 @@ to provide simple and useful extensions.
Groovy and Scala scripts require the installation of the corresponding
scripting/*-provider plugin in order to be loaded into Gerrit.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/scripts[Project]
link:https://gerrit.googlesource.com/plugins/scripts/+doc/master/README.md[Documentation]
link:https://gerrit-review.googlesource.com/admin/repos/plugins/scripts[Project,role=external,window=_blank]
link:https://gerrit.googlesource.com/plugins/scripts/+doc/master/README.md[Documentation,role=external,window=_blank]
[[server-config]]
=== server-config
@ -741,7 +741,7 @@ where Gerrit's config files are stored is difficult or impossible to
get.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/server-config[
Project]
Project,role=external,window=_blank]
[[serviceuser]]
=== serviceuser
@ -754,11 +754,11 @@ Plugin in Jenkins. A service user is not able to login into the Gerrit
WebUI and it cannot push commits or tags.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/serviceuser[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/serviceuser/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/serviceuser/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[uploadvalidator]]
=== uploadvalidator
@ -770,11 +770,11 @@ and a maximum allowed path length. Pushes of commits that violate these
settings are rejected by Gerrit.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/uploadvalidator[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/uploadvalidator/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/uploadvalidator/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[verify-status]]
=== verify-status
@ -784,11 +784,11 @@ view them on the Gerrit UI. The metadata can be stored in the Gerrit database
or in a completely separate datastore.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/verify-status[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/verify-status/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/verify-status/+doc/master/src/main/resources/Documentation/database.md[
Configuration]
Configuration,role=external,window=_blank]
[[websession-flatfile]]
=== websession-flatfile
@ -799,11 +799,11 @@ among multiple Gerrit servers, making it useful for multi-master
Gerrit installations.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/websession-flatfile[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/websession-flatfile/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/websession-flatfile/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
[[x-docs]]
=== x-docs
@ -811,11 +811,11 @@ Configuration]
This plugin serves project documentation as HTML pages.
link:https://gerrit-review.googlesource.com/admin/repos/plugins/x-docs[
Project] |
Project,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/x-docs/+doc/master/src/main/resources/Documentation/about.md[
Documentation] |
Documentation,role=external,window=_blank] |
link:https://gerrit.googlesource.com/plugins/x-docs/+doc/master/src/main/resources/Documentation/config.md[
Configuration]
Configuration,role=external,window=_blank]
GERRIT

8
Documentation/config-sso.txt
View File

@ -17,7 +17,7 @@ setting should be `OpenID`:
As this is the default setting there is nothing required from the
site administrator to make use of the OpenID authentication services.
* http://openid.net/[openid.net]
* http://openid.net/[openid.net,,role=external,window=_blank]
If Jetty is being used, you may need to increase the header
buffer size parameter, due to very long header lines.
@ -34,7 +34,7 @@ must only have OpenIDs which match at least one pattern from the
`auth.trustedOpenID` list in `gerrit.config`. Patterns may be
either a
link:http://download.oracle.com/javase/6/docs/api/java/util/regex/Pattern.html[standard
Java regular expression (java.util.regex)] (must start with `^`
Java regular expression (java.util.regex),,role=external,window=_blank] (must start with `^`
and end with `$`) or be a simple prefix (any other string).
Out of the box Gerrit is configured to trust two patterns, which
@ -65,12 +65,12 @@ with that identity. Doing so will result in a new account being created, and
subsequent attempts to link that account with the existing account will fail.
In cases where this happens, the administrator will need to manually merge the
accounts. See link:https://gerrit.googlesource.com/homepage/+/md-pages/docs/SqlMergeUserAccounts.md[
Merging Gerrit User Accounts] on the Gerrit Wiki for details.
Merging Gerrit User Accounts,,role=external,window=_blank] on the Gerrit Wiki for details.
Linking another identity is also useful for users whose primary OpenID provider
shuts down. For example Google
link:https://developers.google.com/+/api/auth-migration[shut down their OpenID
service on 20th April 2015]. Users who failed to add an alternative identity with
service on 20th April 2015,,role=external,window=_blank]. Users who failed to add an alternative identity with
another OpenID provider before that date will end up with their account only having
a disabled Google identity. After creating a separate account with an alternative
provider, they will need to ask the administrator to merge the accounts using the

26
Documentation/dev-bazel.txt
View File

@ -8,10 +8,10 @@ To build Gerrit from source, you need:
* A Linux or macOS system (Windows is not supported at this time)
* A JDK for Java 8|9|10|11|...
* Python 2 or 3
* link:https://github.com/nodesource/distributions/blob/master/README.md[Node.js (including npm)]
* link:https://github.com/nodesource/distributions/blob/master/README.md[Node.js (including npm),role=external,window=_blank]
* Bower (`sudo npm install -g bower`)
* link:https://docs.bazel.build/versions/master/install.html[Bazel] directly
or through link:https://github.com/bazelbuild/bazelisk[Bazelisk]
* link:https://docs.bazel.build/versions/master/install.html[Bazel,role=external,window=_blank] directly
or through link:https://github.com/bazelbuild/bazelisk[Bazelisk,role=external,window=_blank]
* Maven
* zip, unzip
* gcc
@ -36,7 +36,7 @@ To check the installed version of Java, open a terminal window and run:
==== Java 13 support
Java 13 (and newer) is supported through vanilla java toolchain
link:https://docs.bazel.build/versions/master/toolchains.html[Bazel option].
link:https://docs.bazel.build/versions/master/toolchains.html[Bazel option,role=external,window=_blank].
To build Gerrit with Java 13 and newer, specify vanilla java toolchain and
provide the path to JDK home:
@ -96,7 +96,7 @@ To build Gerrit with Java 11, specify JDK 11 java toolchain:
```
=== Node.js and npm packages
See link:https://gerrit.googlesource.com/gerrit/+/master/polygerrit-ui/README.md#installing-node_js-and-npm-packages[Installing Node.js and npm packages].
See link:https://gerrit.googlesource.com/gerrit/+/master/polygerrit-ui/README.md#installing-node_js-and-npm-packages[Installing Node.js and npm packages,role=external,window=_blank].
[[build]]
== Building on the Command Line
@ -212,7 +212,7 @@ is not regenerated.
=== IntelliJ
The Gerrit build works with Bazel's link:https://ij.bazel.build[IntelliJ plugin].
The Gerrit build works with Bazel's link:https://ij.bazel.build[IntelliJ plugin,role=external,window=_blank].
Please follow the instructions on <<dev-intellij#,IntelliJ Setup>>.
=== Eclipse
@ -232,7 +232,7 @@ and then follow the link:dev-eclipse.html#setup[setup instructions].
If an updated classpath is needed, the Eclipse project can be
refreshed and missing dependency JARs can be downloaded by running
`project.py` again. For IntelliJ, you need to click the `Sync Project
with BUILD Files` button of link:https://ij.bazel.build[Bazel plugin].
with BUILD Files` button of link:https://ij.bazel.build[Bazel plugin,role=external,window=_blank].
[[documentation]]
=== Documentation
@ -342,11 +342,11 @@ The following values are currently supported for the group name:
Successfully running the Elasticsearch tests requires Docker, and
may require setting the local
link:https://www.elastic.co/guide/en/elasticsearch/reference/current/vm-max-map-count.html[virtual memory].
link:https://www.elastic.co/guide/en/elasticsearch/reference/current/vm-max-map-count.html[virtual memory,role=external,window=_blank].
If Docker is not available, the Elasticsearch tests will be skipped.
Note that Bazel currently does not show
link:https://github.com/bazelbuild/bazel/issues/3476[the skipped tests].
link:https://github.com/bazelbuild/bazel/issues/3476[the skipped tests,role=external,window=_blank].
== Dependencies
@ -459,7 +459,7 @@ To accelerate builds, several caches are activated per default:
* ~/.gerritcodereview/bazel-cache/cas
Currently none of these caches have a maximum size limit. See
link:https://github.com/bazelbuild/bazel/issues/5139[this bazel issue] for
link:https://github.com/bazelbuild/bazel/issues/5139[this bazel issue,role=external,window=_blank] for
details. Users should watch the cache sizes and clean them manually if
necessary.
@ -470,7 +470,7 @@ Parts of the PolyGerrit build require running NPM-based JavaScript programs as
"binaries". We don't attempt to resolve and download NPM dependencies at build
time, but instead use pre-built bundles of the NPM binary along with all its
dependencies. Some packages on
link:https://docs.npmjs.com/misc/registry[registry.npmjs.org] come with their
link:https://docs.npmjs.com/misc/registry[registry.npmjs.org,role=external,window=_blank] come with their
dependencies bundled, but this is the exception rather than the rule. More
commonly, to add a new binary to this list, you will need to bundle the binary
yourself.
@ -498,7 +498,7 @@ its transitive dependencies. We can only legally distribute a bundle via our
storage bucket if the licenses allow us to do so. As long as all of the listed
license are allowed by
link:https://opensource.google.com/docs/thirdparty/licenses/[Google's
standards]. Any `by_exception_only`, commercial, prohibited, or unlisted
standards,role=external,window=_blank]. Any `by_exception_only`, commercial, prohibited, or unlisted
licenses are not allowed; otherwise, it is ok to distribute the source. If in
doubt, contact a maintainer who is a Googler.
@ -523,7 +523,7 @@ This creates a file named `$package-$version.tgz` in your working directory.
Any project maintainer can upload this file to the
link:https://console.cloud.google.com/storage/browser/gerrit-maven/npm-packages[storage
bucket].
bucket,role=external,window=_blank].
Finally, add the new binary to the build process:
----

8
Documentation/dev-cla.txt
View File

@ -6,17 +6,17 @@ contributions are accepted. To view and accept the agreements do the
following:
. Click 'Sign In' at the top right corner of
https://gerrit-review.googlesource.com/
https://gerrit-review.googlesource.com/[role=external,window=_blank]
. Sign In with your Google account
. After signing in, go to the
link:https://gerrit-review.googlesource.com/#/settings/agreements[Agreements]
link:https://gerrit-review.googlesource.com/#/settings/agreements[Agreements,role=external,window=_blank]
tab on the settings page
. Click on 'New Contributor Agreement' and follow the instructions
For reference, the actual agreements are linked below:
* link:https://cla.developers.google.com/about/google-individual[Individual Agreement]
* link:https://cla.developers.google.com/about/google-corporate[Corporate Agreement]
* link:https://cla.developers.google.com/about/google-individual[Individual Agreement,role=external,window=_blank]
* link:https://cla.developers.google.com/about/google-corporate[Corporate Agreement,role=external,window=_blank]
GERRIT
------

14
Documentation/dev-community.txt
View File

@ -1,19 +1,19 @@
= Gerrit Community
Gerrit is developed as a
link:https://gerrit-review.googlesource.com/[self-hosting open source project]
link:https://gerrit-review.googlesource.com/[self-hosting open source project,role=external,window=_blank]
and very much welcomes contributions from anyone with a
link:dev-cla.html[contributor's agreement] on file with the project.
[[project-information]]
== Project Information
* link:https://www.gerritcodereview.com/[Project Homepage]
* link:https://www.gerritcodereview.com/codeofconduct.html[Code of Conduct]
* link:https://www.gerritcodereview.com/releases-readme.html[Release Versions]
* link:https://gerrit.googlesource.com/gerrit[Source]
* link:https://bugs.chromium.org/p/gerrit/issues/list[Issue Tracking]
* link:https://gerrit-review.googlesource.com/q/status:open+project:gerrit[Change Review]
* link:https://www.gerritcodereview.com/[Project Homepage,role=external,window=_blank]
* link:https://www.gerritcodereview.com/codeofconduct.html[Code of Conduct,role=external,window=_blank]
* link:https://www.gerritcodereview.com/releases-readme.html[Release Versions,role=external,window=_blank]
* link:https://gerrit.googlesource.com/gerrit[Source,role=external,window=_blank]
* link:https://bugs.chromium.org/p/gerrit/issues/list[Issue Tracking,role=external,window=_blank]
* link:https://gerrit-review.googlesource.com/q/status:open+project:gerrit[Change Review,role=external,window=_blank]
* link:dev-design.html[System Design]
* Processes
** link:dev-processes.html#project-governance[Project Governance / Engineering Steering Committee]

6
Documentation/dev-contributing.txt
View File

@ -33,7 +33,7 @@ link:dev-roles.html#maintainer[maintainers] can require to follow the
design-driven contribution process instead.
If you are in doubt which process is right for you, consult the
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss]
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss,role=external,window=_blank]
mailing list.
These contribution processes apply to everyone who contributes code to
@ -83,11 +83,11 @@ As Gerrit is a code review tool, naturally contributions will
be reviewed before they will get submitted to the code base. To
start your contribution, please make a git commit and upload it
for review to the link:https://gerrit-review.googlesource.com/[
gerrit-review.googlesource.com] Gerrit server. To help speed up the
gerrit-review.googlesource.com,role=external,window=_blank] Gerrit server. To help speed up the
review of your change, review these link:dev-crafting-changes.html[
guidelines] before submitting your change. You can view the pending
Gerrit contributions and their statuses
link:https://gerrit-review.googlesource.com/#/q/status:open+project:gerrit[here].
link:https://gerrit-review.googlesource.com/#/q/status:open+project:gerrit[here,role=external,window=_blank].
Depending on the size of that list it might take a while for
your change to get reviewed. Naturally there are fewer

6
Documentation/dev-core-plugins.txt
View File

@ -9,7 +9,7 @@ installed without downloading any additional files.
To make working with core plugins easy, they are linked as
link:https://gerrit.googlesource.com/gerrit/+/refs/heads/master/.gitmodules[Git
submodules] in the `gerrit` repository. E.g. this means they can be easily
submodules,role=external,window=_blank] in the `gerrit` repository. E.g. this means they can be easily
link:dev-readme.html#clone[cloned] together with Gerrit.
All core plugins are developed and maintained by the
@ -35,12 +35,12 @@ criteria:
1. License:
+
The plugin code is available under the
link:http://www.apache.org/licenses/LICENSE-2.0[Apache License Version 2.0].
link:http://www.apache.org/licenses/LICENSE-2.0[Apache License Version 2.0,role=external,window=_blank].
2. Hosting:
+
The plugin development is hosted on the
link:https://gerrit-review.googlesource.com[gerrit-review] Gerrit Server.
link:https://gerrit-review.googlesource.com[gerrit-review,role=external,window=_blank] Gerrit Server.
3. Scope:
+

10
Documentation/dev-crafting-changes.txt
View File

@ -86,10 +86,10 @@ To set up git's remote for easy pushing, run the following:
The HTTPS access requires proper username and password; this can be obtained
by clicking the 'Obtain Password' link on the
link:https://gerrit-review.googlesource.com/#/settings/http-password[HTTP
Password tab of the user settings page].
Password tab of the user settings page,role=external,window=_blank].
Alternately, you may use the
link:https://pypi.org/project/git-review/[git-review] tool to submit changes
link:https://pypi.org/project/git-review/[git-review,role=external,window=_blank] tool to submit changes
to Gerrit. If you do, it will set up the Change-Id hook and `gerrit` remote
for you. You will still need to do the HTTP access step.
@ -109,12 +109,12 @@ extend gerrit CI to take care of this, but it's not yet implemented.
Gerrit generally follows the
link:https://google.github.io/styleguide/javaguide.html[Google Java Style
Guide].
Guide,role=external,window=_blank].
To format Java source code, Gerrit uses the
link:https://github.com/google/google-java-format[`google-java-format`]
link:https://github.com/google/google-java-format[`google-java-format`,role=external,window=_blank]
tool (version 1.7), and to format Bazel BUILD, WORKSPACE and .bzl files the
link:https://github.com/bazelbuild/buildtools/tree/master/buildifier[`buildifier`]
link:https://github.com/bazelbuild/buildtools/tree/master/buildifier[`buildifier`,role=external,window=_blank]
tool (version 0.29.0).
These tools automatically apply format according to the style guides; this
streamlines code review by reducing the need for time-consuming, tedious,

6
Documentation/dev-design-docs.txt
View File

@ -72,7 +72,7 @@ It is expected that:
To propose a new design, upload a change to the
link:https://gerrit-review.googlesource.com/admin/repos/homepage[
homepage] repository that adds a new folder under `pages/design-docs/`
homepage,role=external,window=_blank] repository that adds a new folder under `pages/design-docs/`
which contains at least an `index.md` and a `uses-cases.md` file (see
link:#structure[design doc structure] above).
@ -87,7 +87,7 @@ to do it (which is not guaranteed to happen).
Only very few maintainers actively watch out for uploaded design docs.
To raise awareness you may want to send a notification to the
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss]
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss,role=external,window=_blank]
mailing list about your uploaded design doc. But the discussion should
not take place on the mailing list, comments should be made by reviewing
the change in Gerrit.
@ -122,7 +122,7 @@ scope of the project and if it can be accepted.
. Go to the
link:https://gerrit-review.googlesource.com/settings/#Notifications[
notification settings]
notification settings,role=external,window=_blank]
. Add a project watch for the `homepage` repository with the following
query: `dir:pages/design-docs`

12
Documentation/dev-design.txt
View File

@ -68,10 +68,10 @@ on a J2EE servlet container and an SQL database.
Since Gerrit 3.x link:note-db.html[NoteDb] replaced the SQL database
and all metadata is now stored in Git.
* link:http://video.google.com/videoplay?docid=-8502904076440714866[Mondrian Code Review On The Web]
* link:https://github.com/rietveld-codereview/rietveld[Rietveld - Code Review for Subversion]
* link:http://eagain.net/gitweb/?p=gitosis.git;a=blob;f=README.rst;hb=HEAD[Gitosis README]
* link:http://source.android.com/[Android Open Source Project]
* link:http://video.google.com/videoplay?docid=-8502904076440714866[Mondrian Code Review On The Web,role=external,window=_blank]
* link:https://github.com/rietveld-codereview/rietveld[Rietveld - Code Review for Subversion,role=external,window=_blank]
* link:http://eagain.net/gitweb/?p=gitosis.git;a=blob;f=README.rst;hb=HEAD[Gitosis README,role=external,window=_blank]
* link:http://source.android.com/[Android Open Source Project,role=external,window=_blank]
== Overview
@ -167,8 +167,8 @@ User authentication is handled by OpenID, and therefore Gerrit
requires that the OpenID provider selected by a user must be
online and operating in order to authenticate that user.
* link:http://www.kernel.org/pub/software/scm/git/docs/gitrepository-layout.html[Git Repository Format]
* link:http://openid.net/developers/specs/[OpenID Specifications]
* link:http://www.kernel.org/pub/software/scm/git/docs/gitrepository-layout.html[Git Repository Format,role=external,window=_blank]
* link:http://openid.net/developers/specs/[OpenID Specifications,role=external,window=_blank]
*1 Although an effort is underway to eliminate the use of the
database altogether, and to store all the metadata directly in

6
Documentation/dev-e2e-tests.txt
View File

@ -8,9 +8,9 @@ under different load profiles.
== What is Gatling?
Gatling is a load testing tool which provides out of the box support for the HTTP protocol. Documentation on how to write an
HTTP load test can be found link:https://gatling.io/docs/current/http/http_protocol/[`here`].
HTTP load test can be found link:https://gatling.io/docs/current/http/http_protocol/[`here`,role=external,window=_blank].
However, in the scenario we are proposing, we are leveraging the link:https://github.com/GerritForge/gatling-git[`Gatling Git extension`]
However, in the scenario we are proposing, we are leveraging the link:https://github.com/GerritForge/gatling-git[`Gatling Git extension`,role=external,window=_blank]
to run tests at Git protocol level.
Gatling is written in Scala, but the abstraction provided by the Gatling DSL makes the scenarios implementation easy even without any Scala knowledge.
@ -32,7 +32,7 @@ sbt compile
==== Setup
If you are running SSH commands the private keys of the users used for testing need to go in `/tmp/ssh-keys`.
The keys need to be generated this way (JSch won't validate them [otherwise](https://stackoverflow.com/questions/53134212/invalid-privatekey-when-using-jsch):
The keys need to be generated this way (JSch won't validate them [otherwise,role=external,window=_blank](https://stackoverflow.com/questions/53134212/invalid-privatekey-when-using-jsch):
----
ssh-keygen -m PEM -t rsa -C "test@mail.com" -f /tmp/ssh-keys/id_rsa

6
Documentation/dev-eclipse.txt
View File

@ -8,7 +8,7 @@ Java 8 or later SDK is require
[[setup]]
== Project Setup
In your Eclipse installation's link:https://wiki.eclipse.org/Eclipse.ini[`eclipse.ini`] file,
In your Eclipse installation's link:https://wiki.eclipse.org/Eclipse.ini[`eclipse.ini`,role=external,window=_blank] file,
add the following line in the `vmargs` section:
----
@ -60,13 +60,13 @@ Java 8 is still the default:
== Code Formatter Settings
To format source code, Gerrit uses the
link:https://github.com/google/google-java-format[`google-java-format`]
link:https://github.com/google/google-java-format[`google-java-format`,role=external,window=_blank]
tool (version 1.7), which automatically formats code to follow the
style guide. See link:dev-crafting-changes.html#style[Code Style] for the
instruction how to set up command line tool that uses this formatter.
The Eclipse plugin is provided that allows to format with the same
formatter from within the Eclipse IDE. See
link:https://github.com/google/google-java-format#eclipse[Eclipse plugin]
link:https://github.com/google/google-java-format#eclipse[Eclipse plugin,role=external,window=_blank]
for details how to install it. It's important to use the same plugin version
as the `google-java-format` script.

4
Documentation/dev-inspector.txt
View File

@ -33,7 +33,7 @@ and/or destroy the data.
Gerrit Inspector requires Jython library ('jython.jar') to be installed
in the '$site_path/lib' directory. Jython, a Python interpreter for
the Java Virtual Machine, can be obtained from the http://www.jython.org/
the Java Virtual Machine, can be obtained from the http://www.jython.org/[role=external,window=_blank]
website. Only 'jython.jar' file is needed, installation of Jython libraries
is optional. Gerrit Inspector has been tested with Jython 2.5.2 but
might work an earlier version.
@ -87,7 +87,7 @@ members are also available.
For more information on using Jython, especially with regards to its limitations
in interfacing to the Java Virtual Machine, please refer to the
http://www.jython.org/[Jython documentation].
http://www.jython.org/[Jython documentation,role=external,window=_blank].
After successful initialization it is possible to examine components of
Java packages, classes and live instances.

10
Documentation/dev-intellij.txt
View File

@ -14,7 +14,7 @@ for Java 8 from the command line first. Ensure that at least
=== IntelliJ version and Bazel plugin
Before downloading IntelliJ, look at the
link:https://plugins.jetbrains.com/plugin/8609-bazel/versions[JetBrains plugin repository page of the Bazel plugin]
link:https://plugins.jetbrains.com/plugin/8609-bazel/versions[JetBrains plugin repository page of the Bazel plugin,role=external,window=_blank]
to see what version of the IntelliJ IDEA it is actually compatible with.
Also note that the version of the Bazel plugin used in turn may or may not be
@ -30,7 +30,7 @@ indicates that the Bazel plugin couldn't find Java 8.
=== Installation of IntelliJ IDEA
Please refer to the
link:https://www.jetbrains.com/help/idea/installation-guide.html[installation guide provided by Jetbrains]
link:https://www.jetbrains.com/help/idea/installation-guide.html[installation guide provided by Jetbrains,role=external,window=_blank]
to install it on your platform. Make sure to install a version compatible with
the Bazel plugin as mentioned above.
@ -47,7 +47,7 @@ link:https://github.com/bazelbuild/intellij[build it from source].
. Search for the plugin `Bazel` (by Google).
+
TIP: In case the Bazel plugin is not listed, or if it shows an outdated version,
verify the compatibility between the Bazel plugin and IntelliJ IDEA on link:https://plugins.jetbrains.com/plugin/8609-bazel/versions[the JetBrains plugin page].
verify the compatibility between the Bazel plugin and IntelliJ IDEA on link:https://plugins.jetbrains.com/plugin/8609-bazel/versions[the JetBrains plugin page,role=external,window=_blank].
. Install it.
. Restart IntelliJ IDEA.
@ -117,7 +117,7 @@ to be as close as possible. So before submitting code, please make sure to run
. Download
https://raw.githubusercontent.com/google/styleguide/gh-pages/intellij-java-google-style.xml[
intellij-java-google-style.xml].
intellij-java-google-style.xml,role=external,window=_blank].
. Go to *File -> Settings -> Editor -> Code Style*.
. Click on the wrench icon with the tooltip _Show Scheme Actions_.
. Click on *Import Scheme*.
@ -196,7 +196,7 @@ At the moment running this (local) configuration results in a
use the instructions of <<dev-readme#run_daemon,Running the Daemon>> in
combination with <<remote-debug,Debugging a remote Gerrit server>>.
(link:https://bugs.chromium.org/p/gerrit/issues/detail?id=11360[Issue 11360])
(link:https://bugs.chromium.org/p/gerrit/issues/detail?id=11360[Issue 11360,role=external,window=_blank])
====
Copy `$(gerrit_source_code)/tools/intellij/gerrit_daemon.xml` to

30
Documentation/dev-plugins-lifecycle.txt
View File

@ -1,7 +1,7 @@
= Plugin Lifecycle
Most of the plugins are hosted on the same instance as the
link:https://gerrit-review.googlesource.com[Gerrit project itself] to make them
link:https://gerrit-review.googlesource.com[Gerrit project itself,role=external,window=_blank] to make them
more discoverable and have more chances to be reviewed by the whole community.
[[hosting_lifecycle]]
@ -12,7 +12,7 @@ The process of writing a new plugin goes through different phases:
- Ideation and Discussion:
+
The idea of creating a new plugin is posted and discussed on the
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss] mailing list.
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss,role=external,window=_blank] mailing list.
+
Also see section link#ideation_discussion[Ideation and discussion] below.
@ -27,14 +27,14 @@ Also see section link#plugin_prototyping[Plugin Prototyping] below.
+
The author proposes to release the plugin under the
link:https://www.apache.org/licenses/LICENSE-2.0.html[Apache 2.0 OpenSource
license] and requests the plugin to be hosted on
link:https://gerrit-review.googlesource.com[the Gerrit project site]. The
license,role=external,window=_blank] and requests the plugin to be hosted on
link:https://gerrit-review.googlesource.com[the Gerrit project site,role=external,window=_blank]. The
proposal must be accepted by at least one Gerrit maintainer. In case of
disagreement between maintainers, the issue can be escalated to the
link:dev-processes.html#steering-committee[Engineering Steering Committee]. If
the plugin is accepted, the Gerrit maintainer creates the project under the
plugins path on link:https://gerrit-review.googlesource.com[the Gerrit project
site].
site,role=external,window=_blank].
+
Also see section link#plugin_proposal[Plugin Proposal] below.
@ -42,7 +42,7 @@ Also see section link#plugin_proposal[Plugin Proposal] below.
+
To make the consumption of the plugin easy and to notice plugin breakages early
the plugin author should setup build jobs on
link:https://gerrit-ci.gerritforge.com[the GerritForge CI] that build the
link:https://gerrit-ci.gerritforge.com[the GerritForge CI,role=external,window=_blank] that build the
plugin for each Gerrit version that it supports.
+
Also see section link#build[Build] below.
@ -58,7 +58,7 @@ below.
- Release:
+
The author releases the plugin by creating a Git tag and announcing the plugin
on the link:https://groups.google.com/d/forum/repo-discuss[repo-discuss]
on the link:https://groups.google.com/d/forum/repo-discuss[repo-discuss,role=external,window=_blank]
mailing list.
+
Also see section link#plugin_release[Plugin release] below.
@ -84,7 +84,7 @@ identification of a gap in the Gerrit Code Review product but evolves with the
contribution of ideas and suggestions by the whole community.
The ideator of the plugin starts with an RFC (Request For Comments) post on the
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss] mailing list
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss,role=external,window=_blank] mailing list
with a description of the main reasons for starting a new plugin.
Example of a post:
@ -138,9 +138,9 @@ and try the plugin themselves.
The author decides that the plugin prototype makes sense as a general purpose
plugin and decides to release the code with the same
link:https://www.apache.org/licenses/LICENSE-2.0.html[Apache 2.0 license]
link:https://www.apache.org/licenses/LICENSE-2.0.html[Apache 2.0 license,role=external,window=_blank]
as the Gerrit Code Review project and have it hosted on
link:https://gerrit-review.googlesource.com[the Gerrit project site].
link:https://gerrit-review.googlesource.com[the Gerrit project site,role=external,window=_blank].
The plugin author formalizes the proposal with a follow-up of the initial RFC
post and asks for public opinion on it.
@ -167,7 +167,7 @@ project; the result of the discussion can end up in one of the following cases:
- The plugin's project request is widely appreciated and formally accepted by
at least one Gerrit maintainer who creates the repository as child project of
'Public-Projects' on link:https://gerrit-review.googlesource.com[the Gerrit
project site], creates an associated plugin owners group with "Owner"
project site,role=external,window=_blank], creates an associated plugin owners group with "Owner"
permissions for the plugin and adds the plugin's author as member of it.
- The plugin's project is widely appreciated; however, another existing plugin
already partially covers the same use-case and thus it would make more sense
@ -177,15 +177,15 @@ project; the result of the discussion can end up in one of the following cases:
- The plugin's project is found useful; however, it is too specific to the
author's use-case and would not make sense outside of it. The plugin remains
in a public repository, widely accessible and OpenSource, but not hosted on
link:https://gerrit-review.googlesource.com[the Gerrit project site].
link:https://gerrit-review.googlesource.com[the Gerrit project site,role=external,window=_blank].
[[build]]
== Build
The plugin's maintainer creates a job on the
link:https://gerrit-ci.gerritforge.com[GerritForge CI] by creating a new YAML
link:https://gerrit-ci.gerritforge.com[GerritForge CI,role=external,window=_blank] by creating a new YAML
definition in the link:https://gerrit.googlesource.com/gerrit-ci-scripts[Gerrit
CI Scripts] repository.
CI Scripts,role=external,window=_blank] repository.
Example of a YAML CI job for plugins:
@ -203,7 +203,7 @@ Example of a YAML CI job for plugins:
The plugin follows the same lifecycle as Gerrit Code Review and needs to be
kept up-to-date with the current active branches, according to the
link:https://www.gerritcodereview.com/#support[current support policy].
link:https://www.gerritcodereview.com/#support[current support policy,role=external,window=_blank].
During the development, the plugin's maintainer can reward contributors
requesting to be more involved and making them maintainers of his plugin,
adding them to the list of the project owners.

20
Documentation/dev-plugins.txt
View File

@ -36,7 +36,7 @@ Most of this documentation refers to either type as a plugin.
To get started with the development of a plugin, take a look at
the samples in the
link:https://gerrit.googlesource.com/plugins/examples[examples plugin project].
link:https://gerrit.googlesource.com/plugins/examples[examples plugin project,role=external,window=_blank].
This is a project that demonstrates the various features of the
plugin API. It can be taken as an example to develop an own plugin.
@ -367,7 +367,7 @@ from the hosting server.
Plugins are loaded from a single JAR file. If a plugin needs
additional libraries, it must include those dependencies within
its own JAR. Plugins built using Maven may be able to use the
link:http://maven.apache.org/plugins/maven-shade-plugin/[shade plugin]
link:http://maven.apache.org/plugins/maven-shade-plugin/[shade plugin,role=external,window=_blank]
to package additional dependencies. Relocating (or renaming) classes
should not be necessary due to the ClassLoader isolation.
@ -2189,7 +2189,7 @@ basis.
Gerrit provides an extension point that enables development of
link:https://github.com/github/git-lfs/blob/master/docs/api/v1/http-v1-batch.md[
LFS (Large File Storage)] storage plugins. Gerrit core exposes the default LFS
LFS (Large File Storage),role=external,window=_blank] storage plugins. Gerrit core exposes the default LFS
protocol endpoint `<project-name>/info/lfs/objects/batch` and forwards the requests
to the configured link:config-gerrit.html#lfs[lfs.plugin] plugin which implements
the LFS protocol. By exposing the default LFS endpoint, the git-lfs client can be
@ -2247,16 +2247,16 @@ public class S3LargeFileRepository extends S3Repository {
To send Gerrit's metrics data to an external reporting backend, a plugin can
get a `MetricRegistry` injected and register an instance of a class that
implements the `Reporter` interface from link:http://metrics.dropwizard.io/[
DropWizard Metrics].
DropWizard Metrics,role=external,window=_blank].
Metric reporting plugin implementations are provided for
link:https://gerrit.googlesource.com/plugins/metrics-reporter-jmx/[JMX],
link:https://gerrit.googlesource.com/plugins/metrics-reporter-elasticsearch/[Elastic Search],
and link:https://gerrit.googlesource.com/plugins/metrics-reporter-graphite/[Graphite].
link:https://gerrit.googlesource.com/plugins/metrics-reporter-jmx/[JMX,role=external,window=_blank],
link:https://gerrit.googlesource.com/plugins/metrics-reporter-elasticsearch/[Elastic Search,role=external,window=_blank],
and link:https://gerrit.googlesource.com/plugins/metrics-reporter-graphite/[Graphite,role=external,window=_blank].
There is also a working example of reporting metrics to the console in the
link:https://gerrit.googlesource.com/plugins/cookbook-plugin/+/master/src/main/java/com/googlesource/gerrit/plugins/cookbook/ConsoleMetricReporter.java[
cookbook plugin].
cookbook plugin,role=external,window=_blank].
=== Providing own metrics
@ -2293,7 +2293,7 @@ will cause the metrics to be recorded under `my-metrics/${metric-name}`.
See the replication metrics in the
link:https://gerrit.googlesource.com/plugins/replication/+/master/src/main/java/com/googlesource/gerrit/plugins/replication/ReplicationMetrics.java[
replication plugin] for an example of usage.
replication plugin,role=external,window=_blank] for an example of usage.
[[account-patch-review-store]]
== AccountPatchReviewStore
@ -2338,7 +2338,7 @@ prefix is configurable by setting the `Gerrit-HttpDocumentationPrefix`
attribute.
Documentation may be written in the Markdown flavor
link:https://github.com/vsch/flexmark-java[flexmark-java]
link:https://github.com/vsch/flexmark-java[flexmark-java,role=external,window=_blank]
if the file name ends with `.md`. Gerrit will automatically convert
Markdown to HTML if accessed with extension `.html`.

14
Documentation/dev-processes.txt
View File

@ -30,7 +30,7 @@ The steering committee has 5 members:
period of 1 year (see link:#steering-committee-election[below])
Refer to the project homepage for the link:https://www.gerritcodereview.com/members.html#engineering-steering-committee[
list of current committee members].
list of current committee members,role=external,window=_blank].
The steering committee should act in the interest of the Gerrit project
and the whole Gerrit community.
@ -84,7 +84,7 @@ See link:dev-design-docs.html#review[here].
[[versioning]]
== Semantic versioning
Gerrit follows a light link:https://semver.org/[semantic versioning scheme] MAJOR.MINOR[.PATCH[.HOTFIX]]
Gerrit follows a light link:https://semver.org/[semantic versioning scheme,role=external,window=_blank] MAJOR.MINOR[.PATCH[.HOTFIX]]
format:
* MAJOR is incremented when there are substantial incompatible changes and/or
@ -182,7 +182,7 @@ available.
To report a security vulnerability file a
link:https://bugs.chromium.org/p/gerrit/issues/entry?template=Security+Issue[
security issue] in the Gerrit issue tracker. The visibility of issues that are
security issue,role=external,window=_blank] in the Gerrit issue tracker. The visibility of issues that are
created with the `Security Issue` template is automatically restricted to
Gerrit maintainers and a few long-term contributors. This means as a reporter
you may not be able to see the issue once it is created. Security issues are
@ -222,7 +222,7 @@ community is informed about the security vulnerability with the advise to
address the security vulnerability immediately (either by upgrading to a fixed
release or applying the mitigation). The information about the security
vulnerability is disclosed via the
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss] mailing list.
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss,role=external,window=_blank] mailing list.
[[handle-security-issue]]
=== Handling of the Security Vulnerability
@ -253,7 +253,7 @@ link:intro-user.html[security-fixes]).
+
Instead security fixes should be implemented and reviewed in the non-public
link:https://gerrit-review.googlesource.com/admin/repos/gerrit-security-fixes[
gerrit-security-fixes] repository which is only accessible by Gerrit
gerrit-security-fixes,role=external,window=_blank] repository which is only accessible by Gerrit
maintainers and Gerrit community members that work on security fixes.
+
The change that fixes the security vulnerability should contain an integration
@ -284,7 +284,7 @@ The announcement should recommend to upgrade to fixed releases immediately.
Once all releases are ready and tested and the announcement is prepared, the
releases should be all published at the same time. Immediately after that, the
announcement should be sent out to the
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss] mailing list.
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss,role=external,window=_blank] mailing list.
+
This ends the embargo and any issue that discusses the security vulnerability
should be made public.
@ -293,7 +293,7 @@ should be made public.
+
The ESC should discuss if there are any learnings from the security
vulnerability and define action items to follow up in the
link:https://bugs.chromium.org/p/gerrit[issue tracker].
link:https://bugs.chromium.org/p/gerrit[issue tracker,role=external,window=_blank].
[[core-plugins]]
== Core Plugins

4
Documentation/dev-readme.txt
View File

@ -1,6 +1,6 @@
= Gerrit Code Review: Developer Setup
To build a developer instance, you'll need link:https://bazel.build/[Bazel] to
To build a developer instance, you'll need link:https://bazel.build/[Bazel,role=external,window=_blank] to
compile the code.
== Git Setup
@ -31,7 +31,7 @@ the submodules.
CAUTION: If you store Eclipse or IntelliJ project files in the Gerrit source
directories, do *_not_* run `git clean -fdx`. Doing so may remove untracked files and damage your project. For more information, see
link:https://git-scm.com/docs/git-clean[git-clean].
link:https://git-scm.com/docs/git-clean[git-clean,role=external,window=_blank].
Run the following:

12
Documentation/dev-release-deploy-config.txt
View File

@ -11,7 +11,7 @@ To be able to publish artifacts to Maven Central some preparations must
be done:
* Create an account on
link:https://issues.sonatype.org/secure/Signup!default.jspa[Sonatype's Jira].
link:https://issues.sonatype.org/secure/Signup!default.jspa[Sonatype's Jira,role=external,window=_blank].
+
Sonatype is the company that runs Maven Central and you need a Sonatype
account to be able to upload artifacts to Maven Central.
@ -30,7 +30,7 @@ account to be able to upload artifacts to Maven Central.
repository on Maven Central:
+
Ask for this permission by adding a comment on the
link:https://issues.sonatype.org/browse/OSSRH-7392[OSSRH-7392] Jira
link:https://issues.sonatype.org/browse/OSSRH-7392[OSSRH-7392,role=external,window=_blank] Jira
ticket at Sonatype.
+
The request needs to be approved by someone who already has this
@ -43,7 +43,7 @@ the upload to Maven Central, and to sign the release announcement email.
+
Generate and publish a PGP key as described in
link:http://central.sonatype.org/pages/working-with-pgp-signatures.html[
Working with PGP Signatures]. In addition to the keyserver mentioned
Working with PGP Signatures,role=external,window=_blank]. In addition to the keyserver mentioned
there it is recommended to also publish the key to the
link:https://keyserver.ubuntu.com/[Ubuntu key server].
+
@ -51,7 +51,7 @@ Please be aware that after publishing your public key it may take a
while until it is visible to the Sonatype server.
+
Add an entry for the public key in the
link:https://gerrit.googlesource.com/homepage/+/md-pages/releases/public-keys.md[key list]
link:https://gerrit.googlesource.com/homepage/+/md-pages/releases/public-keys.md[key list,role=external,window=_blank]
on the homepage.
+
The PGP passphrase can be put in `~/.m2/settings.xml`:
@ -80,7 +80,7 @@ It can also be included in the key chain on OS X.
Gerrit Subproject Artifacts are stored on
link:https://developers.google.com/storage/[Google Cloud Storage].
Via the link:https://console.developers.google.com/project/164060093628[Developers Console] the
Via the link:https://console.developers.google.com/project/164060093628[Developers Console,role=external,window=_blank] the
Gerrit maintainers have access to the `Gerrit Code Review` project.
This projects host several buckets for storing Gerrit artifacts:
@ -96,7 +96,7 @@ Bucket to store Gerrit Subproject Artifacts (e.g. Prolog Cafe).
To upload artifacts to a bucket the user must authenticate with a
username and password. The username and password need to be retrieved
from the link:https://console.cloud.google.com/storage/settings?project=api-project-164060093628[
Storage Setting in the Google Cloud Platform Console]:
Storage Setting in the Google Cloud Platform Console,role=external,window=_blank]:
Select the `Interoperability` tab, and if no keys are listed under
`Interoperable storage access keys`, select 'Create a new key'.

2
Documentation/dev-release-jgit.txt
View File

@ -2,7 +2,7 @@
This step is only necessary if we need to create an unofficial JGit
snapshot release and publish it to the
link:https://developers.google.com/storage/[Google Cloud Storage].
link:https://developers.google.com/storage/[Google Cloud Storage,role=external,window=_blank].
[[prepare-environment]]
== Prepare the Maven Environment

24
Documentation/dev-release.txt
View File

@ -158,14 +158,14 @@ the `version.bzl` file:
** SNAPSHOT versions are directly uploaded into the Sonatype snapshots
repository and no further action is needed:
+
https://oss.sonatype.org/content/repositories/snapshots/com/google/gerrit/
https://oss.sonatype.org/content/repositories/snapshots/com/google/gerrit/[role=external,window=_blank]
** Release versions are uploaded into a staging repository in the
link:https://oss.sonatype.org/[Sonatype Nexus Server].
* Verify the staging repository
** Go to the link:https://oss.sonatype.org/[Sonatype Nexus Server] and
** Go to the link:https://oss.sonatype.org/[Sonatype Nexus Server,role=external,window=_blank] and
sign in with your Sonatype credentials.
** Click on 'Build Promotion' in the left navigation bar under
@ -188,7 +188,7 @@ modified anymore, but you may still drop it if you find any issues.
** Test closed staging repository
+
Once a repository is closed you can find the URL to it in the `Summary`
section, e.g. https://oss.sonatype.org/content/repositories/comgooglegerrit-1029
section, e.g. https://oss.sonatype.org/content/repositories/comgooglegerrit-1029[role=external,window=_blank]
+
Use this URL for further testing of the artifacts in this repository,
e.g. to try building a plugin against the plugin API in this repository
@ -207,7 +207,7 @@ update the version in the `*_pom.xml` and configure the repository:
+
How to release a staging repository is described in the
link:https://docs.sonatype.org/display/Repository/Sonatype+OSS+Maven+Repository+Usage+Guide#SonatypeOSSMavenRepositoryUsageGuide-8.a.2.ReleasingaStagingRepository[
Sonatype OSS Maven Repository Usage Guide].
Sonatype OSS Maven Repository Usage Guide,role=external,window=_blank].
+
[WARNING]
Releasing artifacts to Maven Central cannot be undone!
@ -217,17 +217,17 @@ link:https://oss.sonatype.org/[Sonatype Nexus Server], select it and
click on `Release`.
** The released artifacts are available in
https://oss.sonatype.org/content/repositories/releases/com/google/gerrit/
https://oss.sonatype.org/content/repositories/releases/com/google/gerrit/[role=external,window=_blank]
** It may take up to 2 hours until the artifacts appear on Maven
Central:
+
http://central.maven.org/maven2/com/google/gerrit/
http://central.maven.org/maven2/com/google/gerrit/[role=external,window=_blank]
* [optional]: View download statistics
** Sign in to the
link:https://oss.sonatype.org/[Sonatype Nexus Server].
link:https://oss.sonatype.org/[Sonatype Nexus Server,role=external,window=_blank].
** Click on 'Views/Repositories' in the left navigation bar under
'Central Statistics'.
@ -239,7 +239,7 @@ link:https://oss.sonatype.org/[Sonatype Nexus Server].
==== Publish the Gerrit WAR to the Google Cloud Storage
* go to the link:https://console.cloud.google.com/storage/browser/gerrit-releases/?project=api-project-164060093628[
gerrit-releases bucket in the Google cloud storage console]
gerrit-releases bucket in the Google cloud storage console,role=external,window=_blank]
* make sure you are signed in with your Gmail account
* manually upload the Gerrit WAR file by using the `Upload` button
@ -248,7 +248,7 @@ gerrit-releases bucket in the Google cloud storage console]
* Create the stable branch `stable-$version` in the `gerrit` project via the
link:https://gerrit-review.googlesource.com/admin/repos/gerrit,branches[
Gerrit Web UI] or by push.
Gerrit Web UI,role=external,window=_blank] or by push.
* Push the commits done on `stable-$version` to `refs/for/stable-$version` and
get them merged.
@ -282,7 +282,7 @@ Push the new Release Tag on the plugins:
* Upload the files manually via web browser to the appropriate folder
in the
link:https://console.cloud.google.com/storage/browser/gerrit-documentation/?project=api-project-164060093628[
gerrit-documentation] storage bucket.
gerrit-documentation,role=external,window=_blank] storage bucket.
[[finalize-release-notes]]
=== Finalize the Release Notes
@ -298,7 +298,7 @@ latest version bold.
==== Update homepage links
Upload a change on the link:https://gerrit-review.googlesource.com/admin/repos/homepage[
homepage project] to change the version numbers to the new version.
homepage project,role=external,window=_blank] to change the version numbers to the new version.
[[update-issues]]
==== Update the Issues
@ -364,7 +364,7 @@ none of the changes/fixes ever get lost.
Bazlets is used by gerrit plugins to simplify build process. To allow the
new released version to be used by gerrit plugins,
link:https://gerrit.googlesource.com/bazlets/+/master/gerrit_api.bzl#8[gerrit_api.bzl]
link:https://gerrit.googlesource.com/bazlets/+/master/gerrit_api.bzl#8[gerrit_api.bzl,role=external,window=_blank]
must reference the new version. Upload a change to bazlets repository with
api version upgrade.

50
Documentation/dev-roles.txt
View File

@ -14,19 +14,19 @@ Gerrit community or get in touch by other means.
There are many possibilities to support the project, e.g.:
* get involved in discussions on the
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss]
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss,role=external,window=_blank]
mailing list (post your questions, provide feedback, share your
experiences, help other users)
* attend community events like user summits (see
link:https://calendar.google.com/calendar?cid=Z29vZ2xlLmNvbV91YmIxcGxhNmlqNzg1b3FianI2MWg0dmRpc0Bncm91cC5jYWxlbmRhci5nb29nbGUuY29t[
community calendar])
* report link:https://bugs.chromium.org/p/gerrit/issues/list[issues]
community calendar,role=external,window=_blank])
* report link:https://bugs.chromium.org/p/gerrit/issues/list[issues,role=external,window=_blank]
and help to clarify existing issues
* provide feedback on
link:https://www.gerritcodereview.com/releases-readme.html[new
releases and release candidates]
releases and release candidates,role=external,window=_blank]
* review
link:https://gerrit-review.googlesource.com/q/status:open[changes]
link:https://gerrit-review.googlesource.com/q/status:open[changes,role=external,window=_blank]
and help to verify that they work as advertised, comment if you like
or dislike a feature
* serve as contact person for a proprietary Gerrit installation and
@ -35,7 +35,7 @@ There are many possibilities to support the project, e.g.:
Supporters can:
* post on the
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss]
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss,role=external,window=_blank]
mailing list (Please note that the `repo-discuss` mailing list is
managed to prevent spam posts. This means posts from new participants
must be approved manually before they appear on the mailing list.
@ -43,7 +43,7 @@ Supporters can:
participate in mailing list discussions frequently are approved
automatically)
* comment on
link:https://gerrit-review.googlesource.com/q/status:open[changes]
link:https://gerrit-review.googlesource.com/q/status:open[changes,role=external,window=_blank]
and vote from `-1` to `+1` on the `Code-Review` label (these votes
are important to understand the interest in a change and to address
concerns early, however link:#maintainer[maintainers] can
@ -53,7 +53,7 @@ Supporters can:
permissions to vote on the `Verified` label are granted by request,
see below)
* file issues in the link:https://bugs.chromium.org/p/gerrit/issues/list[
issue tracker] and comment on existing issues
issue tracker,role=external,window=_blank] and comment on existing issues
* support the
link:dev-processes.html#design-driven-contribution-process[
design-driven contribution process] by reviewing incoming
@ -62,7 +62,7 @@ Supporters can:
Supporters who want to engage further can get additional privileges
on request (ask for it on the
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss]
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss,role=external,window=_blank]
mailing list):
* become member of the `gerrit-verifiers` group, which allows to:
@ -71,10 +71,10 @@ mailing list):
** edit topics on all open changes
** abandon changes
* approve posts to the
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss]
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss,role=external,window=_blank]
mailing list
* administrate issues in the
link:https://bugs.chromium.org/p/gerrit/issues/list[issue tracker]
link:https://bugs.chromium.org/p/gerrit/issues/list[issue tracker,role=external,window=_blank]
Supporters can become link:#contributor[contributors] by signing a
contributor license agreement and contributing code to the Gerrit
@ -87,7 +87,7 @@ Everyone who has a valid link:dev-cla.html[contributor license
agreement] and who has link:dev-contributing.html[contributed] at least
one change to any project on
link:https://gerrit-review.googlesource.com/[
gerrit-review.googlesource.com] is a contributor.
gerrit-review.googlesource.com,role=external,window=_blank] is a contributor.
Contributions can be:
@ -123,10 +123,10 @@ done.
Contributors may also be invited to join the Gerrit hackathons which
happen regularly (e.g. twice a year). Hackathons are announced on the
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss]
link:https://groups.google.com/d/forum/repo-discuss[repo-discuss,role=external,window=_blank]
mailing list (also see
link:https://calendar.google.com/calendar?cid=Z29vZ2xlLmNvbV91YmIxcGxhNmlqNzg1b3FianI2MWg0dmRpc0Bncm91cC5jYWxlbmRhci5nb29nbGUuY29t[
community calendar]).
community calendar,role=external,window=_blank]).
Outstanding contributors that are actively engaged in the community, in
activities outlined above, may be nominated as link:#maintainer[
@ -138,7 +138,7 @@ maintainers].
Maintainers are the gatekeepers of the project and are in charge of
approving and submitting changes. Refer to the project homepage for
the link:https://www.gerritcodereview.com/members.html#maintainers[
list of current maintainers].
list of current maintainers,role=external,window=_blank].
Maintainers should only approve changes that:
@ -185,20 +185,20 @@ Maintainers can:
link:dev-processes.html#project-governance[Project Governance]
* nominate new maintainers and vote on nominations (see below)
* administrate the link:https://groups.google.com/d/forum/repo-discuss[
mailing list], the
link:https://bugs.chromium.org/p/gerrit/issues/list[issue tracker]
and the link:https://www.gerritcodereview.com/[homepage]
mailing list,role=external,window=_blank], the
link:https://bugs.chromium.org/p/gerrit/issues/list[issue tracker,role=external,window=_blank]
and the link:https://www.gerritcodereview.com/[homepage,role=external,window=_blank]
* gain permissions to do Gerrit releases and publish release artifacts
* create new projects and groups on
link:https://gerrit-review.googlesource.com/[
gerrit-review.googlesource.com]
gerrit-review.googlesource.com,role=external,window=_blank]
* administrate the Gerrit projects on
link:https://gerrit-review.googlesource.com/[
gerrit-review.googlesource.com] (e.g. edit ACLs, update project
gerrit-review.googlesource.com,role=external,window=_blank] (e.g. edit ACLs, update project
configuration)
* create events in the
link:https://calendar.google.com/calendar?cid=Z29vZ2xlLmNvbV91YmIxcGxhNmlqNzg1b3FianI2MWg0dmRpc0Bncm91cC5jYWxlbmRhci5nb29nbGUuY29t[
community calendar]
community calendar,role=external,window=_blank]
* discuss with other maintainers on the private maintainers mailing
list and Slack channel
@ -243,7 +243,7 @@ governs the project, see link:dev-processes.html#project-governance[Project Gove
Members of the steering committee are expected to act in the interest
of the Gerrit project and the whole Gerrit community. Refer to the project
homepage for the link:https://www.gerritcodereview.com/members.html#engineering-steering-committee[
list of current committee members].
list of current committee members,role=external,window=_blank].
For those that are familiar with scrum, the steering committee member
role is similar to the role of an agile product owner.
@ -254,7 +254,7 @@ responsibilities and live up to the promise of answering incoming
requests in a timely manner.
Community members may submit new items under the
link:https://bugs.chromium.org/p/gerrit/issues/list?q=component:ESC[ESC component]
link:https://bugs.chromium.org/p/gerrit/issues/list?q=component:ESC[ESC component,role=external,window=_blank]
in the issue tracker, or add that component to existing items, to raise them to
the attention of ESC members.
@ -301,7 +301,7 @@ design doc].
Community managers should act as stakeholders for the Gerrit community
and focus on the health of the community. Refer to the project homepage
for the link:https://www.gerritcodereview.com/members.html#community-managers[
list of current community managers].
list of current community managers,role=external,window=_blank].
Tasks:
@ -315,7 +315,7 @@ Tasks:
* serve as contact person for community issues
Community members may submit new items under the
link:https://bugs.chromium.org/p/gerrit/issues/list?q=component:Community[Community component]
link:https://bugs.chromium.org/p/gerrit/issues/list?q=component:Community[Community component,role=external,window=_blank]
backlog, for community managers to refine. Only public topics should be
issued through that backlog.

4
Documentation/dev-starter-projects.txt
View File

@ -1,10 +1,10 @@
= Gerrit Code Review - Starter Projects
We have created a
link:https://bugs.chromium.org/p/gerrit/issues/list?can=2&q=label%3AStarterProject[StarterProject]
link:https://bugs.chromium.org/p/gerrit/issues/list?can=2&q=label%3AStarterProject[StarterProject,role=external,window=_blank]
category in the issue tracker and try to assign easy hack projects to it. If in
doubt, do not hesitate to ask on the developer
link:https://groups.google.com/forum/#!forum/repo-discuss[mailing list].
link:https://groups.google.com/forum/#!forum/repo-discuss[mailing list,role=external,window=_blank].
GERRIT
------

2
Documentation/error-change-closed.txt
View File

@ -15,7 +15,7 @@ already submitted and merged you may want to push your commit as a
new change. To do this you have to remove the Change-Id from the
commit message as explained link:error-push-fails-due-to-commit-message.html[here] and ideally generate a new Change-Id
using the link:cmd-hook-commit-msg.html[commit hook] or EGit. Before pushing again it is also
recommended to do a link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[git rebase] to base your commit on the submitted
recommended to do a link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[git rebase,role=external,window=_blank] to base your commit on the submitted
change. Pushing again should now create a new change in Gerrit.
If the change for which you wanted to upload a new patch set was

2
Documentation/error-changeid-above-footer.txt
View File

@ -8,7 +8,7 @@ To be picked up by Gerrit, a Change-Id must be in the last paragraph
of a commit message. For details, see link:user-changeid.html[Change-Id Lines].
You can see the commit messages for existing commits in the history
by doing a link:http://www.kernel.org/pub/software/scm/git/docs/git-log.html[git log].
by doing a link:http://www.kernel.org/pub/software/scm/git/docs/git-log.html[git log,role=external,window=_blank].
== Change-Id is contained in the commit message but not in the last paragraph

2
Documentation/error-contains-banned-commit.txt
View File

@ -11,7 +11,7 @@ repository again by rejecting every push of such a commit with the
error message "contains banned commit ...".
If you have commits that you want to push that are based on a banned
commit you may want to link:http://www.kernel.org/pub/software/scm/git/docs/git-cherry-pick.html[cherry-pick] them onto a clean base and push
commit you may want to link:http://www.kernel.org/pub/software/scm/git/docs/git-cherry-pick.html[cherry-pick,role=external,window=_blank] them onto a clean base and push
them again.

2
Documentation/error-has-duplicates.txt
View File

@ -10,7 +10,7 @@ Every change is expected to have an unique Change-Id.
Since this error should never occur in practice, you should inform
your Gerrit administrator if you hit this problem and/or
link:https://bugs.chromium.org/p/gerrit/issues/list[open a Gerrit issue].
link:https://bugs.chromium.org/p/gerrit/issues/list[open a Gerrit issue,role=external,window=_blank].
In any case to not be blocked with your work, you can simply create a
new Change-Id for your commit and then push it as new change to

2
Documentation/error-invalid-author.txt
View File

@ -121,7 +121,7 @@ update the author for the last 3 commits:
----
For further details about git rebase please check the
link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[Git documentation].
link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[Git documentation,role=external,window=_blank].
== Missing privileges to push commits of other users

2
Documentation/error-invalid-changeid-line.txt
View File

@ -4,7 +4,7 @@ With this error message Gerrit rejects to push a commit if its commit
message footer contains an invalid Change-Id line.
You can see the commit messages for existing commits in the history
by doing a link:http://www.kernel.org/pub/software/scm/git/docs/git-log.html[git log].
by doing a link:http://www.kernel.org/pub/software/scm/git/docs/git-log.html[git log,role=external,window=_blank].
If it was the intention to rework a change and to push a new patch
set, find the change in the Gerrit Web UI, copy its Change-Id line and

2
Documentation/error-invalid-committer.txt
View File

@ -86,7 +86,7 @@ the commits are rewritten (e.g. by choosing 'reword' for all these
commits and then confirming all the commit messages). Just picking
all the changes will not work as in this case the committer is not
rewritten. For further details about git rebase please check the
link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[Git documentation].
link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[Git documentation,role=external,window=_blank].
== Missing privileges to push commits that were committed by other users

2
Documentation/error-missing-changeid.txt
View File

@ -6,7 +6,7 @@ message if the commit message of the pushed commit does not contain
a Change-Id.
You can see the commit messages for existing commits in the history
by doing a link:http://www.kernel.org/pub/software/scm/git/docs/git-log.html[git log].
by doing a link:http://www.kernel.org/pub/software/scm/git/docs/git-log.html[git log,role=external,window=_blank].
To avoid this error you should use the link:cmd-hook-commit-msg.html[commit hook] or EGit to
automatically create and insert a unique Change-Id into the commit

2
Documentation/error-missing-subject.txt
View File

@ -9,7 +9,7 @@ This error happens if the Change-Id is the only line in the commit
message.
You can see the commit messages for existing commits in the history
by doing a link:http://www.kernel.org/pub/software/scm/git/docs/git-log.html[git log].
by doing a link:http://www.kernel.org/pub/software/scm/git/docs/git-log.html[git log,role=external,window=_blank].
== Change-Id is the only line in the commit message

2
Documentation/error-multiple-changeid-lines.txt
View File

@ -4,7 +4,7 @@ With this error message Gerrit rejects to push a commit if the commit
message footer of the pushed commit contains several Change-Id lines.
You can see the commit messages for existing commits in the history
by doing a link:http://www.kernel.org/pub/software/scm/git/docs/git-log.html[git log].
by doing a link:http://www.kernel.org/pub/software/scm/git/docs/git-log.html[git log,role=external,window=_blank].
If it was the intention to rework a change and to push a new patch
set, find the change in the Gerrit Web UI, copy its Change-Id line and

2
Documentation/error-no-new-changes.txt
View File

@ -38,7 +38,7 @@ means:
in the Gerrit Web UI will not find any change)
If you need to re-push a commit you may rewrite this commit by
link:http://www.kernel.org/pub/software/scm/git/docs/git-commit.html[amending] it or doing an interactive link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[git rebase]. By rewriting the
link:http://www.kernel.org/pub/software/scm/git/docs/git-commit.html[amending,role=external,window=_blank] it or doing an interactive link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[git rebase,role=external,window=_blank]. By rewriting the
commit you actually create a new commit (with a new commit ID in
project scope) which can then be pushed to Gerrit.

6
Documentation/error-non-fast-forward.txt
View File

@ -28,8 +28,8 @@ remote branch evolves. If you are now pushing your commit, with
bypassing code review, your push will be rejected with the error
message 'non-fast forward'. To solve the problem you have to either
. link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[rebase] your commit on the new tip of the remote branch or
. link:http://www.kernel.org/pub/software/scm/git/docs/git-merge.html[merge] your commit with the new tip of the remote branch.
. link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[rebase,role=external,window=_blank] your commit on the new tip of the remote branch or
. link:http://www.kernel.org/pub/software/scm/git/docs/git-merge.html[merge,role=external,window=_blank] your commit with the new tip of the remote branch.
Afterwards the push should be successful.
@ -46,7 +46,7 @@ the commit to the correct project.
Although it is considered bad practice, it is possible to allow
non-fast forward updates with Git. For this the remote Git repository
has to be configured to not deny non-fast forward updates (set the
link:http://www.kernel.org/pub/software/scm/git/docs/git-config.html[Git configuration] parameter 'receive.denyNonFastForwards' to
link:http://www.kernel.org/pub/software/scm/git/docs/git-config.html[Git configuration,role=external,window=_blank] parameter 'receive.denyNonFastForwards' to
'false'). Then it is possible to push a non-fast forward update by
using the '--force' option.

2
Documentation/error-not-allowed-to-upload-merges.txt
View File

@ -12,7 +12,7 @@ for this project.
If one of your changes could not be merged in Gerrit due to conflicts
and you created the merge commit to resolve the conflicts, you might
want to revert the merge and instead of this do a
link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[rebase].
link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[rebase,role=external,window=_blank].
GERRIT

4
Documentation/error-permission-denied.txt
View File

@ -3,8 +3,8 @@
With this error message an SSH command to Gerrit is rejected if the
SSH authentication is not successful.
The link:http://en.wikipedia.org/wiki/Secure_Shell[SSH] protocol can use
link:http://en.wikipedia.org/wiki/Public-key_cryptography[Public-key Cryptography]
The link:http://en.wikipedia.org/wiki/Secure_Shell[SSH,role=external,window=_blank] protocol can use
link:http://en.wikipedia.org/wiki/Public-key_cryptography[Public-key Cryptography,role=external,window=_blank]
for authentication.
In general configurations, Gerrit will authenticate you by the public keys
known to you. Optionally, it can be configured by the administrator to allow

4
Documentation/error-push-fails-due-to-commit-message.txt
View File

@ -6,7 +6,7 @@ the problem can often be resolved by fixing the commit message.
If the commit message of the last commit needs to be fixed you can
simply amend the last commit (please find a detailed description in
the link:http://www.kernel.org/pub/software/scm/git/docs/git-commit.html[Git documentation]):
the link:http://www.kernel.org/pub/software/scm/git/docs/git-commit.html[Git documentation,role=external,window=_blank]):
----
$ git commit --amend
@ -17,7 +17,7 @@ commit other than the last one you have to do an interactive git
rebase for the affected commits. While doing the interactive rebase
you can e.g. choose 'reword' for those commits for which you want to
fix the commit messages. For a detailed description of git rebase
please check the link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[Git documentation].
please check the link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[Git documentation,role=external,window=_blank].
Please use interactive git rebase with care as it rewrites existing
commits. Generally you should never rewrite commits that have already

4
Documentation/error-same-change-id-in-multiple-changes.txt
View File

@ -64,7 +64,7 @@ To squash the commits, use `git rebase -i` to do an interactive rebase. For
the example above where the last two commits have the same Change-Id,
this means an interactive rebase for the last two commits should be
done. For further details about the git rebase command please check
the link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[Git documentation for rebase].
the link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[Git documentation for rebase,role=external,window=_blank].
----
$ git rebase -i HEAD~2
@ -100,7 +100,7 @@ Gerrit does not exist yet, the Change-Id should be generated (either
by using a link:cmd-hook-commit-msg.html[commit hook] or by using EGit) or the Change-Id could be
removed (not recommended since then amending this commit to create
subsequent patch sets is more error prone). To change the Change-Id
of an existing commit do an interactive link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[git rebase] and fix the
of an existing commit do an interactive link:http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html[git rebase,role=external,window=_blank] and fix the
affected commit messages.

2
Documentation/error-upload-denied.txt
View File

@ -9,7 +9,7 @@ There are two possibilities how to continue in this situation:
. contact one of the project owners and request upload permissions
for the project (access right
link:access-control.html#category_push['Push'])
. export your commit as a patch using the link:http://www.kernel.org/pub/software/scm/git/docs/git-format-patch.html[git format-patch] command
. export your commit as a patch using the link:http://www.kernel.org/pub/software/scm/git/docs/git-format-patch.html[git format-patch,role=external,window=_blank] command
and provide the patch file to one of the project owners

14
Documentation/index.txt
View File

@ -16,7 +16,7 @@
== Guides
. link:intro-user.html[User Guide]
. link:intro-project-owner.html[Project Owner Guide]
. link:https://source.android.com/source/developing[Default Android Workflow] (external)
. link:https://source.android.com/source/developing[Default Android Workflow,role=external,window=_blank] (external)
== Tutorials
. Web
@ -43,7 +43,7 @@
. link:access-control.html[Access Controls]
. Multi-project management
.. link:user-submodules.html[Submodules]
.. link:https://source.android.com/source/using-repo.html[Repo] (external)
.. link:https://source.android.com/source/using-repo.html[Repo,role=external,window=_blank] (external)
. Prolog rules
.. link:prolog-cookbook.html[Prolog Cookbook]
.. link:prolog-change-facts.html[Prolog Facts for Gerrit Changes]
@ -84,11 +84,11 @@
== Resources
* link:licenses.html[Licenses and Notices]
* link:https://www.gerritcodereview.com/[Homepage]
* link:https://gerrit-releases.storage.googleapis.com/index.html[Downloads]
* link:https://bugs.chromium.org/p/gerrit/issues/list[Issue Tracking]
* link:https://gerrit.googlesource.com/gerrit[Source Code]
* link:https://www.gerritcodereview.com/about.md[A History of Gerrit Code Review]
* link:https://www.gerritcodereview.com/[Homepage,role=external,window=_blank]
* link:https://gerrit-releases.storage.googleapis.com/index.html[Downloads,role=external,window=_blank]
* link:https://bugs.chromium.org/p/gerrit/issues/list[Issue Tracking,role=external,window=_blank]
* link:https://gerrit.googlesource.com/gerrit[Source Code,role=external,window=_blank]
* link:https://www.gerritcodereview.com/about.md[A History of Gerrit Code Review,role=external,window=_blank]
GERRIT
------

4
Documentation/install-j2ee.txt
View File

@ -47,7 +47,7 @@ directly to change 4543.
Download and unzip a release version of Jetty. From here on we
call the unpacked directory `$JETTY_HOME`.
* link:http://www.eclipse.org/jetty/downloads.php[Jetty Downloads]
* link:http://www.eclipse.org/jetty/downloads.php[Jetty Downloads,role=external,window=_blank]
If this is a fresh installation of Jetty, move into the installation
directory and do some cleanup to remove the sample webapps:
@ -99,7 +99,7 @@ slashes]. Otherwise Tomcat must be configured to encode slashes, by adding
Excerpt from the
link:https://tomcat.apache.org/tomcat-7.0-doc/config/systemprops.html[
documentation]:
documentation,role=external,window=_blank]:
----
Property org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH:

16
Documentation/install.txt
View File

@ -5,7 +5,7 @@
To run the Gerrit service, the following requirement must be met on the host:
* JRE, version 1.8 http://www.oracle.com/technetwork/java/javase/downloads/index.html[Download]
* JRE, version 1.8 http://www.oracle.com/technetwork/java/javase/downloads/index.html[Download,role=external,window=_blank]
+
Gerrit is not yet compatible with Java 9 or newer at this time.
@ -22,8 +22,8 @@ Installing JCE extensions is optional and export restrictions may apply.
. Download the unlimited strength JCE policy files.
+
- link:http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html[JDK7 JCE policy files]
- link:http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html[JDK8 JCE policy files]
- link:http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html[JDK7 JCE policy files,role=external,window=_blank]
- link:http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html[JDK8 JCE policy files,role=external,window=_blank]
. Uncompress and extract the downloaded file.
+
The downloaded file contains the following files:
@ -47,7 +47,7 @@ found in `README.txt`.
Current and past binary releases of Gerrit can be obtained from
the link:https://gerrit-releases.storage.googleapis.com/index.html[
Gerrit Releases site].
Gerrit Releases site,role=external,window=_blank].
Download any current `*.war` package. The war will be referred to as
`gerrit.war` from this point forward, so you may find it easier to
@ -173,7 +173,7 @@ link:install-j2ee.html[J2EE installation].
The `ssh-keygen` command must be available during the init phase to
generate SSH host keys. If you have
link:https://git-for-windows.github.io/[Git for Windows] installed,
link:https://git-for-windows.github.io/[Git for Windows,role=external,window=_blank] installed,
start Command Prompt and temporary add directory with ssh-keygen to the
PATH environment variable just before running init command:
@ -197,7 +197,7 @@ To stop the daemon press Ctrl+C.
To install Gerrit as Windows Service use the
link:http://commons.apache.org/proper/commons-daemon/procrun.html[Apache
Commons Daemon Procrun].
Commons Daemon Procrun,role=external,window=_blank].
Sample install command:
@ -235,7 +235,7 @@ anonymous, unencrypted git:// protocol is more efficient than
Gerrit's internal SSH daemon. See the `git-daemon` documentation
for details on how to configure this if anonymous access is desired.
* http://www.kernel.org/pub/software/scm/git/docs/git-daemon.html[man git-daemon]
* http://www.kernel.org/pub/software/scm/git/docs/git-daemon.html[man git-daemon,role=external,window=_blank]
[[plugins]]
@ -246,7 +246,7 @@ Place Gerrit plugins in the review_site/plugins directory to have them loaded on
== External Documentation Links
* http://www.kernel.org/pub/software/scm/git/docs/git-daemon.html[git-daemon]
* http://www.kernel.org/pub/software/scm/git/docs/git-daemon.html[git-daemon,role=external,window=_blank]
[[backup]]

10
Documentation/intro-gerrit-walkthrough-github.txt
View File

@ -25,7 +25,7 @@ Here’s how getting code reviewed and submitted with Gerrit is different from
doing the same with GitHub:
* You need the add a commit-msg hook script when you clone a repo for the first
time using a snippet you can find e.g. https://gerrit-review.googlesource.com/admin/repos/gerrit[here];
time using a snippet you can find e.g. https://gerrit-review.googlesource.com/admin/repos/gerrit[here,role=external,window=_blank];
* Your review will be on a single commit instead of a branch. You use
`git commit --amend` to modify a code change.
* Instead of using the Web UI to create a pull request, you use
@ -54,11 +54,11 @@ The first step to working with the code is to clone the repo. For both, Gerrit
and GitHub, you can simply use the `git clone` command.
For Gerrit, there is an additional step before you can start making changes. For
reasons we explain below, you’ll have to add a https://gerrit-review.googlesource.com/Documentation/user-changeid.html[commit-msg hook] script. This will
reasons we explain below, you’ll have to add a https://gerrit-review.googlesource.com/Documentation/user-changeid.html[commit-msg hook,role=external,window=_blank] script. This will
append the Gerrit Change-Id to every commit message such that Gerrit can track
commits through the review process. To make this process a little easier in
Gerrit, you can find a command snippet for cloning and adding the commit-msg
hook on the repository page (e.g. https://gerrit-review.googlesource.com/admin/repos/gerrit[here]).
hook on the repository page (e.g. https://gerrit-review.googlesource.com/admin/repos/gerrit[here,role=external,window=_blank]).
[[create-change]]
== 2. Making a Change
@ -141,7 +141,7 @@ any way. You can also see all changes on a Gerrit server by using the top menu
(“Changes” -> “Open”). This view is more similar to what you see on Github, when
you navigate to the Pull Requests tab of the project/repository you are working
on. Note, however, that a single Gerrit instance can host multiple projects
(also referred to as repositories; a list can be found, for example, https://gerrit-review.googlesource.com/admin/repos[here]). Your
(also referred to as repositories; a list can be found, for example, https://gerrit-review.googlesource.com/admin/repos[here,role=external,window=_blank]). Your
dashboard and other lists of changes will show all changes across the
projects/repositories by default.
@ -191,7 +191,7 @@ need to make a few updates to the code in your change. As mentioned in Section 2
on. To do that, you might have to checkout the respective commit first if it is
not at the tip of your local branch, for example if you stacked multiple changes
on top of each other. Another common use case is to not have a local branch but
to work in the so-called https://www.git-tower.com/learn/git/faq/detached-head-when-checkout-commit["detached HEAD"] mode. In that case you can use the
to work in the so-called https://www.git-tower.com/learn/git/faq/detached-head-when-checkout-commit["detached HEAD",role=external,window=_blank] mode. In that case you can use the
“Download” button on the files tab to copy a command that fetches and checks out
the commit underlying your change. Make sure to select the latest patchset,
though!

4
Documentation/intro-gerrit-walkthrough.txt
View File

@ -130,7 +130,7 @@ In general, the *Code-Review* check requires an individual to look at the code,
while the *Verified* check is done by an automated build server, through a
mechanism such as the
link:https://wiki.jenkins-ci.org/display/JENKINS/Gerrit+Trigger[Gerrit Trigger
Jenkins Plugin].
Jenkins Plugin,role=external,window=_blank].
IMPORTANT: The Code-Review and Verified checks require different permissions
in Gerrit. This requirement allows teams to separate these tasks. For example,
@ -252,7 +252,7 @@ NOTE: Remember that this walkthrough uses Gerrit's default workflow. Projects
can add custom checks or even remove the Verified check entirely.
Verification is typically an automated process using the
link:https://wiki.jenkins-ci.org/display/JENKINS/Gerrit+Trigger[Gerrit Trigger Jenkins Plugin]
link:https://wiki.jenkins-ci.org/display/JENKINS/Gerrit+Trigger[Gerrit Trigger Jenkins Plugin,role=external,window=_blank]
or a similar mechanism. However, there are still times when a change requires
manual verification, or a reviewer needs to check how or if a change works.
To accommodate these and other similar circumstances, Gerrit exposes each change

46
Documentation/intro-project-owner.txt
View File

@ -181,7 +181,7 @@ them, e.g. link:access-control.html#ldap_groups[LDAP group names] need
to be prefixed with `ldap/`.
If the link:https://gerrit-review.googlesource.com/admin/repos/plugins/singleusergroup[
singleusergroup] plugin is installed you can also directly assign
singleusergroup,role=external,window=_blank] plugin is installed you can also directly assign
access rights to users, by prefixing the username with `user/` or the
user's account ID by `userid/`.
@ -374,10 +374,10 @@ There are several solutions for integrating continuous integration
systems. The most commonly used are:
- link:https://wiki.jenkins-ci.org/display/JENKINS/Gerrit+Trigger[
Gerrit Trigger] plugin for link:http://jenkins-ci.org/[Jenkins]
Gerrit Trigger,role=external,window=_blank] plugin for link:http://jenkins-ci.org/[Jenkins,role=external,window=_blank]
- link:http://www.mediawiki.org/wiki/Continuous_integration/Zuul[
Zuul] for link:http://jenkins-ci.org/[Jenkins]
Zuul,role=external,window=_blank] for link:http://jenkins-ci.org/[Jenkins,role=external,window=_blank]
For the integration with the continuous integration system you must
have a service user that is able to access Gerrit. To create a service
@ -387,7 +387,7 @@ Create Account] global capability is granted. If not, you need to ask
a Gerrit administrator to create the service user.
If the link:https://gerrit-review.googlesource.com/admin/repos/plugins/serviceuser[
serviceuser] plugin is installed you can also create new service users
serviceuser,role=external,window=_blank] plugin is installed you can also create new service users
in the Gerrit Web UI under `People` > `Create Service User`. For this
the `Create Service User` global capability must be assigned.
@ -407,7 +407,7 @@ capability assigned.
Gerrit provides an
link:https://gerrit-review.googlesource.com/Documentation/config-validation.html#new-commit-validation[
extension point to do validation of new commits]. A Gerrit plugin
extension point to do validation of new commits,role=external,window=_blank]. A Gerrit plugin
implementing this extension point can perform validation checks when
new commits are pushed to Gerrit. The plugin can either provide a
message to the client or reject the commit and cause the push to fail.
@ -415,13 +415,13 @@ message to the client or reject the commit and cause the push to fail.
There are some plugins available that provide commit validation:
- link:https://gerrit-review.googlesource.com/admin/repos/plugins/uploadvalidator[
uploadvalidator]:
uploadvalidator,role=external,window=_blank]:
+
The `uploadvalidator` plugin allows project owners to configure blocked
file extensions, required footers and a maximum allowed path length.
- link:https://gerrit-review.googlesource.com/admin/repos/plugins/commit-message-length-validator[
commit-message-length-validator]
commit-message-length-validator,role=external,window=_blank]
+
The `commit-message-length-validator` core plugin validates that commit
messages conform to line length limits.
@ -501,9 +501,9 @@ only be done globally by a Gerrit administrator.
- Issue Tracker System Plugins
+
There are Gerrit plugins for a tight integration with
link:https://gerrit-review.googlesource.com//admin/repos/plugins/its-jira[Jira],
link:https://gerrit-review.googlesource.com/admin/repos/plugins/its-bugzilla[Bugzilla] and
link:https://gerrit-review.googlesource.com/admin/repos/plugins/its-rtc[IBM Rational Team Concert].
link:https://gerrit-review.googlesource.com//admin/repos/plugins/its-jira[Jira,role=external,window=_blank],
link:https://gerrit-review.googlesource.com/admin/repos/plugins/its-bugzilla[Bugzilla,role=external,window=_blank] and
link:https://gerrit-review.googlesource.com/admin/repos/plugins/its-rtc[IBM Rational Team Concert,role=external,window=_blank].
If installed, these plugins can e.g. be used to automatically add links
to Gerrit changes to the issues in the issue tracker system or to
automatically close an issue if the corresponding change is merged.
@ -551,15 +551,15 @@ by adding this person in the Gerrit Web UI as a reviewer on the change.
Gerrit will then notify this person by email about the review request.
With the link:https://gerrit-review.googlesource.com/admin/repos/plugins/reviewers[
reviewers] plugin it is possible to configure default reviewers who
reviewers,role=external,window=_blank] plugin it is possible to configure default reviewers who
will be automatically added to each change. The default reviewers can
be configured in the Gerrit Web UI under `Projects` > `List` >
<your project> > `General` in the `reviewers Plugin` section.
The link:https://gerrit-review.googlesource.com/admin/repos/plugins/reviewers-by-blame[
reviewers-by-blame] plugin can automatically add reviewers to changes
reviewers-by-blame,role=external,window=_blank] plugin can automatically add reviewers to changes
based on the link:https://www.kernel.org/pub/software/scm/git/docs/git-blame.html[
git blame] computation on the changed files. This means that the plugin
git blame,role=external,window=_blank] computation on the changed files. This means that the plugin
will add those users as reviewer that authored most of the lines
touched by the change, since these users should be familiar with the
code and can most likely review the change. How many reviewers the
@ -578,7 +578,7 @@ that the available download commands depend on the installed Gerrit
plugins:
- link:https://gerrit-review.googlesource.com/admin/repos/plugins/download-commands[
download-commands] plugin:
download-commands,role=external,window=_blank] plugin:
+
The `download-commands` plugin provides the default download commands
(`Checkout`, `Cherry Pick`, `Format Patch` and `Pull`).
@ -587,14 +587,14 @@ Gerrit administrators may configure which of the commands are shown on
the change screen.
- link:https://gerrit-review.googlesource.com/admin/repos/plugins/egit[
egit] plugin:
egit,role=external,window=_blank] plugin:
+
The `egit` plugin provides the change ref as a download command, which is
needed for downloading a change from within
link:https://www.eclipse.org/egit/[EGit].
- link:https://gerrit-review.googlesource.com/admin/repos/plugins/project-download-commands[
project-download-commands] plugin:
project-download-commands,role=external,window=_blank] plugin:
+
The `project-download-commands` plugin enables project owners to
configure project-specific download commands. For example, a
@ -678,14 +678,14 @@ project. To do this you need to have a local Git repository that
contains this history. If your existing codebase is in another VCS you
must migrate it to Git first. For Subversion you can use the
link:http://git-scm.com/book/en/Git-and-Other-Systems-Git-and-Subversion[
git svn] command as described in the
git svn,role=external,window=_blank] command as described in the
link:http://git-scm.com/book/en/Git-and-Other-Systems-Migrating-to-Git#Subversion[
Subversion migration guide]. An importer for Perforce is available in
Subversion migration guide,role=external,window=_blank]. An importer for Perforce is available in
the `contrib` section of the Git source code; how to use
link:http://git-scm.com/docs/git-p4[git p4] to do the import from
link:http://git-scm.com/docs/git-p4[git p4,role=external,window=_blank] to do the import from
Perforce is described in the
link:http://git-scm.com/book/en/Git-and-Other-Systems-Migrating-to-Git#Perforce[
Perforce migration guide].
Perforce migration guide,role=external,window=_blank].
To import an existing history into a Gerrit project you bypass code
review and push it directly to `refs/heads/<branch>`. For this you must
@ -699,7 +699,7 @@ Some Gerrit servers may disallow forging committers by blocking the
link:access-control.html#category_forge_committer[Forge Committer]
access right globally. In this case you must use the
link:https://www.kernel.org/pub/software/scm/git/docs/git-filter-branch.html[
git filter-branch] command to rewrite the committer information for all
git filter-branch,role=external,window=_blank] command to rewrite the committer information for all
commits (the author information that records who was writing the code
stays intact; signed tags will lose their signature):
@ -741,7 +741,7 @@ have been rewritten are removed.
Gerrit core does not support the deletion of projects.
If the link:https://gerrit-review.googlesource.com/admin/repos/plugins/delete-project[
delete-project] plugin is installed, projects can be deleted from the
delete-project,role=external,window=_blank] plugin is installed, projects can be deleted from the
Gerrit Web UI under `Projects` > `List` > <project> > `General` by
clicking on the `Delete` command under `Project Commands`. The `Delete`
command is only available if you have the `Delete Projects` global
@ -769,7 +769,7 @@ Please note that a drawback of this workaround is that the whole review
history (changes, review comments) is lost.
Alternatively, you can use the
link:https://gerrit.googlesource.com/plugins/importer/[importer] plugin
link:https://gerrit.googlesource.com/plugins/importer/[importer,role=external,window=_blank] plugin
to copy the project _including the review history_, and then
link:#project-deletion[delete the old project].

4
Documentation/intro-quick.txt
View File

@ -1,7 +1,7 @@
= Gerrit Code Review Product Overview
Gerrit Code Review is a web-based code review tool built on
https://git-scm.com/[Git version control].
https://git-scm.com/[Git version control,role=external,window=_blank].
== What is Gerrit Code Review?
@ -45,7 +45,7 @@ To learn more, see:
. link:intro-user.html[User Guide]
. link:intro-project-owner.html[Project Owner Guide]
. link:https://source.android.com/source/life-of-a-patch[Default Android Workflow] (external)
. link:https://source.android.com/source/life-of-a-patch[Default Android Workflow,role=external,window=_blank] (external)
GERRIT
------

6
Documentation/intro-rockstar.txt
View File

@ -42,7 +42,7 @@ functional change, as is required for:
* git cherry-pick
* link:https://www.kernel.org/pub/software/scm/git/docs/git-bisect-lk2009.html[git bisect]
* link:https://www.kernel.org/pub/software/scm/git/docs/git-bisect-lk2009.html[git bisect,role=external,window=_blank]
[[amending]]
@ -59,8 +59,8 @@ older (imperfect) revision is not lost. It can be found via the `git reflog`.
At least two well-known open source projects insist on these practices:
* link:http://git-scm.com/[Git]
* link:http://www.kernel.org/category/about.html[Linux Kernel]
* link:http://git-scm.com/[Git,role=external,window=_blank]
* link:http://www.kernel.org/category/about.html[Linux Kernel,role=external,window=_blank]
However, contributors to these projects don’t refine and polish their changes
in private until they’re perfect. Instead, polishing code is part of a review

18
Documentation/intro-user.txt
View File

@ -4,7 +4,7 @@ This is a Gerrit guide that is dedicated to Gerrit end-users. It
explains the standard Gerrit workflows and how a user can adapt Gerrit
to personal preferences.
It is expected that readers know about link:http://git-scm.com/[Git]
It is expected that readers know about link:http://git-scm.com/[Git,role=external,window=_blank]
and that they are familiar with basic git commands and workflows.
[[gerrit]]
@ -21,20 +21,20 @@ link:#no-code-review[work without code review].
Gerrit uses the git protocol. This means in order to work with Gerrit
you do *not* need to install any Gerrit client, but having a regular
git client, such as the link:http://git-scm.com/[git command line] or
link:http://eclipse.org/egit/[EGit] in Eclipse, is sufficient.
git client, such as the link:http://git-scm.com/[git command line,role=external,window=_blank] or
link:http://eclipse.org/egit/[EGit,role=external,window=_blank] in Eclipse, is sufficient.
Still there are some client-side tools for Gerrit, which can be used
optionally:
* link:http://eclipse.org/mylyn/[Mylyn Gerrit Connector]: Gerrit
* link:http://eclipse.org/mylyn/[Mylyn Gerrit Connector,role=external,window=_blank]: Gerrit
integration with Mylyn
* link:https://github.com/uwolfer/gerrit-intellij-plugin[Gerrit
IntelliJ Plugin]: Gerrit integration with the
link:http://www.jetbrains.com/idea/[IntelliJ Platform]
IntelliJ Plugin,role=external,window=_blank]: Gerrit integration with the
link:http://www.jetbrains.com/idea/[IntelliJ Platform,role=external,window=_blank]
* link:https://play.google.com/store/apps/details?id=com.jbirdvegas.mgerrit[
mGerrit]: Android client for Gerrit
* link:https://github.com/stackforge/gertty[Gertty]: Console-based
mGerrit,role=external,window=_blank]: Android client for Gerrit
* link:https://github.com/stackforge/gertty[Gertty,role=external,window=_blank]: Console-based
interface for Gerrit
[[clone]]
@ -209,7 +209,7 @@ documentation].
Instead of manually installing the `commit-msg` hook for each git
repository, you can copy it into the
link:http://git-scm.com/docs/git-init#_template_directory[git template
directory]. Then it is automatically copied to every newly cloned
directory,role=external,window=_blank]. Then it is automatically copied to every newly cloned
repository.
[[review-change]]

2
Documentation/linux-quickstart.txt
View File

@ -29,7 +29,7 @@ From the Linux machine on which you want to install Gerrit:
. Download the desired Gerrit archive.
To view previous archives, see
link:https://gerrit-releases.storage.googleapis.com/index.html[Gerrit Code Review: Releases]. The steps below install Gerrit 3.0.3:
link:https://gerrit-releases.storage.googleapis.com/index.html[Gerrit Code Review: Releases,role=external,window=_blank]. The steps below install Gerrit 3.0.3:
....
wget https://gerrit-releases.storage.googleapis.com/gerrit-3.0.3.war

4
Documentation/note-db.txt
View File

@ -36,7 +36,7 @@ data in the same repository as code changes.
the upgrade process by running `gerrit.war init`
- Account, group and change metadata on the servers behind `googlesource.com` is fully
migrated to NoteDb. In other words, if you use
link:https://gerrit-review.googlesource.com/[gerrit-review], you're already
link:https://gerrit-review.googlesource.com/[gerrit-review,role=external,window=_blank], you're already
using NoteDb.
- NoteDb is the only database format supported by Gerrit 3.0. The change data
migration tools are only included in Gerrit 2.15 and 2.16; they are not
@ -197,5 +197,5 @@ section serves primarily as a reference.
In case of rollback from NoteDB to ReviewDB, all the meta refs and the
sequence ref need to be removed.
The [remove-notedb-refs.sh](https://gerrit.googlesource.com/gerrit/+/refs/heads/master/contrib/remove-notedb-refs.sh)
The [remove-notedb-refs.sh,role=external,window=_blank](https://gerrit.googlesource.com/gerrit/+/refs/heads/master/contrib/remove-notedb-refs.sh)
script has been written to automate this process.

8
Documentation/pg-plugin-dev.txt
View File

@ -2,7 +2,7 @@
CAUTION: Work in progress. Hard hat area. Please
link:https://bugs.chromium.org/p/gerrit/issues/entry?template=PolyGerrit%20plugins[send
feedback] if something's not right.
feedback,role=external,window=_blank] if something's not right.
For migrating existing GWT UI plugins, please check out the
link:pg-plugin-migration.html#migration[migration guide].
@ -11,7 +11,7 @@ link:pg-plugin-migration.html#migration[migration guide].
== Plugin loading and initialization
link:js-api.html#_entry_point[Entry point] for the plugin and the loading method
is based on link:http://w3c.github.io/webcomponents/spec/imports/[HTML Imports]
is based on link:http://w3c.github.io/webcomponents/spec/imports/[HTML Imports,role=external,window=_blank]
spec.
* The plugin provides pluginname.html, and can be a standalone file or a static
@ -103,7 +103,7 @@ Gerrit.install(plugin => {
A plugin may provide Polymer's
https://www.polymer-project.org/2.0/docs/devguide/style-shadow-dom#style-modules[style
modules] to style individual endpoints using
modules,role=external,window=_blank] to style individual endpoints using
`plugin.registerStyleModule(endpointName, moduleName)`. A style must be defined
as a standalone `<dom-module>` defined in the same .html file.
@ -152,7 +152,7 @@ The low-level DOM API methods are the base of all UI customization.
Alternative for
link:https://www.polymer-project.org/1.0/docs/devguide/data-binding[Polymer data
binding] for plugins that don't use Polymer. Can be used to bind element
binding,role=external,window=_blank] for plugins that don't use Polymer. Can be used to bind element
attribute changes to callbacks.
See `samples/bind-parameters.html` for examples on both Polymer data bindings

2
Documentation/pg-plugin-migration.txt
View File

@ -2,7 +2,7 @@
CAUTION: Work in progress. Hard hat area. Please
link:https://bugs.chromium.org/p/gerrit/issues/entry?template=PolyGerrit%20plugins[send
feedback] if something's not right.
feedback,role=external,window=_blank] if something's not right.
[[migration]]
== Incremental migration of existing GWT UI plugins

8
Documentation/pg-plugin-styling.txt
View File

@ -4,17 +4,17 @@
Plugins may provide
link:https://www.polymer-project.org/2.0/docs/devguide/style-shadow-dom#style-modules[Polymer
style modules] for UI CSS-based customization.
style modules,role=external,window=_blank] for UI CSS-based customization.
PolyGerrit UI implements number of styling endpoints, which apply CSS mixins
link:https://tabatkins.github.io/specs/css-apply-rule/[using @apply] to its
link:https://tabatkins.github.io/specs/css-apply-rule/[using @apply,role=external,window=_blank] to its
direct contents.
NOTE: Only items (i.e. CSS properties and mixin targets) documented here are
guaranteed to work in the long term, since they are covered by integration
tests. + When there is a need to add new property or endpoint, please
link:https://bugs.chromium.org/p/gerrit/issues/entry?template=PolyGerrit%20Issue[file
a bug] stating your use case to track and maintain for future releases.
a bug,role=external,window=_blank] stating your use case to track and maintain for future releases.
Plugins should be html-based and imported following PolyGerrit's
link:pg-plugin-dev.html#loading[dev guide].
@ -64,7 +64,7 @@ is applied to `gr-change-metadata section.topic`
Following CSS properties have
link:https://gerrit.googlesource.com/gerrit/+/master/polygerrit-ui/app/elements/change/gr-change-metadata/gr-change-metadata-it_test.html[long-term
support via integration test]:
support via integration test,role=external,window=_blank]:
* `display`
+

2
Documentation/pgm-MigrateAccountPatchReviewDb.txt
View File

@ -30,7 +30,7 @@ To migrate AccountPatchReviewDb:
[NOTE]
When using MySQL, the file_name column length in the account_patch_reviews table will be shortened
from the standard 4096 characters down to 255 characters. This is due to a
link:https://dev.mysql.com/doc/refman/5.7/en/innodb-restrictions.html[MySQL limitation]
link:https://dev.mysql.com/doc/refman/5.7/en/innodb-restrictions.html[MySQL limitation,role=external,window=_blank]
on the max size of 767 bytes for each column in an index.
== OPTIONS

14
Documentation/prolog-cookbook.txt
View File

@ -23,10 +23,10 @@ Loading and executing Prolog submit rules may be disabled by setting
link:config-gerrit.html#_a_id_rules_a_section_rules[rules section])
link:https://groups.google.com/d/topic/repo-discuss/wJxTGhlHZMM/discussion[This
discussion thread] explains why Prolog was chosen for the purpose of writing
discussion thread,role=external,window=_blank] explains why Prolog was chosen for the purpose of writing
project specific submit rules.
link:http://gerrit-documentation.googlecode.com/svn/ReleaseNotes/ReleaseNotes-2.2.2.html[Gerrit
2.2.2 ReleaseNotes] introduces Prolog support in Gerrit.
2.2.2 ReleaseNotes,role=external,window=_blank] introduces Prolog support in Gerrit.
[[SubmitType]]
== Submit Type
@ -58,14 +58,14 @@ situation.
== Prolog Language
This document is not a complete Prolog tutorial.
link:http://en.wikipedia.org/wiki/Prolog[This Wikipedia page on Prolog] is a
link:http://en.wikipedia.org/wiki/Prolog[This Wikipedia page on Prolog,role=external,window=_blank] is a
good starting point for learning the Prolog language. This document will only
explain some elements of Prolog that are necessary to understand the provided
examples.
== Prolog in Gerrit
Gerrit uses its own link:https://gerrit.googlesource.com/prolog-cafe/[fork] of the
original link:http://kaminari.istc.kobe-u.ac.jp/PrologCafe/[prolog-cafe]
Gerrit uses its own link:https://gerrit.googlesource.com/prolog-cafe/[fork,role=external,window=_blank] of the
original link:http://kaminari.istc.kobe-u.ac.jp/PrologCafe/[prolog-cafe,role=external,window=_blank]
project. Gerrit embeds the prolog-cafe library and can interpret Prolog programs
at runtime.
@ -75,7 +75,7 @@ link:pgm-prolog-shell.html[prolog-shell] program which opens an interactive
Prolog interpreter shell.
For batch or unit tests, see the examples in Gerrit source directory
link:https://gerrit.googlesource.com/gerrit/+/refs/heads/master/prologtests/examples/[prologtests/examples].
link:https://gerrit.googlesource.com/gerrit/+/refs/heads/master/prologtests/examples/[prologtests/examples,role=external,window=_blank].
[NOTE]
The interactive shell is just a prolog shell, it does not load
@ -84,7 +84,7 @@ xref:TestingSubmitRules[testing submit rules].
== SWI-Prolog
Instead of using the link:pgm-prolog-shell.html[prolog-shell] program one can
also use the link:http://www.swi-prolog.org/[SWI-Prolog] environment. It
also use the link:http://www.swi-prolog.org/[SWI-Prolog,role=external,window=_blank] environment. It
provides a better shell interface and a graphical source-level debugger.
[[RulesFile]]

2
Documentation/quota.txt
View File

@ -3,7 +3,7 @@
Gerrit does not provide out of the box quota enforcement. However, it does
support an extension mechanism for plugins to hook into to provide this
functionality. The most prominent plugin is the
link:https://gerrit.googlesource.com/plugins/quota/[Quota Plugin].
link:https://gerrit.googlesource.com/plugins/quota/[Quota Plugin,role=external,window=_blank].
This documentation is intended to be read by plugin developers. It contains all
quota requests implemented in Gerrit-core as well as the metadata that they have

2
Documentation/rest-api-accounts.txt
View File

@ -2661,7 +2661,7 @@ The `GpgKeyInfo` entity contains information about a GPG public key.
|`id` |Not set in map context|The 8-char hex GPG key ID.
|`fingerprint`|Not set for deleted keys|The 40-char (plus spaces) hex GPG key fingerprint.
|`user_ids` |Not set for deleted keys|
link:https://tools.ietf.org/html/rfc4880#section-5.11[OpenPGP User IDs]
link:https://tools.ietf.org/html/rfc4880#section-5.11[OpenPGP User IDs,role=external,window=_blank]
associated with the public key.
|`key` |Not set for deleted keys|ASCII armored public key material.
|`status` |Not set for deleted keys|

10
Documentation/rest-api-changes.txt
View File

@ -2356,7 +2356,7 @@ If the change was already not private, the response is "`409 Conflict`".
A message can be specified in the request body inside a
link:#private-input[PrivateInput] entity. Historically, this method allowed
a body in the DELETE, but that behavior is
link:https://www.gerritcodereview.com/releases/2.16.md[deprecated].
link:https://www.gerritcodereview.com/releases/2.16.md[deprecated,role=external,window=_blank].
In this case, use a POST request instead:
.Request
@ -3342,7 +3342,7 @@ Deletes a reviewer from a change.
Options can be provided in the request body as a
link:#delete-reviewer-input[DeleteReviewerInput] entity.
Historically, this method allowed a body in the DELETE, but that behavior is
link:https://www.gerritcodereview.com/releases/2.16.md[deprecated].
link:https://www.gerritcodereview.com/releases/2.16.md[deprecated,role=external,window=_blank].
In this case, use a POST request instead:
.Request
@ -3422,7 +3422,7 @@ a reviewer is removed the reviewer itself is still listed on the change.
Options can be provided in the request body as a
link:#delete-vote-input[DeleteVoteInput] entity.
Historically, this method allowed a body in the DELETE, but that behavior is
link:https://www.gerritcodereview.com/releases/2.16.md[deprecated].
link:https://www.gerritcodereview.com/releases/2.16.md[deprecated,role=external,window=_blank].
In this case, use a POST request instead:
.Request
@ -4795,7 +4795,7 @@ global capability are permitted to delete a comment.
Deletion reason can be provided in the request body as a
link:#delete-comment-input[DeleteCommentInput] entity.
Historically, this method allowed a body in the DELETE, but that behavior is
link:https://www.gerritcodereview.com/releases/2.16.md[deprecated].
link:https://www.gerritcodereview.com/releases/2.16.md[deprecated,role=external,window=_blank].
In this case, use a POST request instead:
.Request
@ -5615,7 +5615,7 @@ is still listed on the change.
Options can be provided in the request body as a
link:#delete-vote-input[DeleteVoteInput] entity.
Historically, this method allowed a body in the DELETE, but that behavior is
link:https://www.gerritcodereview.com/releases/2.16.md[deprecated].
link:https://www.gerritcodereview.com/releases/2.16.md[deprecated,role=external,window=_blank].
In this case, use a POST request instead:
.Request

2
Documentation/rest-api-projects.txt
View File

@ -610,7 +610,7 @@ Deletes the description of a project.
A commit message can be provided in the request body as a
link:#project-description-input[ProjectDescriptionInput] entity.
Historically, this method allowed a body in the DELETE, but that behavior is
link:https://www.gerritcodereview.com/releases/2.16.md[deprecated].
link:https://www.gerritcodereview.com/releases/2.16.md[deprecated,role=external,window=_blank].
In this case, use link:#set-project-description[PUT] instead.
.Request

2
Documentation/rest-api.txt
View File

@ -128,7 +128,7 @@ must be URL encoded.
=== Response Codes
The Gerrit REST endpoints use HTTP status codes as described
in the link:http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html[
HTTP specification].
HTTP specification,role=external,window=_blank].
In most cases, the response body of an error response will be a
plaintext, human-readable error message.

2
Documentation/user-inline-edit.txt
View File

@ -16,7 +16,7 @@ To learn more, see the link:intro-user.html[Gerrit User's Guide].
To create a change in the Gerrit web interface:
. From the link:http://gerrit-review.googlesource.com[Gerrit Code Review]
. From the link:http://gerrit-review.googlesource.com[Gerrit Code Review,role=external,window=_blank]
dashboard, select Browse > Repositories.
. Under Repository Name, click the name of the repository you want to work

2
Documentation/user-request-tracing.txt
View File

@ -75,7 +75,7 @@ triggered the auto-retry, however this is not guaranteed:
[[auto-retry-succeeded]]
If an auto-retry succeeds you may consider filing this as
link:https://bugs.chromium.org/p/gerrit/issues/entry?template=GoogleSource+Issue[
Gerrit issue] so that the Gerrit developers can fix this and treat this
Gerrit issue,role=external,window=_blank] so that the Gerrit developers can fix this and treat this
exception as recoverable.
The trace IDs for auto-retries are generated and start with

6
Documentation/user-review-ui.txt
View File

@ -432,7 +432,7 @@ image::images/user-review-ui-change-screen-download-commands.png[width=800, link
The available download commands depend on the installed Gerrit plugins.
The most popular plugin for download commands, the
link:https://gerrit-review.googlesource.com/admin/repos/plugins/download-commands[
download-commands] plugin, provides commands to checkout, pull and
download-commands,role=external,window=_blank] plugin, provides commands to checkout, pull and
cherry-pick a patch set.
Each command has a copy-to-clipboard icon that allows the command to be
@ -943,7 +943,7 @@ previous match. Skipped lines are automatically expanded if they
contain a match and one navigates to it.
For additional possibilities to search please check the
link:http://www.vim.org/docs.php[Vim documentation]. There are other
link:http://www.vim.org/docs.php[Vim documentation,role=external,window=_blank]. There are other
useful ways to search, e.g. while the cursor is on a word, pressing `*`
or `#` searches for the next or previous occurrence of the word.
@ -962,7 +962,7 @@ Vim-like commands can be used to navigate within a patch file:
- `gg` / `G` moves to cursor to the start / end of the file
- `Ctrl-D` / `Ctrl-U` scrolls downwards / upwards
Please check the link:http://www.vim.org/docs.php[Vim documentation]
Please check the link:http://www.vim.org/docs.php[Vim documentation,role=external,window=_blank]
for further information.
[[diff-preferences]]

14
Documentation/user-search.txt
View File

@ -161,7 +161,7 @@ project:'PROJECT', p:'PROJECT'::
Changes occurring in 'PROJECT'. If 'PROJECT' starts with `^` it
matches project names by regular expression. The
link:http://www.brics.dk/automaton/[dk.brics.automaton
library] is used for evaluation of such patterns.
library,role=external,window=_blank] is used for evaluation of such patterns.
[[projects]]
projects:'PREFIX'::
@ -180,7 +180,7 @@ repository:'REPOSITORY', repo:'REPOSITORY'::
Changes occurring in 'REPOSITORY'. If 'REPOSITORY' starts with `^` it
matches repository names by regular expression. The
link:http://www.brics.dk/automaton/[dk.brics.automaton
library] is used for evaluation of such patterns.
library,role=external,window=_blank] is used for evaluation of such patterns.
[[repositories]]
repositories:'PREFIX', repos:'PREFIX'::
@ -203,7 +203,7 @@ the traditional 'refs/heads/' prefix.
If 'BRANCH' starts with `^` it matches branch names by regular
expression patterns. The
link:http://www.brics.dk/automaton/[dk.brics.automaton
library] is used for evaluation of such patterns.
library,role=external,window=_blank] is used for evaluation of such patterns.
[[intopic]]
intopic:'TOPIC'::
@ -213,7 +213,7 @@ Changes whose designated topic contains 'TOPIC', using a full-text search.
If 'TOPIC' starts with `^` it matches topic names by regular
expression patterns. The
link:http://www.brics.dk/automaton/[dk.brics.automaton
library] is used for evaluation of such patterns.
library,role=external,window=_blank] is used for evaluation of such patterns.
[[topic]]
topic:'TOPIC'::
@ -238,7 +238,7 @@ must start with 'refs/'.
If 'REF' starts with `^` it matches reference names by regular
expression patterns. The
link:http://www.brics.dk/automaton/[dk.brics.automaton
library] is used for evaluation of such patterns.
library,role=external,window=_blank] is used for evaluation of such patterns.
[[tr,bug]]
tr:'ID', bug:'ID'::
@ -273,7 +273,7 @@ path:'PATH'::
Matches any change touching file at 'PATH'. By default exact path
matching is used, but regular expressions can be enabled by starting
with `^`. For example, to match all XML files use `file:^.*\.xml$`.
The link:http://www.brics.dk/automaton/[dk.brics.automaton library]
The link:http://www.brics.dk/automaton/[dk.brics.automaton library,role=external,window=_blank]
is used for the evaluation of such patterns.
+
The `^` required at the beginning of the regular expression not only
@ -332,7 +332,7 @@ but are not mandatory.
+
If 'DIR' starts with `^` it matches directories and directory segments by
regular expression. The link:http://www.brics.dk/automaton/[dk.brics.automaton
library] is used for evaluation of such patterns.
library,role=external,window=_blank] is used for evaluation of such patterns.
[[footer-operator]]
footer:'FOOTER'::

2
Documentation/user-signedoffby.txt
View File

@ -1,7 +1,7 @@
= Gerrit Code Review - Signed-off-by Lines
[NOTE]
This document was literally taken from link:http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob;f=Documentation/SubmittingPatches;hb=4e8a2372f9255a1464ef488ed925455f53fbdaa1[linux-2.6 Documentation/SubmittingPatches]
This document was literally taken from link:http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob;f=Documentation/SubmittingPatches;hb=4e8a2372f9255a1464ef488ed925455f53fbdaa1[linux-2.6 Documentation/SubmittingPatches,role=external,window=_blank]
and is covered by the GPLv2.
[[Signed-off-by]]

2
Documentation/user-upload.txt
View File

@ -618,7 +618,7 @@ To create multiple new changes, run push multiple times.
repo is a multiple repository management tool, most commonly
used by the Android Open Source Project. For more details, see
link:http://source.android.com/source/using-repo.html[using repo].
link:http://source.android.com/source/using-repo.html[using repo,role=external,window=_blank].
[[repo_create]]
=== Create Changes