diff --git a/dsf/org.eclipse.cdt.dsf/src/org/eclipse/cdt/dsf/concurrent/IDsfStatusConstants.java b/dsf/org.eclipse.cdt.dsf/src/org/eclipse/cdt/dsf/concurrent/IDsfStatusConstants.java
index 56bab781a42..10052e73b55 100644
--- a/dsf/org.eclipse.cdt.dsf/src/org/eclipse/cdt/dsf/concurrent/IDsfStatusConstants.java
+++ b/dsf/org.eclipse.cdt.dsf/src/org/eclipse/cdt/dsf/concurrent/IDsfStatusConstants.java
@@ -14,7 +14,11 @@ package org.eclipse.cdt.dsf.concurrent;
 /**
  * Interface that hold the codes used when reporting status using the DSF 
  * Request Monitor. 
- * 
+ * <p>
+ * The error codes are ordered by severity so that clients can filter error
+ * reporting using these codes.  E.g. <code>getStatus().getCode() > INVALID_HANDLE</code> 
+ * can be used to filter out errors resulting from expected race conditions. 
+ * </p>
  * @since 1.0
  */
 public interface IDsfStatusConstants {