001    /*
002     * Copyright (c) 2000 World Wide Web Consortium,
003     * (Massachusetts Institute of Technology, Institut National de
004     * Recherche en Informatique et en Automatique, Keio University). All
005     * Rights Reserved. This program is distributed under the W3C's Software
006     * Intellectual Property License. This program is distributed in the
007     * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
008     * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
009     * PURPOSE. See W3C License http://www.w3.org/Consortium/Legal/ for more
010     * details.
011     */
012    
013    package org.w3c.dom.html;
014    
015    import org.w3c.dom.DOMImplementation;
016    
017    /**
018     *  The <code>HTMLDOMImplementation</code> interface extends the 
019     * <code>DOMImplementation</code> interface with a method for creating an 
020     * HTML document instance.
021     * <p>See also the <a href='http://www.w3.org/TR/2000/CR-DOM-Level-2-20000510'>Document Object Model (DOM) Level 2 Specification</a>.
022     * @since DOM Level 2
023     */
024    public interface HTMLDOMImplementation extends DOMImplementation {
025        /**
026         *  Creates an <code>HTMLDocument</code> object with the minimal tree made 
027         * of the following elements: <code>HTML</code> , <code>HEAD</code> , 
028         * <code>TITLE</code> , and <code>BODY</code> .
029         * @param title  The title of the document to be set as the content of the 
030         *   <code>TITLE</code> element, through a child <code>Text</code> node.
031         * @return  A new <code>HTMLDocument</code> object.
032         */
033        public HTMLDocument createHTMLDocument(String title);
034    
035    }
036