From 275755870eb9092de58fbcff58d15be62263aad2 Mon Sep 17 00:00:00 2001
From: "waterson%netscape.com" <waterson%netscape.com>
Date: Tue, 5 Jan 1999 21:07:09 +0000
Subject: [PATCH] Added comments for LXR.

---
 rdf/base/src/nsContainerCursor.cpp | 27 ++++++++++++++-------------
 rdf/base/src/nsEmptyCursor.cpp     |  9 +++++++++
 2 files changed, 23 insertions(+), 13 deletions(-)

diff --git a/rdf/base/src/nsContainerCursor.cpp b/rdf/base/src/nsContainerCursor.cpp
index d9505077049..b8b5da7ee73 100644
--- a/rdf/base/src/nsContainerCursor.cpp
+++ b/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);
diff --git a/rdf/base/src/nsEmptyCursor.cpp b/rdf/base/src/nsEmptyCursor.cpp
index d0e71ba9a13..434a26cb954 100644
--- a/rdf/base/src/nsEmptyCursor.cpp
+++ b/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"