tree 6526b680260b9958dc715b79670905357b91f78c
parent 56d6c1068a02da7ae64dbf1843d23fce977f8fb0
author Patrick Hiesel <hiesel@google.com> 1530601778 +0200
committer Patrick Hiesel <hiesel@google.com> 1530687258 +0200

Add a marker annotation for methods called from the outside

Some methods in Gerrit are made public, while they wouldn't have to be
because they are called from code outside of Gerrit. This is rare, but
it happens.

This commit adds a marker annotation so that people reading the code
know why the method exists and why it has a broad visibility.

We want to keep the usage of this annotation to the absolute minimum
possible as Gerrit should be extended through plugins, hooks and the
API. The annotation is for when this isn't possible and it's usage can
remind us to check if the method is still needed from time to time.

This commit adds the first caller to demonstrate how the annotation is
used.

Change-Id: Ic0abd06e4bf9e70815e80680ae40bb837c18cdb7