# $Id: todo.txt,v 1.22 2002/09/27 13:21:59 mdean Exp $

(1/2) find out if someone else has already done this

alternate implementations

  (X) Java and JAXP

  (1/3) XSLT -- easy to field

  perl?

XSLT implementation

  figure out why xmlns attributes aren't appearing

    (probably not relevant) xsl:exclude-result-prefixes?

    7.6.2  Attribute Value Templates?

  hyperlink namespaces

  preserve original spacing

  use <element/> when no subelements are present

  handle ID or anything ending with #ID, etc.

Java implementation

  (X) figure out why xmlns attributes aren't appearing

    use startPrefixMapping? (ugh)

  (X) use <element/> when no children are present

  (X) try to capture comments

    org.xml.sax.ext.LexicalHandler

  record CVS Revision number in <address>?

  alternative approach:  the DAML Validator will ultimately require an
  RDF parser that can map back to file positions -- we could use this
  to mark up the original document

    org.xml.sax.Locator doesn't guarantee such accuracy

  "Malformed UTF-8 char" when parsing
  http://www.w3.org/2000/01/rdf-schema#Class -- apparently due to
  xml:lang="fr" labels

  (X) report syntax errors more explicitly

  investigate alternative SAX2 implementations

  verify linking of attributes with abbreviated syntax

    special treatment of rdf:type attribute

  implement as servlet

    package/deliver as .war file

all implementations

  (1/2 - not XSLT) allow relocation to a shadow hierarchy
  (e.g. http://www.daml.org/x/y/z becomes shadow/www.daml.org/x/y/z)
  to reference remote ontologies locally and avoid any problems with
  access and content negotiation

  (1/2 - not XSLT) hyperlink elements to their corresponding classes
  and properties (requires namespace resolution)

  make hyperlinking of </end> tags optional (to reduce clutter)?

  (1/2 - not XSLT) provide link to source DAML

  (optionally) embed DAML content in generated page?

  italicize comments?

issues

  (X) what if DAML is already embedded in HTML?

  hyperlinks autmatically work if we place the hyperdaml .html page
  next to the source .daml page and use content negotiation, but will
  everyone (browsers, reasoners, etc.) get the right version?

index.xml home page

  (X) create

  examples

    (X) daml+oil.daml

CGI

  (X) use Referer HTTP request header to implement "DAML Inside" viewing
  of embedded DAML

    if QUERY_STRING, use it
    else
      if Referer, use it
    else
      return form with link to daml.org
      or
      redirect to daml.org

hyperN3?