From 71f3c70c39bf6e914bacb7d7901fb4f7a98e2d13 Mon Sep 17 00:00:00 2001
From: David Robillard <d@drobilla.net>
Date: Fri, 17 Feb 2012 03:06:04 +0000
Subject: Add atom:URI.

---
 lv2/lv2plug.in/ns/ext/atom/atom.ttl | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

(limited to 'lv2/lv2plug.in/ns/ext/atom/atom.ttl')

diff --git a/lv2/lv2plug.in/ns/ext/atom/atom.ttl b/lv2/lv2plug.in/ns/ext/atom/atom.ttl
index 9a396bf..b19425f 100644
--- a/lv2/lv2plug.in/ns/ext/atom/atom.ttl
+++ b/lv2/lv2plug.in/ns/ext/atom/atom.ttl
@@ -218,6 +218,24 @@ void set_to_turtle_string(LV2_Atom_Literal* lit, const char* ttl) {
 </pre>
 """ .
 
+atom:URI
+	a rdfs:Class ;
+	rdfs:subClassOf atom:String ;
+	rdfs:label "URI string" ;
+	lv2:documentation """
+<p>A URI string.  This is identical in format to atom:String, except the string
+is a URI.  This is occasionally useful when a URI is needed but mapping it is
+inappropriate.  URIs should never be expressed as atom:String, because this
+makes it impossible to distinguish URIs from arbitrary strings, which makes
+functionality like mapping or rewriting URIs impossible.  Similarly, there is
+deliberately no atom type for filesystem paths.  To refer to a filename, use a
+complete file URI, with hostname if at all possible.  This allows hosts to
+properly handle paths in situations like serialisation or network
+transmission.</p>
+
+<p>Pedantically, this is an <q>IRI</q>, since UTF-8 characters are allowed.</p>
+""" .
+
 atom:URID
 	a rdfs:Class ;
 	rdfs:subClassOf atom:Atom ;
@@ -392,7 +410,6 @@ atom:ValuePort
 	rdfs:subClassOf atom:AtomPort ;
 	rdfs:label "Value Port" ;
 	lv2:documentation """
-
 <p>An AtomPort that contains a persistent <em>value</em>.  A <q>value</q> is
 time-independent and may be used numerous times.  A ValuePort is <q>pure</q> in
 the sense that it may affect output but MUST NOT affect persistent plugin state
-- 
cgit v1.2.1