[
https://issues.apache.org/jira/browse/XERCESJ-70?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Elliotte Rusty Harold updated XERCESJ-70:
-----------------------------------------
Description:
(This is actually for beta3.)
The javadoc for eg
org.apache.xerces.xni.XMLDocumentHandler.startEntity documents the
baseSystemId parameter as the "base system identifier". Now I know
what a system identitifer is and I know what a base URI is, but I have
never heard of a "base system identifier". At the least the javadoc
should explain that the "baseSystemId" is the base URI applicable to
the system identifier, i.e. the base URI of the entity containing the
declaration of the entity being started. I think the parameter should
be renamed, perhaps to "systemIdBaseURI". There's a similar problem
with XMLLocator and XMLInputSource.
was:
(This is actually for beta3.)
The javadoc for eg
org.apache.xerces.xni.XMLDocumentHandler.startEntity documents the
baseSystemId parameter as the "base system identifier". Now I know
what a system identitifer and I know what a base URI is, but I have
never heard of a "base system identifier". At the least the javadoc
should explain that the "baseSystemId" is the base URI applicable to
the system identifier, i.e. the base URI of the entity containing the
declaration of the entity being started. I think the parameter should
be renamed, perhaps to "systemIdBaseURI". There's a similar problem
with XMLLocator and XMLInputSource.
> What's a base system identifier?
> --------------------------------
>
> Key: XERCESJ-70
> URL: https://issues.apache.org/jira/browse/XERCESJ-70
> Project: Xerces2-J
> Issue Type: Bug
> Components: XNI
> Affects Versions: 2.0.0 [beta 2]
> Environment: Operating System: Windows NT/2K
> Platform: PC
> Reporter: James Clark
> Assignee: Elliotte Rusty Harold
> Priority: Major
> Attachments: ASF.LICENSE.NOT.GRANTED--javadocPatch.diff
>
>
> (This is actually for beta3.)
> The javadoc for eg
> org.apache.xerces.xni.XMLDocumentHandler.startEntity documents the
> baseSystemId parameter as the "base system identifier". Now I know
> what a system identitifer is and I know what a base URI is, but I have
> never heard of a "base system identifier". At the least the javadoc
> should explain that the "baseSystemId" is the base URI applicable to
> the system identifier, i.e. the base URI of the entity containing the
> declaration of the entity being started. I think the parameter should
> be renamed, perhaps to "systemIdBaseURI". There's a similar problem
> with XMLLocator and XMLInputSource.
--
This message was sent by Atlassian Jira
(v10.3.26#10030026)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
