diff --git a/brkga_mp_ipr_java/src/main/java/brkga/BrkgaMpIpr.java b/brkga_mp_ipr_java/src/main/java/brkga/BrkgaMpIpr.java
index 3f11fc1..6cb8e6e 100644
--- a/brkga_mp_ipr_java/src/main/java/brkga/BrkgaMpIpr.java
+++ b/brkga_mp_ipr_java/src/main/java/brkga/BrkgaMpIpr.java
@@ -249,9 +249,9 @@ public BrkgaMpIpr(Brkga brkga, Decoder decoder, Sense sense, int seed,
     /**
      * Adds a callback called when the best solution is improved.
      *
-     * <p>The observer receives an {@link AlgorithmStatus} and returns {@code true} if
-     * the algorithm should stop immediately. You may add as many observers as you
-     * want; they are called in the order they are added.
+     * <p>The observer receives an {@link AlgorithmStatus} and returns {@code true} to
+     * keep the optimization running, or {@code false} to stop it immediately. You may
+     * add as many observers as you want; they are called in the order they are added.
      *
      * @param observer the {@link NewSolutionObserver} callback to be invoked on each
      *                 improvement of the best solution.