path: root/lv2/lv2plug.in/ns/ext/atom/atom.ttl
diff options
Diffstat (limited to 'lv2/lv2plug.in/ns/ext/atom/atom.ttl')
1 files changed, 18 insertions, 1 deletions
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) {
""" .
+ 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
+<p>Pedantically, this is an <q>IRI</q>, since UTF-8 characters are allowed.</p>
+""" .
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