/*
 * Copyright (c) 2002 World Wide Web Consortium,
 * (Massachusetts Institute of Technology, Institut National de
 * Recherche en Informatique et en Automatique, Keio University). All
 * Rights Reserved. This program is distributed under the W3C's Software
 * Intellectual Property License. This program is distributed in the
 * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
 * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
 * PURPOSE.
 * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
 */

package org.w3c.dom;

/**
 * DOM Level 3 WD Experimental:
 * The DOM Level 3 specification is at the stage 
 * of Working Draft, which represents work in 
 * progress and thus may be updated, replaced, 
 * or obsoleted by other documents at any time. 
 * <p>
 * <code>DOMError</code> is an interface that describes an error.
 * <p>See also the <a href='http://www.w3.org/TR/2002/WD-DOM-Level-3-Core-20020409'>Document Object Model (DOM) Level 3 Core Specification</a>.
 */
public interface DOMError {
    /**
     * The severity of the error described by the <code>DOMError</code> is 
     * warning
     */
    public static final short SEVERITY_WARNING          = 0;
    /**
     * The severity of the error described by the <code>DOMError</code> is 
     * error
     */
    public static final short SEVERITY_ERROR            = 1;
    /**
     * The severity of the error described by the <code>DOMError</code> is 
     * fatal error
     */
    public static final short SEVERITY_FATAL_ERROR      = 2;
    /**
     * The severity of the error, either <code>SEVERITY_WARNING</code>, 
     * <code>SEVERITY_ERROR</code>, or <code>SEVERITY_FATAL_ERROR</code>.
     */
    public short getSeverity();

    /**
     * An implementation specific string describing the error that occured.
     */
    public String getMessage();

    /**
     * The related platform dependent exception if any.exception is a reserved 
     * word, we need to rename it.Change to "relatedException". (F2F 26 Sep 
     * 2001)
     */
    public Object getRelatedException();

    /**
     * The location of the error.
     */
    public DOMLocator getLocation();

}

@@ -2104,24 +2104,965 @@
 xception();%0A
+    %0A    /**%0A     *  A %3Ccode%3EDOMString%3C/code%3E indicating which related data is expected in %0A     * %3Ccode%3ErelatedData%3C/code%3E. Users should refer to the specification of %0A     * the error in order to find its %3Ccode%3EDOMString%3C/code%3E type and %0A     * %3Ccode%3ErelatedData%3C/code%3E definitions if any.  As an example, %5B%3Ca href='http://www.w3.org/TR/DOM-Level-3-LS'%3EDOM Level 3 Load and Save%3C/a%3E%5D does %0A     * not keep the %5BbaseURI%5D property defined on a Processing Instruction %0A     * information item. Therefore, the %3Ccode%3EDOMBuilder%3C/code%3E generates a %0A     * %3Ccode%3ESEVERITY_WARNING%3C/code%3E with %3Ccode%3Etype%3C/code%3E %0A     * %3Ccode%3E%22infoset-baseURI%22%3C/code%3E and the lost %5BbaseURI%5D property %0A     * represented as a %3Ccode%3EDOMString%3C/code%3E in the %0A     * %3Ccode%3ErelatedData%3C/code%3E attribute. %0A     */%0A%0A    public String getType();%0A    %0A    /**%0A     *  The related %3Ccode%3EError.type%3C/code%3E dependent data if any. %0A     */%0A%0A    public Object getRelatedData();%0A%0A
 %0A    /**%0A   

Modify DOMError interface to include "type" and "relatedData" fields