tree 7cce6c86fa2eb4def55d3813fd5658925d3ad9de
parent f6b7ffdbf4702aa92c2a449ce0c1705b9342a83a
author Luca Milanesio <luca.milanesio@gmail.com> 1633129821 +0100
committer Fabio Ponciroli <ponch78@gmail.com> 1711407357 +0000

Load an arbitrary version of change notes

The SHA1 of the change notes to load may be already
known to the caller of ChangeNotes.create() method hence
it can be passed as a version parameter to avoid an unneeded
ref lookup operation.

When the version passed isn't known, it can be given as
null parameter causing the lookup of the latest /meta ref
SHA1 from the repository's ref-database.

Allow skipping potentially hundreds of thousands of refs lookups
for large mono-repos when filtering refs from the repository based
on the change status.

Also document the different variants of ChangeNotes.create()
methods, highlighting their specific purpose and use-case.

This is a partial cherry-pick of Ia54acb37e1187.

Release-Notes: skip
Forward-Compatible: checked
Original-Author: Han-Wen Nienhuys <hanwen@google.com>
Change-Id: I359578a05ecad595fb64909398ea3fd069ff1a5f