diff --git a/src/main/java/com/jayway/awaitility/core/ConditionFactory.java b/src/main/java/com/jayway/awaitility/core/ConditionFactory.java
index <HASH>..<HASH> 100755
--- a/src/main/java/com/jayway/awaitility/core/ConditionFactory.java
+++ b/src/main/java/com/jayway/awaitility/core/ConditionFactory.java
@@ -282,6 +282,11 @@ public class ConditionFactory {
 
 	/**
 	 * Specify the condition that must be met when waiting for a method call.
+	 * E.g.
+	 * 
+	 * <pre>
+	 * await().until(callTo(orderService).size(), is(greaterThan(2)));
+	 * </pre>
 	 * 
 	 * @param <T>
 	 *            the generic type
Improved javadoc for until method i ConditionFactory