//==============================================================================
// XmlDirectiveI.java
//------------------------------------------------------------------------------

package tribble.xml;


// System imports

import java.io.IOException;
import java.io.Reader;

import java.lang.Exception;
import java.lang.String;


// Local imports

// (None)


/*******************************************************************************
* XML directive.
*
* <p>
* Contains the name of a tagged XML directive.
*
* <p>
* An XML directive may contain one or more attributes
* (see {@link XmlAttributeI}).
*
* <!------------------------------------------------------------------------ -->
* <p>
* <b> Example </b>
*
* <p>
* Consider the following XML document:
* <pre>
*    &lt;?xml version='1.0' standalone='yes'?&gt;
*    &lt;item&gt;
*    &lt;/item&gt; </pre>
*
* <p>
* It contains the following directive and attributes:
* <pre>
*    <i>directive</i>  "xml"
*      <i>attribute</i>  "version", "1.0"
*      <i>attribute</i>  "standalone", "yes" </pre>
*
* <!------------------------------------------------------------------------ -->
* @version	$Revision: 1.1 $ $Date: 2003/05/18 23:44:04 $
* @since	2003-05-18
* @author
*	David R. Tribble
*	(<a href="mailto:david@tribble.com">david@tribble.com</a>).
*	<br>
*	Copyright ©2003 by David R. Tribble, all rights reserved.
*	<br>
*	Permission is granted to freely use and distribute this source code
*	provided that the original copyright and authorship notices remain
*	intact.
*
* @see	XmlAttributeI
*/

public interface XmlDirectiveI
    extends XmlItemI
{
// Identification

    /** Revision information. */
    static final String		REV =
        "@(#)tribble/xml/XmlDirectiveI.java $Revision: 1.1 $ $Date: 2003/05/18 23:44:04 $\n";


// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
// Public constants

    // (None)


// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
// Public methods

    /***************************************************************************
    * Retrieve the name of this XML directive.
    *
    * @return
    * Name (tag) of this tagged directive.
    *
    * @since	1.1, 2003-05-18
    */

    public String getName();
        /*const*/
}

// End XmlDirectiveI.java