[erlang-bugs] [erlang-questions] Edoc error

Richard Carlsson <>
Sun Aug 17 10:30:34 CEST 2008


It has nothing to do with the edoc wiki expansion; it's just that
xmerl takes a legalistic approach to parsing (whereas browsers in
general are much more forgiving). The rhs of the attribute is CDATA,
which is subject to entity expansion, i.e., you can use enities like
" etc. anywhere in the quoted string. Spurious ampersands are
not actually allowed - even though they are used to separate fields
in a query URL - but browsers tend to leave them as single ampersands
if they don't seem to signal an entity (which is helpful if you just
want to paste an URL into an HTML page).

See http://www.w3.org/TR/html401/appendix/notes.html#h-B.2 (B.2.2)

    /Richard

Serge Aleynikov wrote:
> Thanks!  Apparently I missed the statement on escaping in 1.11.5 chapter 
> of edoc. :-(
> 
> Sorry for noise.
> 
> Dale Harvey wrote:
>> if its looking for valid xml, try using & ?
>>
>> 2008/8/16 Serge Aleynikov <>
>>
>>> There seems to be an error in edoc trying to parse URLs with query
>>> string arguments:
>>>
>>> ----------------
>>> $ cat overview.edoc
>>>
>>> Test Project
>>>
>>> @doc Test.
>>>
>>> <a href='/docs/?class=ColumnModel&member=configs'>ColumnModel
>>> configuration</a>
>>> ----------------
>>>
>>> Error being generated:
>>>
>>> 3748- fatal: expected_entity_reference_semicolon
>>> 2628- fatal: error_scanning_entity_ref
>>> overview.edoc: at line 8: error in XML parser: {fatal,
>>>                          {error_scanning_entity_ref,
>>>                              {file,file_name_unknown},
>>>                              {line,51},
>>>                              {col,88}}}.
>>> edoc: error in doclet 'edoc_doclet': {'EXIT',error}.
>>>
>>>
>>>
>>> Apparently it doesn't like the ampersand in the URL.  Changing the link
>>> to '/docs/?class=ColumnModel' works with no issues.
>>>
>>> Serge
>>> _______________________________________________
>>> erlang-questions mailing list
>>> 
>>> http://www.erlang.org/mailman/listinfo/erlang-questions
>>>
> 
> _______________________________________________
> erlang-bugs mailing list
> 
> http://www.erlang.org/mailman/listinfo/erlang-bugs




More information about the erlang-bugs mailing list