From 87be4b14133fecbb85c8abc1cec7bf1a7d5d9cf8 Mon Sep 17 00:00:00 2001
From: Jamie Tanna <jamie@jamietanna.co.uk>
Date: Mon, 29 Jun 2020 08:53:13 +0100
Subject: [PATCH] Document using `@Mock` with method parameters

Although we've called it out in the [JUnit extension], we should also
make sure it's clear in the core documentation to make it more visible.

We can fully-quality the `@Test` annotation to make clear that it has to
be with JUnit 5.

Closes #1960.

[JUnit extension]: https://javadoc.io/doc/org.mockito/mockito-junit-jupiter/latest/org/mockito/junit/jupiter/MockitoExtension.html
---
 src/main/java/org/mockito/Mockito.java | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/main/java/org/mockito/Mockito.java b/src/main/java/org/mockito/Mockito.java
index 07a5dfcb56..f6d0870001 100644
--- a/src/main/java/org/mockito/Mockito.java
+++ b/src/main/java/org/mockito/Mockito.java
@@ -455,6 +455,9 @@
  *       &#064;Mock private UserProvider userProvider;
  *
  *       private ArticleManager manager;
+ *
+ *       @org.junit.jupiter.api.Test
+ *       void testSomethingInJunit5(@Mock ArticleDatabase database) {
  * </code></pre>
  *
  * <b>Important!</b> This needs to be somewhere in the base class or a test