edoc structure

[Roger Price]

On Thu, 4 Apr 2002, Vlad Dumitrescu wrote:

> <!ELEMENT application (name, version, authors?, description?, since?,
> deprecated?, see?, modules, references?, copyright?)>

Perhaps version could be an attribute.  Attribute "lang" missing.
Add an attribute "date"?

> <!ELEMENT authors (author+)>

If authors? in application were replaced by author*, element authors could
be removed.

> <!ATTLIST function
>   exported NMTOKEN(yes | no) #REQUIRED

Should read  exported (yes | no) #REQUIRED.  Attribute for arity?

> <!ELEMENT since (#PCDATA)>       Shouldn't this be an attribute?
> <!ATTLIST author
>   name CDATA #IMPLIED
>   email CDATA #REQUIRED      #REQUIRED is very strong here!
>   website CDATA #IMPLIED
> >
> <!ELEMENT briefdescription (#PCDATA)>   Attribute?
> <!ELEMENT parameters (parameter+)>      See comment on authors.
> <!ELEMENT types (type+)>                See comment on authors.
> <!ELEMENT functions (function*)>        See comment on authors.
> <!ELEMENT valuetype (#PCDATA)>
> <!ELEMENT seelabel (#PCDATA)>
> <!ELEMENT usageexamples (usageexample+) See comment on authors.
> <!ELEMENT websites (website+)>          See comment on authors.
> <!ELEMENT listservs (listserv+)>        See comment on authors.
> <!ELEMENT newsgroups (newsgroup+)>      See comment on authors.
> <!ELEMENT books (book+)>                See comment on authors.
> <!ELEMENT valuetype (#PCDATA)>

Multiple definition!

...
> <!ELEMENT value (#PCDATA)>

Since there is no mixed content, perhaps (#PCDATA) could be replaced by
CDATA throughout the DTD.

After repair of attribute "exported" and removal of duplicate element
valuetype, the DTD validates with James Clark's SP.

Best Regards,
Roger