comments

1 files changed, 9 insertions, 1 deletions

diff --git a/sources/scala/xml/parsing/MarkupHandler.scala b/sources/scala/xml/parsing/MarkupHandler.scala
index 77d1dfb479..b1089a0a3b 100644
--- a/sources/scala/xml/parsing/MarkupHandler.scala
+++ b/sources/scala/xml/parsing/MarkupHandler.scala
@@ -2,7 +2,12 @@ package scala.xml.parsing;
 
 import scala.xml.dtd._ ;
 
-/** class that handles markup - provides callback methods to MarkupParser */
+/** class that handles markup - provides callback methods to MarkupParser.
+ *  the default is nonvalidating behaviour
+ *
+ *  @todo can we ignore more entity declarations (i.e. those with extIDs)?
+ *  @todo expanding entity references
+ */
 abstract class MarkupHandler {
 
   /** returns true is this markup handler is validing */
@@ -32,6 +37,7 @@ abstract class MarkupHandler {
   def comment(pos: Int, comment: String ): NodeSeq;
 
   /** callback method invoked by MarkupParser after parsing entity ref.
+   *  @todo expanding entity references
    */
   def entityRef(pos: Int, n: String): NodeSeq;
 
@@ -39,6 +45,8 @@ abstract class MarkupHandler {
    */
   def text(pos: Int, txt:String): NodeSeq;
 
+  // DTD handler methods
+
   def elemDecl(n: String, cmstr: String): Unit = {}
 
   def attListDecl(name: String, attList: List[AttrDecl]): Unit = {}