edoc structure

Roger Price <>
Fri Apr 5 00:04:37 CEST 2002


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





More information about the erlang-questions mailing list