Comments on Cougar DTD

Marcus E. Hennecke (marcush@crc.ricoh.com)
Tue, 16 Jul 1996 14:28:33 -0700 (PDT)


Date: Tue, 16 Jul 1996 14:28:33 -0700 (PDT)
From: "Marcus E. Hennecke" <marcush@crc.ricoh.com>
Message-Id: <199607162128.OAA02376@cougar.crc.ricoh.com>
To: www-html@w3.org
Subject: Comments on Cougar DTD

----------
X-Sun-Data-Type: text
X-Sun-Data-Description: text
X-Sun-Data-Name: text
X-Sun-Charset: us-ascii
X-Sun-Content-Lines: 39

Here are some of my comments on the recently posted Cougar DTD. It's
mainly a minor typo and a request for additional attributes for lists
and block elements taken from the expired HTML 3.0 draft.

1. This is really a minor point, but the date is not correct: It should
   be *Friday*, not Wednesday, July 12.

2. SRC attribute for lists. Ok, this has generated long discussions on
   this list before. Back then it was about getting it into Wilbur.
   However, Wilbur was only supposed to document *current* practice.
   So now in Cougar, we should get the SRC attribute in.

3. TYPE=PLAIN for UL. If we had

	<!ENTITY % ULStyle "plain|disc|square|circle">

   we could write <UL PLAIN>, common practice among certain browsers for
   some time now.

4. CONTINUE attribute for OL. To allow for lists that are interrupted
   by other block elements.

5. CLEAR attributes. Cougar still allows the CLEAR attribute only on
   the BR element. It should be added to all block elements.

6. Any reason why certain elements don't have %attrs; in the ATTLIST?
   Examples: ADDRESS (can't do <address class=signature>?), DIR, MENU,
   IMG (can't specify image size via style sheets?)

I am enclosing a snippet of DTD taken from the Cougar DTD and modified
to allow SRC, CLEAR, and CONTINUE attributes on lists. Also included are
HEIGHT and WIDTH attributes for list bullets.

Any comments are appreciated.

Marcus
--
Marcus E. Hennecke
marcush@crc.ricoh.com        http://www.crc.ricoh.com/~marcush/
----------
X-Sun-Data-Type: default
X-Sun-Data-Description: default
X-Sun-Data-Name: list.dtd
X-Sun-Charset: us-ascii
X-Sun-Content-Lines: 126

<!--=================== Generic Attributes ================================-->

<!ENTITY % style
        "id     ID      #IMPLIED    -- document wide unique id --
         class  CDATA   #IMPLIED    -- comma list of class values --
         style  CDATA   #IMPLIED    -- associated style info --"
         >

<!ENTITY % i18n
        "lang   NAME    #IMPLIED    -- RFC 1766 language value --
         dir  (ltr|rtl) #IMPLIED    -- default directionality --"
         >

<!ENTITY % attrs "%style %i18n">
<!-- MEH: definition for CLEAR attribute (from HTML 3.0 draft) -->
<!ENTITY % needs -- Attributes for controlling text flow. Used in headers
                    and other elements to guarantee sufficient room --
        'clear  CDATA #IMPLIED'>

<!--=================== Lists =============================================-->

<!--
    HTML 3.2 allows you to control the sequence number for ordered lists.
    You can set the sequence number with the START and VALUE attributes.
    The TYPE attribute may be used to specify the rendering of ordered
    and unordered lists.
-->

<!ENTITY % Length "CDATA" -- nn for pixels or nn% for percentage length -->
<!ENTITY % Pixels "CDATA" -- integer representing length in pixels -->

<!-- definition lists - DT for term, DD for its definition -->

<!-- MEH: added CLEAR attribute -->
<!ELEMENT DL    - -  (DT|DD)*>
<!ATTLIST DL
        %attrs;     -- id, class, style, lang, dir --
        %needs;     -- control of text flow --
        compact (compact) #IMPLIED -- more compact style --
        >

<!-- MEH: added CLEAR attribute -->
<!ELEMENT DT - O  (%text)*>
<!ELEMENT DD - O  %flow;>
<!ATTLIST (DT|DD) %attrs;
        %needs;     -- control of text flow -->

<!-- Ordered lists OL, and unordered lists UL -->
<!ELEMENT (OL|UL) - -  (LI)*>

<!--
       Numbering style
    1   arablic numbers     1, 2, 3, ...
    a   lower alpha         a, b, c, ...
    A   upper alpha         A, B, C, ...
    i   lower roman         i, ii, iii, ...
    I   upper roman         I, II, III, ...

    The style is applied to the sequence number which by default
    is reset to 1 for the first list item in an ordered list.

    This can't be expressed directly in SGML due to case folding.
-->

<!ENTITY % OLStyle "CDATA" -- constrained to: [1|a|A|i|I] -->

<!-- MEH: added CLEAR and CONTINUE attributes -->
<!ATTLIST OL -- ordered lists --
        %attrs;     -- id, class, style, lang, dir --
        %needs;     -- control of text flow --
        type      %OLStyle   #IMPLIED   -- numbering style --
        start     NUMBER     #IMPLIED   -- starting sequence number --
        continue (continue)  #IMPLIED   -- don't restart sequence number --
        compact  (compact)   #IMPLIED   -- reduced interitem spacing --
        >

<!-- bullet styles -->
<!-- MEH: type plain allows lists without bullets. Defining it this -->
<!-- way allows use of <UL PLAIN>. -->
<!ENTITY % ULStyle "plain|disc|square|circle">

<!-- MEH: added SRC and CLEAR attributes -->
<!ATTLIST UL -- unordered lists --
        %attrs;     -- id, class, style, lang, dir --
        %needs;     -- control of text flow --
        type    (%ULStyle)   #IMPLIED   -- bullet style --
        compact (compact)    #IMPLIED   -- reduced interitem spacing --
        src     %URL         #IMPLIED   -- URL of image to embed --
        height  %Pixels      #IMPLIED   -- suggested height in pixels --
        width   %Pixels      #IMPLIED   -- suggested width in pixels --
        >

<!-- MEH: added CLEAR attribute -->
<!ELEMENT (DIR|MENU) - -  (LI)* -(%block)>
<!ATTLIST DIR
        %needs;     -- control of text flow --
        compact (compact) #IMPLIED
        >
<!ATTLIST MENU
        %needs;     -- control of text flow --
        compact (compact) #IMPLIED
        >

<!-- <DIR>              Directory list                  -->
<!-- <DIR COMPACT>      Compact list style              -->
<!-- <MENU>             Menu list                       -->
<!-- <MENU COMPACT>     Compact list style              -->

<!-- The type attribute can be used to change the bullet style
     in unordered lists and the numbering style in ordered lists -->

<!ENTITY % LIStyle "CDATA" -- constrained to: "(%ULStyle|%OLStyle)" -->

<!-- MEH: added SRC and CLEAR attributes -->
<!ELEMENT LI - O %flow -- list item -->
<!ATTLIST LI
        %attrs;     -- id, class, style, lang, dir --
        %needs;     -- control of text flow --
        type    %LIStyle     #IMPLIED   -- list item style --
        value    NUMBER      #IMPLIED   -- reset sequence number --
        src     %URL         #IMPLIED   -- URL of image to be used as bullet --
        height  %Pixels      #IMPLIED   -- suggested height in pixels --
        width   %Pixels      #IMPLIED   -- suggested width in pixels --
        -- height and width only used for image --
        >