___ ___ _ _ ___ ___ ___ ___ _ ___ _ _  ______  
_______________            _________ |_, |== |\| |== |-< |-|  |  | [_] |\| __/_/_______   
_____  ___/__(_)_____________  ____/____________ ___________________________ _______  /__
____  /_ ___  /__  ___/  _ \  /    _  __ \_  __ `__ \  __ \  __ \_  __ \  _ \_  __ \  __/
___  __/ __  / _  /   /  __/ /___  / /_/ /  / / / / / /_/ / /_/ /  / / /  __/  / / / /_  
  /_/     /_/  /_/    \___/\____/  \____//_/ /_/ /_/_/ __/\____//_/ /_/\___//_/ /_/\__/  

                  (c) Lada 'Ray' Lostak (c) Orcave (c) 1996-2004


XML digest (this is _NOT_ XML draft, see w3.org for this purpuse, this is just survey)


DTD & XML tags
--------------

    general tag
        <tagname attr="val" attr='val'>body</tagname>
        <tagname attr="val" attr='val'/>

    command 

        <?application .... ?>

        standard XML commands

        xml
            <?xml version="..." encoding="..." standalone="..." ?>
                version     XML version (now 1.0)
                encoding    text encoding (default UTF-8)
                standalone  can be parsed without referenced DTD's - yes/no

    comment

        <!-- .... -->

    declaration

        <! .... >

        <! ... [
            <! ... >
            <! ... >
         ]>

    char data section 

        <![CDATA[ .... ]]>

        Tags and entities references are ignored in CDATA body, text is readed as-is

    entity
        referenced by &name; / %name;
        internals: lg,gt,amp,apos,quot
        when substituting, added space before/after entity body

        <!ENTITY name "con'tent">
        <!ENTITY name 'content"'>
        <!ENTITY % name ...>                        parameter entity (DTD only)
        <!ENTITY name SYSTEM "url">                 external
        <!ENTITY name PUBLIC "public identifier">   public
        <!ENTITY name PUBLIC "pub id" "url">        public + system URL (SYSTEM musn't be used)
        <!ENTITY name SYSTEM "url" NDATA fname>     binary entity

        direct code
            &#DEC;
            &#xHEX;
            
    dtd
        element
        attlist
        entity
        notation
        doctype declaration

    doctype declaration
        <!DOCTYPE name ... [ body ]>
            ... 
            SYSTEM "url"                    required DTD
            PUBLIC "pub id" "system"            -//-

            body is 'internal dtd'

    element
        <!ELEMENT name ...>
            ...
            EMPTY               empty element
            ANY                 any other child element
            (#PCDATA)           parseable char data (text element)
            (#PCDATA | ...)*    mixed - PCDATA need to be 1st, ending * is required
            (names expression)  child elements expression ( ) + * | ,

    element attribs
        <!ATTLIST elementname attr_name .. attr_name .. ....>
            ..
            CDATA                           char data
            NMTOKEN                         token (123abc, xyz, ...)
            NMTOKENS                        token token token
            ENTITY                          entity reference
            ENTITIES
            ID
            IDREF
            IDREFS
            NOTATION format                 sets element data format (reading ends with '</')
            NOTATION (format | format)
            (value_list)
            (value_list) "default"          list of allowed valued - divided by | connector

            #REQUIRED                       have to be filled
            #IMPLIED                        if value not used, application should use 'default'
            #FIXED "value"                  only fixed value allowed, attrib filled even not used @ element

    including
        <![INCLUDE [ ... ]]>
        <![IGNORE [ ... ]]>

    notation
        <!NOTATION name ...>
            ...
            SYSTEM "url"
            PUBLIC "pub id" "system"