[Java] Deprecate timout in favour of library based solutions

## Summary

It is possible to provide a timeout to step definitions, however the
semantics are unreliable ( #1506).

```java
@given(value = "^I have (\\d+) cukes in my belly$", timeout = 5000)
public void I_have_cukes_in_my_belly(int cukes) throws Throwable {

}
```

Fixes: #1694

## Current Behavior

When the step starts a long running task Cucumber will attempt to
interrupt the step once the timeout period is exceeded. If the long
running task ignores the interrupt Cucumber will however not stop the
test. Depending on the context this behavior is either desired or
undesirable. See #1506 for in detail discussion.

Additionally the current implementation is complex and has been prone
to failures (#1244, #1241, #811, #639, #540).

## Possible Solution

While it is possible to implement different strategies to deal with
timeouts; there is no perfect solution. And regardless of which solution
we pick we would take on a significant amount of complexity. So I
believe that for Cucumber there is no good solution.

However this problem has been solved by various libraries:

 * [JUnit 5 `Assertions.assertTimeout*`](https://junit.org/junit5/docs/5.0.1/api/org/junit/jupiter/api/Assertions.html#assertTimeout-java.time.Duration-org.junit.jupiter.api.function.Executable-)
 * [Awaitility](https://github.com/awaitility/awaitility)
 * [Guava `TimeLimiter`](https://github.com/google/guava/blob/master/guava/src/com/google/common/util/concurrent/TimeLimiter.java)

So rather then keeping a poor feature alive we should recommend users
to migrate to third party solutions.

## Context & Motivation

Remove the eldritch horror that is `Invoker/Timeout.timeout`. While this
could have been done in v4.x, v5 will use Java 8 and most of the above
libraries require Java 8.

java/src/main/groovy/annotation.java.gsp

@@ -52,7 +52,10 @@ public @interface ${kw} {
      * cucumber will wait for the this hook to finish.
      *
      * @return timeout in milliseconds. 0 (default) means no restriction.
+     * @deprecated use a library based solution instead. E.g. Awaitility
+     * or JUnit 5s Assertions.assertTimeout.
      */
+    @Deprecated
     long timeout() default 0;
 
     /**

java8/src/main/groovy/lambda.java.gsp

@@ -63,7 +63,10 @@ public interface ${className} extends LambdaGlue {
      * @param expression    the cucumber expression
      * @param timeoutMillis timeout in milliseconds. 0 (default) means no restriction.
      * @param body          a lambda expression with no parameters
+     * @deprecated use a library based solution instead. E.g. Awaitility
+     * or JUnit 5s Assertions.assertTimeout.
      */
+    @Deprecated
     default void ${java.text.Normalizer.normalize(kw.replaceAll("[\\s',!]", ""), java.text.Normalizer.Form.NFC)}(String expression, long timeoutMillis, A0 body) {
         LambdaGlueRegistry.INSTANCE.get().addStepDefinition((typeRegistry) ->
             Java8StepDefinition.create(expression, timeoutMillis, A0.class, body, typeRegistry)
@@ -101,7 +104,10 @@ public interface ${className} extends LambdaGlue {
      * @param body          a lambda expression with ${arity} parameters
      * <% (1..arity).each { i -> %>
      * @param <T${i}> type of argument ${i} <% } %>
+     * @deprecated use a library based solution instead. E.g. Awaitility
+     * or JUnit 5s Assertions.assertTimeout.
      */
+    @Deprecated
     default <${genericSignature}> void ${java.text.Normalizer.normalize(kw.replaceAll("[\\s',!]", ""), java.text.Normalizer.Form.NFC)}(String expression, long timeoutMillis, A${arity}<${genericSignature}> body) {
         LambdaGlueRegistry.INSTANCE.get().addStepDefinition((typeRegistry) ->
             Java8StepDefinition.create(expression, timeoutMillis, A${arity}.class, body, typeRegistry)