001/*
002 * Copyright (c) 2004 World Wide Web Consortium,
003 *
004 * (Massachusetts Institute of Technology, European Research Consortium for
005 * Informatics and Mathematics, Keio University). All Rights Reserved. This
006 * work is distributed under the W3C(r) Software License [1] in the hope that
007 * it will be useful, but WITHOUT ANY WARRANTY; without even the implied
008 * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
009 *
010 * [1] http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231
011 */
012
013package org.w3c.dom;
014
015/**
016 * This interface represents a notation declared in the DTD. A notation either 
017 * declares, by name, the format of an unparsed entity (see <a href='http://www.w3.org/TR/2004/REC-xml-20040204#Notations'>section 4.7</a> of the XML 1.0 specification [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]), or is 
018 * used for formal declaration of processing instruction targets (see <a href='http://www.w3.org/TR/2004/REC-xml-20040204#sec-pi'>section 2.6</a> of the XML 1.0 specification [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]). The 
019 * <code>nodeName</code> attribute inherited from <code>Node</code> is set 
020 * to the declared name of the notation.
021 * <p>The DOM Core does not support editing <code>Notation</code> nodes; they 
022 * are therefore readonly.
023 * <p>A <code>Notation</code> node does not have any parent.
024 * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
025 */
026public interface Notation extends Node {
027    /**
028     * The public identifier of this notation. If the public identifier was 
029     * not specified, this is <code>null</code>.
030     */
031    public String getPublicId();
032
033    /**
034     * The system identifier of this notation. If the system identifier was 
035     * not specified, this is <code>null</code>. This may be an absolute URI 
036     * or not.
037     */
038    public String getSystemId();
039
040}