diff --git a/libwccl/ops/rule.h b/libwccl/ops/rule.h
index 6b7a242760d9f396ee330aa00453cd8361abd2c5..f66f90307b6c0cd13c1029933367e62ad4564e95 100644
--- a/libwccl/ops/rule.h
+++ b/libwccl/ops/rule.h
@@ -30,7 +30,7 @@ public:
 	 * @param sentence_context SentenceContext of the Sentence to execute the Rule on.
 	 * @see execute() - equivalent method; the \link operator()() operator() \endlink allows
 	 * more convenient functional notation, however if you only have a pointer
-	 * you might prefer the apply method as shown below. The choice is yours.
+	 * you might prefer the execute method as shown below. The choice is yours.
 	 * \code
 	 * Bool res;
 	 * res = rule(sc);
@@ -39,7 +39,7 @@ public:
 	 * // or if you have a pointer...
 	 * res = (*rule_ptr)(sc);
 	 * // versus
-	 * res = rule_ptr->apply(sc);
+	 * res = rule_ptr->execute(sc);
 	 * \endcode
 	 */
 	Bool operator()(SentenceContext& sentence_context);
@@ -49,8 +49,6 @@ public:
 	 * not execute any of the rules if condition is false.
 	 * @returns True if any of the actions made a change, False otherwise.
 	 * @param sentence_context SentenceContext of the Sentence to execute the Rule on.
-	 * @note The result is conciously marked as const, so a copy of Rule data
-	 * is not created unless necessary.
 	 * @see \link operator()() operator() \endlink - an equivalent of this method that allows
 	 * functional notation, treating Rule directly as a function
 	 */