diff --git a/api/src/main/java/jakarta/transaction/UserTransaction.java b/api/src/main/java/jakarta/transaction/UserTransaction.java
index 2cf8d37..b586146 100644
--- a/api/src/main/java/jakarta/transaction/UserTransaction.java
+++ b/api/src/main/java/jakarta/transaction/UserTransaction.java
@@ -97,7 +97,8 @@ void rollback() throws IllegalStateException, SecurityException,
     int getStatus() throws SystemException;
 
     /**
-     * Modify the timeout value that is associated with transactions started by the current thread with the begin method.
+     * Specifies the timeout value to be associated with transactions
+     * subsequently started by the current thread with the begin method.
      *
      * <p>
      * If an application has not called this method, the transaction service uses some default value for the transaction
@@ -112,7 +113,8 @@ void rollback() throws IllegalStateException, SecurityException,
     void setTransactionTimeout(int seconds) throws SystemException;
 
     /**
-     * Modify the read-only value that is associated with transactions started by the current thread with the begin method.
+     * Specifies the read-only value to be associated with transactions
+     * subsequently started by the current thread with the begin method.
      *
      * <p>
      * If an application has not called this method, the transaction service uses the default value {@code false} for the