[jdom-commits] CVS update: jdom

[jhunter at cvs.jdom.org]

Date:	Wednesday May 9, 2001 @ 8:17
Author:	jhunter

Update of /home/cvspublic/jdom
In directory www.nmemonix.com:/tmp/cvs-serv15050

Modified Files:
	TODO.txt 
Log Message:
Removed the following major task now that it's implemented.

* Straighten up the Entity API.  Have a builder flag on whether or not to
  expand entities.  Have a default of expansion.  That produces a doc without
  regard for entity sources.  If expansion is off, then populate the doc with
  EntityRef nodes which hold the information about the entity but don't
  contain its contents.  XMLOutputter will in the non-expanded case be able
  to retain the original entity names and locations.  The reason not to do a
  hybrid of keeping entities and expanding is that then what do you do if you
  change the content within the "entity"?  You can't do anything because on
  output you aren't writing the file that holds that content.  So either it's
  this doc's content now, or it's held only as a ref.  Make sure DOMBuilder
  and SAXBuilder work equivalently.  This means making an EntityRef class
  instead of Entity.  It should probably have a name, public ID, and system
  ID per
  http://lists.denveronline.net/lists/jdom-interest/2000-September/002838.html.
  May also want to read:
  http://lists.denveronline.net/lists/jdom-interest/2000-September/002844.html.
  Also see:
  http://lists.denveronline.net/lists/jdom-interest/2000-October/003540.html
  We may need to keep track of entity declarations coming in so that we can
  map the name in startEntity(String) to the public ID and system ID.
  Give Entity a decent clone() method too.  And have its equals() be based on
  == because it's a node in the tree.

-jh-

===================================================================
File: TODO.txt         	Status: Up-to-date

   Working revision:	1.68	Wed May  9 07:17:14 2001
   Repository revision:	1.68	/home/cvspublic/jdom/TODO.txt,v

   Existing Tags:
	start                    	(revision: 1.1.1.1)
	jdom                     	(branch: 1.1.1)