[sc34wg3] TMQL: Navigation "indicators" / "locators" examples

[Lars Heuer]

Comments against TMQL draft dtd. 2008-07-15.

4.4 Navigation
==============

locators
--------

    EXAMPLE:
    [...] the expression file:/maps/dictators.xtm = would identify the
    document itself [...]

That example is wrong since the quotes ``"`` around the IRI are
missing. A plain IRI refers to a topic by its subject identifier and
the given expression would cause an error.

Correct expression:

    "file://maps/dictators.xtm" =
    

indicators
----------

    2nd EXAMPLE:
    The expression "file:/maps/dictators.xtm" ~ indicates the subject
    which is that map itself. [...]

That example is suboptimal and fits better as an example for subject
*locators* since the file *is* the subject. I suggest that the second
example should be merged with the first one (which is correct) and the
difference between

    "http://en.wikipedia.org/wiki/Stalin" ~

and

    http://en.wikipedia.org/wiki/Stalin

should be explained there.


Note, I used the ""-notation here just to be conformant to the current
TMQL spec. But the ""-notation may cause trouble as well, explained in
my mail 'TMQL: Atoms "iri"' (Sun, 20 Jul 2008 14:58:45 +0200).

Best regards,
Lars
-- 
Semagia 
<http://www.semagia.com>