--- a/doc/book/en/development/entityclasses/interfaces.rst	Fri Apr 02 16:10:35 2010 +0200
+++ b/doc/book/en/development/entityclasses/interfaces.rst	Fri Apr 02 17:27:53 2010 +0200
@@ -1,7 +1,9 @@
 Interfaces
 ----------
 
-Same thing as object-oriented programming interfaces.
+This is the same thing as object-oriented programming `interfaces`_.
+
+.. _`interfaces`: http://java.sun.com/docs/books/tutorial/java/concepts/interface.html
 
 Definition of an interface is quite trivial. An example from cubicweb
 itself (found in cubicweb/interfaces.py):
@@ -17,7 +19,7 @@
             """returns the item's children"""
 
         def children_rql(self):
-            """XXX returns RQL to get children"""
+            """returns RQL to get children"""
 
         def iterchildren(self):
             """iterates over the item's children"""