Added comments for LXR.

rdf/base/src/nsContainerCursor.cpp

@@ -16,21 +16,10 @@
  * Reserved.
  */
 
-#include "nscore.h"
-#include "nsIRDFCursor.h"
-#include "nsIRDFDataSource.h"
-#include "nsIRDFNode.h"
-#include "nsIRDFService.h"
-#include "nsIServiceManager.h"
-#include "nsRDFCID.h"
-#include "nsString.h"
-#include "prlog.h"
-#include "rdf.h"
-#include "rdfutil.h"
-
 /*
 
-  A simple cursor that enumerates the elements of a container.
+  A simple cursor that enumerates the elements of an RDF container
+  (RDF:Bag, RDF:Seq, or RDF:Alt).
 
   Caveats
   -------
@@ -50,6 +39,18 @@
 
  */
 
+#include "nscore.h"
+#include "nsIRDFCursor.h"
+#include "nsIRDFDataSource.h"
+#include "nsIRDFNode.h"
+#include "nsIRDFService.h"
+#include "nsIServiceManager.h"
+#include "nsRDFCID.h"
+#include "nsString.h"
+#include "prlog.h"
+#include "rdf.h"
+#include "rdfutil.h"
+
 ////////////////////////////////////////////////////////////////////////
 
 static NS_DEFINE_IID(kIRDFAssertionCursorIID, NS_IRDFASSERTIONCURSOR_IID);

rdf/base/src/nsEmptyCursor.cpp

@@ -16,6 +16,15 @@
  * Reserved.
  */
 
+/*
+
+  A set of "empty cursors" (nsIRDFAssertionCursor,
+  nsIRDFArcsOutCursor, nsIRDFArcsInCursor) that can be used to ensure
+  that the data source methods which return a cursor always return
+  *something*.
+
+ */
+
 #include "nscore.h"
 #include "nsIRDFCursor.h"