Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project! See Demo

Close

#6 JavaDoc inconsistency in EntityResolver

closed-fixed
javadoc (14)
5
2001-07-14
2001-07-13
David Megginson
No

Submitted by Thomas Masing 2001-06-27:

in the class description I have found the following:

"The XML reader will then allow the application to
intercept any external entities
(including the external DTD subset and external
parameter entities, if any) before including them."

This is in contrast to the method description of
resolveEntity():

"The Parser will call this method before opening any
external entity except the top-level document entity
(including the external DTD subset, external entities
referenced within the DTD, and external entities
referenced within the document element): "

In my opinion the first one should be the right one to
allow storing grammars in the database also.

Discussion

  • David Brownell
    David Brownell
    2001-07-14

    Logged In: YES
    user_id=44117

    I think there's no conflict there, but the
    description in EntityResolver could stand
    to be clarified slightly. The parenthesized
    phrase explains what "any ... except" means.
    CVS version now gets rid of the parenthesis,
    it should be clearer.

     
  • David Brownell
    David Brownell
    2001-07-14

    • assigned_to: nobody --> dbrownell
    • status: open --> closed-fixed