diff --git a/src/api/java/Solver.java b/src/api/java/Solver.java
index f312da051..231326107 100644
--- a/src/api/java/Solver.java
+++ b/src/api/java/Solver.java
@@ -127,13 +127,13 @@ public class Solver extends Z3Object
* using the Boolean constants in ps.
*
* Remarks:
- * This API is an alternative to with assumptions for
+ * This API is an alternative to {@link check} with assumptions for
* extracting unsat cores.
* Both APIs can be used in the same solver. The unsat core will contain a
* combination
- * of the Boolean variables provided using
+ * of the Boolean variables provided using {@link assertAndTrack}
* and the Boolean literals
- * provided using with assumptions.
+ * provided using {@link check} with assumptions.
**/
public void assertAndTrack(BoolExpr[] constraints, BoolExpr[] ps)
{
@@ -152,13 +152,13 @@ public class Solver extends Z3Object
* using the Boolean constant p.
*
* Remarks:
- * This API is an alternative to with assumptions for
+ * This API is an alternative to {@link check} with assumptions for
* extracting unsat cores.
* Both APIs can be used in the same solver. The unsat core will contain a
* combination
- * of the Boolean variables provided using
+ * of the Boolean variables provided using {@link assertAndTrack}
* and the Boolean literals
- * provided using with assumptions.
+ * provided using {@link check} with assumptions.
*/
public void assertAndTrack(BoolExpr constraint, BoolExpr p)
{
@@ -294,7 +294,7 @@ public class Solver extends Z3Object
}
/**
- * Create a clone of the current solver with respect to ctx.
+ * Create a clone of the current solver with respect to{@code ctx}.
*/
public Solver translate(Context ctx)
{