From 34253376e6a5bb97054b330767d1b799c1037cce Mon Sep 17 00:00:00 2001 From: Marian Harbach Date: Tue, 10 Dec 2019 18:01:31 +0100 Subject: [PATCH] Make all external links in the documentation open in a new window 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 --- Documentation/access-control.txt | 8 +- Documentation/backup.txt | 20 +- Documentation/cmd-hook-commit-msg.txt | 4 +- Documentation/concept-refs-for-namespace.txt | 2 +- Documentation/config-accounts.txt | 4 +- Documentation/config-gerrit.txt | 68 ++--- Documentation/config-gitweb.txt | 12 +- Documentation/config-hooks.txt | 2 +- Documentation/config-mail.txt | 2 +- Documentation/config-plugins.txt | 286 +++++++++--------- Documentation/config-sso.txt | 8 +- Documentation/dev-bazel.txt | 26 +- Documentation/dev-cla.txt | 8 +- Documentation/dev-community.txt | 14 +- Documentation/dev-contributing.txt | 6 +- Documentation/dev-core-plugins.txt | 6 +- Documentation/dev-crafting-changes.txt | 10 +- Documentation/dev-design-docs.txt | 6 +- Documentation/dev-design.txt | 12 +- Documentation/dev-e2e-tests.txt | 6 +- Documentation/dev-eclipse.txt | 6 +- Documentation/dev-inspector.txt | 4 +- Documentation/dev-intellij.txt | 10 +- Documentation/dev-plugins-lifecycle.txt | 30 +- Documentation/dev-plugins.txt | 20 +- Documentation/dev-processes.txt | 14 +- Documentation/dev-readme.txt | 4 +- Documentation/dev-release-deploy-config.txt | 12 +- Documentation/dev-release-jgit.txt | 2 +- Documentation/dev-release.txt | 24 +- Documentation/dev-roles.txt | 50 +-- Documentation/dev-starter-projects.txt | 4 +- Documentation/error-change-closed.txt | 2 +- Documentation/error-changeid-above-footer.txt | 2 +- .../error-contains-banned-commit.txt | 2 +- Documentation/error-has-duplicates.txt | 2 +- Documentation/error-invalid-author.txt | 2 +- Documentation/error-invalid-changeid-line.txt | 2 +- Documentation/error-invalid-committer.txt | 2 +- Documentation/error-missing-changeid.txt | 2 +- Documentation/error-missing-subject.txt | 2 +- .../error-multiple-changeid-lines.txt | 2 +- Documentation/error-no-new-changes.txt | 2 +- Documentation/error-non-fast-forward.txt | 6 +- .../error-not-allowed-to-upload-merges.txt | 2 +- Documentation/error-permission-denied.txt | 4 +- ...error-push-fails-due-to-commit-message.txt | 4 +- ...ror-same-change-id-in-multiple-changes.txt | 4 +- Documentation/error-upload-denied.txt | 2 +- Documentation/index.txt | 14 +- Documentation/install-j2ee.txt | 4 +- Documentation/install.txt | 16 +- .../intro-gerrit-walkthrough-github.txt | 10 +- Documentation/intro-gerrit-walkthrough.txt | 4 +- Documentation/intro-project-owner.txt | 46 +-- Documentation/intro-quick.txt | 4 +- Documentation/intro-rockstar.txt | 6 +- Documentation/intro-user.txt | 18 +- Documentation/linux-quickstart.txt | 2 +- Documentation/note-db.txt | 4 +- Documentation/pg-plugin-dev.txt | 8 +- Documentation/pg-plugin-migration.txt | 2 +- Documentation/pg-plugin-styling.txt | 8 +- .../pgm-MigrateAccountPatchReviewDb.txt | 2 +- Documentation/prolog-cookbook.txt | 14 +- Documentation/quota.txt | 2 +- Documentation/rest-api-accounts.txt | 2 +- Documentation/rest-api-changes.txt | 10 +- Documentation/rest-api-projects.txt | 2 +- Documentation/rest-api.txt | 2 +- Documentation/user-inline-edit.txt | 2 +- Documentation/user-request-tracing.txt | 2 +- Documentation/user-review-ui.txt | 6 +- Documentation/user-search.txt | 14 +- Documentation/user-signedoffby.txt | 2 +- Documentation/user-upload.txt | 2 +- 76 files changed, 471 insertions(+), 471 deletions(-) diff --git a/Documentation/access-control.txt b/Documentation/access-control.txt index d3333476e3..77a58fa41b 100644 --- a/Documentation/access-control.txt +++ b/Documentation/access-control.txt @@ -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 diff --git a/Documentation/backup.txt b/Documentation/backup.txt index cd247af828..624ffcba4e 100644 --- a/Documentation/backup.txt +++ b/Documentation/backup.txt @@ -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. diff --git a/Documentation/cmd-hook-commit-msg.txt b/Documentation/cmd-hook-commit-msg.txt index 49d5c173be..8d81768999 100644 --- a/Documentation/cmd-hook-commit-msg.txt +++ b/Documentation/cmd-hook-commit-msg.txt @@ -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 diff --git a/Documentation/concept-refs-for-namespace.txt b/Documentation/concept-refs-for-namespace.txt index c8776ae1ae..ee0be39fe9 100644 --- a/Documentation/concept-refs-for-namespace.txt +++ b/Documentation/concept-refs-for-namespace.txt @@ -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]`. diff --git a/Documentation/config-accounts.txt b/Documentation/config-accounts.txt index 45aa42a432..cdca0a4c83 100644 --- a/Documentation/config-accounts.txt +++ b/Documentation/config-accounts.txt @@ -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 diff --git a/Documentation/config-gerrit.txt b/Documentation/config-gerrit.txt index d126c9637f..bb6cf89cdb 100644 --- a/Documentation/config-gerrit.txt +++ b/Documentation/config-gerrit.txt @@ -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 `/info/lfs/objects/batch` endpoint. When +LFS protocol,role=external,window=_blank] on the `/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..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. diff --git a/Documentation/config-gitweb.txt b/Documentation/config-gitweb.txt index d49acfeece..fe2358393e 100644 --- a/Documentation/config-gitweb.txt +++ b/Documentation/config-gitweb.txt @@ -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 ------ diff --git a/Documentation/config-hooks.txt b/Documentation/config-hooks.txt index 835ec1121c..f44638bce8 100644 --- a/Documentation/config-hooks.txt +++ b/Documentation/config-hooks.txt @@ -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 ------ diff --git a/Documentation/config-mail.txt b/Documentation/config-mail.txt index 7d46e26850..e52406530f 100644 --- a/Documentation/config-mail.txt +++ b/Documentation/config-mail.txt @@ -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 diff --git a/Documentation/config-plugins.txt b/Documentation/config-plugins.txt index af00d1c23d..818d701086 100644 --- a/Documentation/config-plugins.txt +++ b/Documentation/config-plugins.txt @@ -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 diff --git a/Documentation/config-sso.txt b/Documentation/config-sso.txt index 6f3a32d826..7a68689f4e 100644 --- a/Documentation/config-sso.txt +++ b/Documentation/config-sso.txt @@ -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 diff --git a/Documentation/dev-bazel.txt b/Documentation/dev-bazel.txt index 436b91848f..6a046ee1db 100644 --- a/Documentation/dev-bazel.txt +++ b/Documentation/dev-bazel.txt @@ -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 <>. === 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: ---- diff --git a/Documentation/dev-cla.txt b/Documentation/dev-cla.txt index 267351f279..9997178bc4 100644 --- a/Documentation/dev-cla.txt +++ b/Documentation/dev-cla.txt @@ -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 ------ diff --git a/Documentation/dev-community.txt b/Documentation/dev-community.txt index a49706452b..ed9eeadfcd 100644 --- a/Documentation/dev-community.txt +++ b/Documentation/dev-community.txt @@ -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] diff --git a/Documentation/dev-contributing.txt b/Documentation/dev-contributing.txt index 0bac643f41..5e9156b114 100644 --- a/Documentation/dev-contributing.txt +++ b/Documentation/dev-contributing.txt @@ -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 diff --git a/Documentation/dev-core-plugins.txt b/Documentation/dev-core-plugins.txt index 11027efd17..1b49097950 100644 --- a/Documentation/dev-core-plugins.txt +++ b/Documentation/dev-core-plugins.txt @@ -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: + diff --git a/Documentation/dev-crafting-changes.txt b/Documentation/dev-crafting-changes.txt index eb9dee4bd6..d691280f2e 100644 --- a/Documentation/dev-crafting-changes.txt +++ b/Documentation/dev-crafting-changes.txt @@ -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, diff --git a/Documentation/dev-design-docs.txt b/Documentation/dev-design-docs.txt index 5e3f7a9c25..ca5ff62fea 100644 --- a/Documentation/dev-design-docs.txt +++ b/Documentation/dev-design-docs.txt @@ -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` diff --git a/Documentation/dev-design.txt b/Documentation/dev-design.txt index fd53cac066..8ad400b44f 100644 --- a/Documentation/dev-design.txt +++ b/Documentation/dev-design.txt @@ -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 diff --git a/Documentation/dev-e2e-tests.txt b/Documentation/dev-e2e-tests.txt index 7329a43669..d13d29c754 100644 --- a/Documentation/dev-e2e-tests.txt +++ b/Documentation/dev-e2e-tests.txt @@ -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 diff --git a/Documentation/dev-eclipse.txt b/Documentation/dev-eclipse.txt index dfe6aa5588..2e4f553a22 100644 --- a/Documentation/dev-eclipse.txt +++ b/Documentation/dev-eclipse.txt @@ -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. diff --git a/Documentation/dev-inspector.txt b/Documentation/dev-inspector.txt index 39736d7a0e..31ad9fa423 100644 --- a/Documentation/dev-inspector.txt +++ b/Documentation/dev-inspector.txt @@ -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. diff --git a/Documentation/dev-intellij.txt b/Documentation/dev-intellij.txt index 81790dbbab..5399928634 100644 --- a/Documentation/dev-intellij.txt +++ b/Documentation/dev-intellij.txt @@ -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 <> in combination with <>. -(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 diff --git a/Documentation/dev-plugins-lifecycle.txt b/Documentation/dev-plugins-lifecycle.txt index b552472efe..fb9e4a0d44 100644 --- a/Documentation/dev-plugins-lifecycle.txt +++ b/Documentation/dev-plugins-lifecycle.txt @@ -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. diff --git a/Documentation/dev-plugins.txt b/Documentation/dev-plugins.txt index b7b807f3c0..5910a7c43e 100644 --- a/Documentation/dev-plugins.txt +++ b/Documentation/dev-plugins.txt @@ -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 `/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`. diff --git a/Documentation/dev-processes.txt b/Documentation/dev-processes.txt index 6472f2a32a..423f484b98 100644 --- a/Documentation/dev-processes.txt +++ b/Documentation/dev-processes.txt @@ -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 diff --git a/Documentation/dev-readme.txt b/Documentation/dev-readme.txt index 34b409c122..03ea81d971 100644 --- a/Documentation/dev-readme.txt +++ b/Documentation/dev-readme.txt @@ -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: diff --git a/Documentation/dev-release-deploy-config.txt b/Documentation/dev-release-deploy-config.txt index 98a3df572d..db8165d5ac 100644 --- a/Documentation/dev-release-deploy-config.txt +++ b/Documentation/dev-release-deploy-config.txt @@ -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'. diff --git a/Documentation/dev-release-jgit.txt b/Documentation/dev-release-jgit.txt index 1a8b501a3c..23a82fe6e6 100644 --- a/Documentation/dev-release-jgit.txt +++ b/Documentation/dev-release-jgit.txt @@ -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 diff --git a/Documentation/dev-release.txt b/Documentation/dev-release.txt index 9e1744c97d..e62ff43ba8 100644 --- a/Documentation/dev-release.txt +++ b/Documentation/dev-release.txt @@ -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. diff --git a/Documentation/dev-roles.txt b/Documentation/dev-roles.txt index f4576679fb..d3811b97a2 100644 --- a/Documentation/dev-roles.txt +++ b/Documentation/dev-roles.txt @@ -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. diff --git a/Documentation/dev-starter-projects.txt b/Documentation/dev-starter-projects.txt index ae40ea645f..ffc816b036 100644 --- a/Documentation/dev-starter-projects.txt +++ b/Documentation/dev-starter-projects.txt @@ -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 ------ diff --git a/Documentation/error-change-closed.txt b/Documentation/error-change-closed.txt index a239ef1088..387cc46f2f 100644 --- a/Documentation/error-change-closed.txt +++ b/Documentation/error-change-closed.txt @@ -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 diff --git a/Documentation/error-changeid-above-footer.txt b/Documentation/error-changeid-above-footer.txt index abc0186758..b3eb30e0aa 100644 --- a/Documentation/error-changeid-above-footer.txt +++ b/Documentation/error-changeid-above-footer.txt @@ -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 diff --git a/Documentation/error-contains-banned-commit.txt b/Documentation/error-contains-banned-commit.txt index 13a0eaa026..cd69b2a110 100644 --- a/Documentation/error-contains-banned-commit.txt +++ b/Documentation/error-contains-banned-commit.txt @@ -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. diff --git a/Documentation/error-has-duplicates.txt b/Documentation/error-has-duplicates.txt index a520f5d81a..7168aaec80 100644 --- a/Documentation/error-has-duplicates.txt +++ b/Documentation/error-has-duplicates.txt @@ -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 diff --git a/Documentation/error-invalid-author.txt b/Documentation/error-invalid-author.txt index 5808d4f8fe..d2b7f8391b 100644 --- a/Documentation/error-invalid-author.txt +++ b/Documentation/error-invalid-author.txt @@ -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 diff --git a/Documentation/error-invalid-changeid-line.txt b/Documentation/error-invalid-changeid-line.txt index 9d3d2fcaf2..63323bf326 100644 --- a/Documentation/error-invalid-changeid-line.txt +++ b/Documentation/error-invalid-changeid-line.txt @@ -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 diff --git a/Documentation/error-invalid-committer.txt b/Documentation/error-invalid-committer.txt index a6690105d2..ca35d6ab38 100644 --- a/Documentation/error-invalid-committer.txt +++ b/Documentation/error-invalid-committer.txt @@ -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 diff --git a/Documentation/error-missing-changeid.txt b/Documentation/error-missing-changeid.txt index 27bfea580b..866fb8c67d 100644 --- a/Documentation/error-missing-changeid.txt +++ b/Documentation/error-missing-changeid.txt @@ -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 diff --git a/Documentation/error-missing-subject.txt b/Documentation/error-missing-subject.txt index 6ef37a4577..0903ead793 100644 --- a/Documentation/error-missing-subject.txt +++ b/Documentation/error-missing-subject.txt @@ -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 diff --git a/Documentation/error-multiple-changeid-lines.txt b/Documentation/error-multiple-changeid-lines.txt index 31567f4f21..6564949bd0 100644 --- a/Documentation/error-multiple-changeid-lines.txt +++ b/Documentation/error-multiple-changeid-lines.txt @@ -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 diff --git a/Documentation/error-no-new-changes.txt b/Documentation/error-no-new-changes.txt index 17422add03..24f8dc0c92 100644 --- a/Documentation/error-no-new-changes.txt +++ b/Documentation/error-no-new-changes.txt @@ -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. diff --git a/Documentation/error-non-fast-forward.txt b/Documentation/error-non-fast-forward.txt index 923132e174..0cbda6bfbc 100644 --- a/Documentation/error-non-fast-forward.txt +++ b/Documentation/error-non-fast-forward.txt @@ -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. diff --git a/Documentation/error-not-allowed-to-upload-merges.txt b/Documentation/error-not-allowed-to-upload-merges.txt index d025bd09b7..ca44a09bb2 100644 --- a/Documentation/error-not-allowed-to-upload-merges.txt +++ b/Documentation/error-not-allowed-to-upload-merges.txt @@ -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 diff --git a/Documentation/error-permission-denied.txt b/Documentation/error-permission-denied.txt index 879273d57a..7eb9428c22 100644 --- a/Documentation/error-permission-denied.txt +++ b/Documentation/error-permission-denied.txt @@ -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 diff --git a/Documentation/error-push-fails-due-to-commit-message.txt b/Documentation/error-push-fails-due-to-commit-message.txt index f6e5c1f31e..ba941e56e0 100644 --- a/Documentation/error-push-fails-due-to-commit-message.txt +++ b/Documentation/error-push-fails-due-to-commit-message.txt @@ -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 diff --git a/Documentation/error-same-change-id-in-multiple-changes.txt b/Documentation/error-same-change-id-in-multiple-changes.txt index b6aad6979e..25e58c89b2 100644 --- a/Documentation/error-same-change-id-in-multiple-changes.txt +++ b/Documentation/error-same-change-id-in-multiple-changes.txt @@ -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. diff --git a/Documentation/error-upload-denied.txt b/Documentation/error-upload-denied.txt index 30c5f2dd10..5e5a409103 100644 --- a/Documentation/error-upload-denied.txt +++ b/Documentation/error-upload-denied.txt @@ -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 diff --git a/Documentation/index.txt b/Documentation/index.txt index 63671cd81b..09cb21f4e0 100644 --- a/Documentation/index.txt +++ b/Documentation/index.txt @@ -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 ------ diff --git a/Documentation/install-j2ee.txt b/Documentation/install-j2ee.txt index 48751b761c..1f5f89559d 100644 --- a/Documentation/install-j2ee.txt +++ b/Documentation/install-j2ee.txt @@ -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: diff --git a/Documentation/install.txt b/Documentation/install.txt index fe32029416..12b4e32198 100644 --- a/Documentation/install.txt +++ b/Documentation/install.txt @@ -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]] diff --git a/Documentation/intro-gerrit-walkthrough-github.txt b/Documentation/intro-gerrit-walkthrough-github.txt index 39a779d194..cee97b1560 100644 --- a/Documentation/intro-gerrit-walkthrough-github.txt +++ b/Documentation/intro-gerrit-walkthrough-github.txt @@ -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! diff --git a/Documentation/intro-gerrit-walkthrough.txt b/Documentation/intro-gerrit-walkthrough.txt index a631b47360..15781c2ab1 100644 --- a/Documentation/intro-gerrit-walkthrough.txt +++ b/Documentation/intro-gerrit-walkthrough.txt @@ -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 diff --git a/Documentation/intro-project-owner.txt b/Documentation/intro-project-owner.txt index 1f98291382..e465376f32 100644 --- a/Documentation/intro-project-owner.txt +++ b/Documentation/intro-project-owner.txt @@ -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` > > `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/`. 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` > > `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]. diff --git a/Documentation/intro-quick.txt b/Documentation/intro-quick.txt index 11d505270f..a8ebdc620f 100644 --- a/Documentation/intro-quick.txt +++ b/Documentation/intro-quick.txt @@ -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 ------ diff --git a/Documentation/intro-rockstar.txt b/Documentation/intro-rockstar.txt index 0b679502a6..025e024a1e 100644 --- a/Documentation/intro-rockstar.txt +++ b/Documentation/intro-rockstar.txt @@ -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 diff --git a/Documentation/intro-user.txt b/Documentation/intro-user.txt index 16929ae481..28b5c09250 100644 --- a/Documentation/intro-user.txt +++ b/Documentation/intro-user.txt @@ -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]] diff --git a/Documentation/linux-quickstart.txt b/Documentation/linux-quickstart.txt index 0d8848e5f0..17a077704a 100644 --- a/Documentation/linux-quickstart.txt +++ b/Documentation/linux-quickstart.txt @@ -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 diff --git a/Documentation/note-db.txt b/Documentation/note-db.txt index 8725cee98d..94e1c5de47 100644 --- a/Documentation/note-db.txt +++ b/Documentation/note-db.txt @@ -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. diff --git a/Documentation/pg-plugin-dev.txt b/Documentation/pg-plugin-dev.txt index d90185147e..fee3be9ef3 100644 --- a/Documentation/pg-plugin-dev.txt +++ b/Documentation/pg-plugin-dev.txt @@ -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 `` 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 diff --git a/Documentation/pg-plugin-migration.txt b/Documentation/pg-plugin-migration.txt index 3ddceedb0e..1b1861d83c 100644 --- a/Documentation/pg-plugin-migration.txt +++ b/Documentation/pg-plugin-migration.txt @@ -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 diff --git a/Documentation/pg-plugin-styling.txt b/Documentation/pg-plugin-styling.txt index 2453bad0b8..0d5e1d13b1 100644 --- a/Documentation/pg-plugin-styling.txt +++ b/Documentation/pg-plugin-styling.txt @@ -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` + diff --git a/Documentation/pgm-MigrateAccountPatchReviewDb.txt b/Documentation/pgm-MigrateAccountPatchReviewDb.txt index c8ab19380c..597e33755b 100644 --- a/Documentation/pgm-MigrateAccountPatchReviewDb.txt +++ b/Documentation/pgm-MigrateAccountPatchReviewDb.txt @@ -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 diff --git a/Documentation/prolog-cookbook.txt b/Documentation/prolog-cookbook.txt index f291920d4a..b2fc52666b 100644 --- a/Documentation/prolog-cookbook.txt +++ b/Documentation/prolog-cookbook.txt @@ -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]] diff --git a/Documentation/quota.txt b/Documentation/quota.txt index a647e333fe..b2e63807b2 100644 --- a/Documentation/quota.txt +++ b/Documentation/quota.txt @@ -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 diff --git a/Documentation/rest-api-accounts.txt b/Documentation/rest-api-accounts.txt index 85cdaceced..fed5c0b697 100644 --- a/Documentation/rest-api-accounts.txt +++ b/Documentation/rest-api-accounts.txt @@ -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| diff --git a/Documentation/rest-api-changes.txt b/Documentation/rest-api-changes.txt index 67ae65c9cc..084f6afb89 100644 --- a/Documentation/rest-api-changes.txt +++ b/Documentation/rest-api-changes.txt @@ -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 diff --git a/Documentation/rest-api-projects.txt b/Documentation/rest-api-projects.txt index c373b96ff1..5a2ec473e4 100644 --- a/Documentation/rest-api-projects.txt +++ b/Documentation/rest-api-projects.txt @@ -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 diff --git a/Documentation/rest-api.txt b/Documentation/rest-api.txt index a8ab35347a..899e2915d1 100644 --- a/Documentation/rest-api.txt +++ b/Documentation/rest-api.txt @@ -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. diff --git a/Documentation/user-inline-edit.txt b/Documentation/user-inline-edit.txt index 1f5e1953b5..b872fc951e 100644 --- a/Documentation/user-inline-edit.txt +++ b/Documentation/user-inline-edit.txt @@ -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 diff --git a/Documentation/user-request-tracing.txt b/Documentation/user-request-tracing.txt index b26f4c1e7c..356d0c0769 100644 --- a/Documentation/user-request-tracing.txt +++ b/Documentation/user-request-tracing.txt @@ -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 diff --git a/Documentation/user-review-ui.txt b/Documentation/user-review-ui.txt index de17c00b0a..f1a9fa8cc9 100644 --- a/Documentation/user-review-ui.txt +++ b/Documentation/user-review-ui.txt @@ -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]] diff --git a/Documentation/user-search.txt b/Documentation/user-search.txt index bde9508420..cab95c7108 100644 --- a/Documentation/user-search.txt +++ b/Documentation/user-search.txt @@ -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':: diff --git a/Documentation/user-signedoffby.txt b/Documentation/user-signedoffby.txt index 507f4f276f..c52c18cb40 100644 --- a/Documentation/user-signedoffby.txt +++ b/Documentation/user-signedoffby.txt @@ -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]] diff --git a/Documentation/user-upload.txt b/Documentation/user-upload.txt index 6cf5587096..4eb59640f7 100644 --- a/Documentation/user-upload.txt +++ b/Documentation/user-upload.txt @@ -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