diff --git a/src/main/java/io/vertx/core/TimeoutStream.java b/src/main/java/io/vertx/core/TimeoutStream.java
index 5d5dab45e6c..8c95174a073 100644
--- a/src/main/java/io/vertx/core/TimeoutStream.java
+++ b/src/main/java/io/vertx/core/TimeoutStream.java
@@ -23,10 +23,9 @@
  * the timer.
  *
  * @author <a href="mailto:julien@julienviet.com">Julien Viet</a>
- * @deprecated instead using {@link Vertx#setTimer}/{@link Vertx#setPeriodic}, Rx java like integrations should use
- *             the Vert.s scheduler integration
+ * @deprecated use {@link Vertx#setTimer}/{@link Vertx#setPeriodic} instead. RxJava like integrations should use the Vert.x scheduler integration.
  */
-@Deprecated()
+@Deprecated
 @VertxGen
 public interface TimeoutStream extends ReadStream<Long> {
 
diff --git a/src/main/java/io/vertx/core/Vertx.java b/src/main/java/io/vertx/core/Vertx.java
index c30904c24b6..9b3a5679795 100644
--- a/src/main/java/io/vertx/core/Vertx.java
+++ b/src/main/java/io/vertx/core/Vertx.java
@@ -274,10 +274,9 @@ default DatagramSocket createDatagramSocket() {
    * Returns a one-shot timer as a read stream. The timer will be fired after {@code delay} milliseconds after
    * the {@link ReadStream#handler} has been called.
    *
-   * @param delay  the delay in milliseconds, after which the timer will fire
+   * @param delay the delay in milliseconds, after which the timer will fire
    * @return the timer stream
-   * @deprecated instead using {@link Vertx#setTimer}, Rx java like integrations should use
-   *             the Vert.s scheduler integration
+   * @deprecated use {@link Vertx#setTimer} instead. RxJava like integrations should use the Vert.x scheduler integration.
    */
   @Deprecated
   TimeoutStream timerStream(long delay);
@@ -311,8 +310,7 @@ default long setPeriodic(long delay, Handler<Long> handler) {
    *
    * @param delay  the delay in milliseconds, after which the timer will fire
    * @return the periodic stream
-   * @deprecated instead using {@link Vertx#setPeriodic}, Rx java like integrations should use
-   *             the Vert.s scheduler integration
+   * @deprecated use {@link Vertx#setPeriodic} instead. RxJava like integrations should use the Vert.x scheduler integration.
    */
   @Deprecated
   default TimeoutStream periodicStream(long delay) {
@@ -326,8 +324,7 @@ default TimeoutStream periodicStream(long delay) {
    * @param initialDelay the initial delay in milliseconds
    * @param delay the delay in milliseconds, after which the timer will fire
    * @return the periodic stream
-   * @deprecated instead using {@link Vertx#setPeriodic}, Rx java like integrations should use
-   *             the Vert.s scheduler integration
+   * @deprecated use {@link Vertx#setPeriodic} instead. RxJava like integrations should use the Vert.x scheduler integration.
    */
   @Deprecated
   TimeoutStream periodicStream(long initialDelay, long delay);