[
https://issues.apache.org/jira/browse/JENA-453?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13661610#comment-13661610
]
Andy Seaborne commented on JENA-453:
------------------------------------
1 => correction applied to staging :
http://jena.staging.apache.org/tutorials/rdf_api.html
2 => The point is that XML namespace declarations are needed.
The first example does say "no special prefixes defined" and the second "nsA
defined"
Is this clearer?
"""
XML namespace declarations are also
needed for using the two properties P and Q, but since their
prefixes have not been introduced to the model in this example,
"""
> Typo and wording error in "An Introduction to RDF and the Jena RDF API"
> -----------------------------------------------------------------------
>
> Key: JENA-453
> URL: https://issues.apache.org/jira/browse/JENA-453
> Project: Apache Jena
> Issue Type: Documentation
> Components: Web site
> Reporter: Kirby Banman
> Priority: Trivial
> Labels: documentation
>
> I suspect the following error in the documentation at
> http://jena.apache.org/tutorials/rdf_api.html
> Nearly 1/2 way down the page:
> > We see that the rdf namespace is declared automatically, since it is
> > required for tags such as <RDF:rdf> and <rdf:resource>. Namespace
> > declarations are also needed for using the two properties P and Q, but
> > since their namespaces have not been introduced to the model, they get
> > invented namespace names: j.0 and j.1.
> 1. The XML tag <RDF:rdf> should have the cases swapped to <rdf:RDF>.
> 2. The concepts of namespaces and prefixes could be more clearly
> differentiated.
> For example:
> > We see that the rdf namespace prefix is declared automatically, since it
> > is required for tags such as <rdf:RDF> and <rdf:resource>. Namespace
> > prefix declarations are also needed for using the two properties P and Q,
> > but since their namespace prefixes have not been introduced to the model,
> > they get invented ones: j.0 and j.1.
> Change number 2 isn't my area of expertise, but I think the concept of
> namespace is inherent in the URIs in the example. So, to say that "Namespace
> declarations are also needed..." is ambiguous, since Jena implicitly knows
> about the namespace "http://somewhere/else#"; by virtue of the URIs of
> properties P and Q. Hence the change to "Namespace prefix declarations are
> also needed..." since explicit declarations are required for Jena to know
> about the prefix "nsA" and its correspondence to the aforementioned
> namespace.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira
