<!-- ===================================================================

     Apache How-To DTD (Version 1.0)

PURPOSE:
  This DTD was developed to create a simple yet powerful document
  type for software How-Tos for use with the Apache projects.
  It is an XML-compliant DTD and is maintained by the Apache XML project.

TYPICAL INVOCATION:

  <!DOCTYPE document PUBLIC
       "-//APACHE//DTD How-To Vx.y//EN"
       "howto-vxy.dtd">

  where

    x := major version
    y := minor version

NOTES:
  How-Tos help software users accomplish a specific task with clear
  and consise instructions.

AUTHORS:
  Diana Shannon <shannon@apache.org>

FIXME:

CHANGE HISTORY:
  20020515 Initial version. (DS)
  20020521 Added feedback element. (DS)
  20020613 Include the module of ISO character entity sets (DC)

COPYRIGHT:
  Copyright (c) 2002 The Apache Software Foundation.

  Permission to copy in any form is granted provided this notice is
  included in all copies. Permission to redistribute is granted
  provided this file is distributed untouched in all its parts and
  included files.

==================================================================== -->

<!-- =============================================================== -->
<!-- Local entities -->
<!-- =============================================================== -->

<!ENTITY % local.headers ", last-modified-content-date">

<!-- =============================================================== -->
<!-- Include other DTD modules and entity sets -->
<!-- =============================================================== -->

<!ENTITY % document PUBLIC
    "-//APACHE//ENTITIES Documentation V1.1//EN"
    "document-v11.mod">
%document;

<!ENTITY % faq PUBLIC
    "-//APACHE//ENTITIES FAQ V1.1//EN"
    "faq-v11.mod">
%faq;

<!ENTITY % common-charents PUBLIC
    "-//APACHE//ENTITIES Common Character Entity Sets V1.0//EN"
    "common-charents-v10.mod">
%common-charents;

<!-- =============================================================== -->
<!-- Document Type Definition -->
<!-- =============================================================== -->

<!ELEMENT howto (header, audience?, purpose?, prerequisites?, steps,
    extension?, faqs?, tips?, references?, feedback? )>
<!ATTLIST howto %common.att;>


    <!ELEMENT overview (%blocks;)* >
    <!ATTLIST overview %title.att; %common.att;>

    <!ELEMENT purpose (%blocks;)* >
    <!ATTLIST purpose %title.att; %common.att;>

    <!ELEMENT prerequisites (section | %blocks;)* >
    <!ATTLIST prerequisites %title.att; %common.att;>

    <!ELEMENT audience (%blocks;)* >
    <!ATTLIST audience %title.att; %common.att;>

    <!ELEMENT steps (section | %blocks;)* >
    <!ATTLIST steps %title.att; %common.att;>

    <!ELEMENT extension (%blocks;)* >
    <!ATTLIST extension %title.att; %common.att;>

    <!ELEMENT tips (section | %blocks;)* >
    <!ATTLIST tips %title.att; %common.att;>

    <!ELEMENT references (section | %blocks;)* >
    <!ATTLIST references %title.att; %common.att;>

    <!ELEMENT feedback (%blocks;)* >
    <!ATTLIST feedback %title.att; %common.att;>

    <!ELEMENT last-modified-content-date EMPTY >
    <!ATTLIST last-modified-content-date date CDATA #REQUIRED>

<!-- =============================================================== -->
<!-- End of DTD -->
<!-- =============================================================== -->
