Skip to content

Conversation

@Tanush-Jain
Copy link

This pull request is addressing the issue of
"Cache's compute misreports the removal cause of a collected entry #7985"
so it adds comprehensive Javadoc documentation to the compute method in the Cache interface (guava/guava/src/com/google/common/cache/Cache.java). The method was previously undocumented, which was inconsistent with the detailed documentation provided for other methods in the interface.

Changes Made :

  1. Added detailed Javadoc comment to the compute method, describing its atomic behavior, parameters, return value, and exception handling.
  2. Included the @CanIgnoreReturnValue annotation for consistency with similar methods.
  3. Added the @SInCE 23.0 annotation to indicate the version when this method was introduced.
  4. Ensured the documentation style matches the existing Javadoc format in the file.

Testing:
No functional changes were made; this is purely a documentation update. Existing tests should continue to pass.

@google-cla
Copy link

google-cla bot commented Nov 8, 2025

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@Tanush-Jain Tanush-Jain force-pushed the Add-javadoc-cache-compute branch from 31b2079 to 2b1c39e Compare November 8, 2025 14:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant