Also port comments added on base/parent(s) (= "left-side" comments)

Previously, we filtered such comments as we didn't have the proper
porting logic for them in place. That logic requires that we use the
commit on which the comment was actually added and the commit to which
it should be ported. For comments directly added on a patchset commit
(= "right-side" comments), we could simply use the commits of the
original and target patchset. For comments on parent/base commits, we
need to lookup those commits first, which might even mean the generation
of the auto-merge commit on the target patchset if a comment is on
an auto-merge commit. Of course, we only lookup the commits we really
need for the porting computation.

For merge commits, we decided to support any possibly referenced parent
commit (e.g. auto-merge, parent 1, parent 2, potentially parent X if
the SHA-1-lookup mechanism supports parent X). Thus, the ported
comments feature stays independent of any restrictions we put on
comments (which might easily change over the lifetime of Gerrit).
Considering that we have restrictions in place but don't enforce them
on all endpoints (e.g. published comments may only be added on
auto-merge and not parent 1/2 for merge commits but draft comments may
appear anywhere and can be published afterwards) and that old comments
would never follow newly added restrictions, that's probably the safest
choice. Having that flexibility didn't cost us anything (as we needed
to cover each possible scenario in tests anyway).

Change-Id: I1a41bffe1bdcba412ce5c1d3c40f80894c3bfa60
2 files changed
tree: 2f1eecde6073e5a3cb0ba2f91b657e370f8f48b3
  1. .settings/
  2. .ts-out/
  3. antlr3/
  4. contrib/
  5. Documentation/
  6. e2e-tests/
  7. java/
  8. javatests/
  9. lib/
  10. modules/
  11. plugins/
  12. polygerrit-ui/
  13. prolog/
  14. prologtests/
  15. proto/
  16. resources/
  17. tools/
  18. webapp/
  19. .bazelignore
  20. .bazelproject
  21. .bazelrc
  22. .bazelversion
  23. .editorconfig
  24. .git-blame-ignore-revs
  25. .gitignore
  26. .gitmodules
  27. .gitreview
  28. .mailmap
  29. .pydevproject
  30. .zuul.yaml
  31. BUILD
  32. COPYING
  33. INSTALL
  34. Jenkinsfile
  35. package.json
  36. README.md
  37. SUBMITTING_PATCHES
  38. version.bzl
  39. WORKSPACE
  40. yarn.lock
README.md

Gerrit Code Review

Gerrit is a code review and project management tool for Git based projects.

Build Status Maven Central

Objective

Gerrit makes reviews easier by showing changes in a side-by-side display, and allowing inline comments to be added by any reviewer.

Gerrit simplifies Git based project maintainership by permitting any authorized user to submit changes to the master Git repository, rather than requiring all approved changes to be merged in by hand by the project maintainer.

Documentation

For information about how to install and use Gerrit, refer to the documentation.

Source

Our canonical Git repository is located on googlesource.com. There is a mirror of the repository on Github.

Reporting bugs

Please report bugs on the issue tracker.

Contribute

Gerrit is the work of hundreds of contributors. We appreciate your help!

Please read the contribution guidelines.

Note that we do not accept Pull Requests via the Github mirror.

Getting in contact

The Developer Mailing list is repo-discuss on Google Groups.

License

Gerrit is provided under the Apache License 2.0.

Build

Install Bazel and run the following:

    git clone --recurse-submodules https://gerrit.googlesource.com/gerrit
    cd gerrit && bazel build release

Install binary packages (Deb/Rpm)

The instruction how to configure GerritForge/BinTray repositories is here

On Debian/Ubuntu run:

    apt-get update & apt-get install gerrit=<version>-<release>

NOTE: release is a counter that starts with 1 and indicates the number of packages that have been released with the same version of the software.

On CentOS/RedHat run:

    yum clean all && yum install gerrit-<version>[-<release>]

On Fedora run:

    dnf clean all && dnf install gerrit-<version>[-<release>]

Use pre-built Gerrit images on Docker

Docker images of Gerrit are available on DockerHub

To run a CentOS 8 based Gerrit image:

    docker run -p 8080:8080 gerritcodereview/gerrit[:version]-centos8

To run a Ubuntu 20.04 based Gerrit image:

    docker run -p 8080:8080 gerritcodereview/gerrit[:version]-ubuntu20

NOTE: release is optional. Last released package of the version is installed if the release number is omitted.