diff --git a/src/main/java/net/onrc/onos/core/newintent/IdBlockAllocatorBasedIntentIdGenerator.java b/src/main/java/net/onrc/onos/core/newintent/IdBlockAllocatorBasedIntentIdGenerator.java
index 29f14a1..2e09698 100644
--- a/src/main/java/net/onrc/onos/core/newintent/IdBlockAllocatorBasedIntentIdGenerator.java
+++ b/src/main/java/net/onrc/onos/core/newintent/IdBlockAllocatorBasedIntentIdGenerator.java
@@ -18,9 +18,10 @@
     private IdBlock idBlock;
 
     /**
-     * Constructs a {@link IdBlockAllocatorBasedIntentIdGenerator}.
+     * Constructs an intent ID generator, which uses the specified ID block allocator
+     * to generate a global unique intent ID.
      *
-     * @param allocator ID block allocator, which is used in this class
+     * @param allocator the ID block allocator to use for generating intent IDs
      */
     public IdBlockAllocatorBasedIntentIdGenerator(IdBlockAllocator allocator) {
         this.allocator = checkNotNull(allocator);