Make patch:Set a compact message for setting one property.

Add patch:readable and patch:writable for describing available properties.

4 files changed, 82 insertions, 23 deletions

diff --git a/lv2/lv2plug.in/ns/ext/patch/lv2-patch.doap.ttl b/lv2/lv2plug.in/ns/ext/patch/lv2-patch.doap.ttl
index a996b6c..ba976f5 100644
--- a/lv2/lv2plug.in/ns/ext/patch/lv2-patch.doap.ttl
+++ b/lv2/lv2plug.in/ns/ext/patch/lv2-patch.doap.ttl
@@ -12,6 +12,17 @@
 	doap:name "LV2 Patch" ;
 	doap:shortdesc "Messages for accessing and manipulating properties." ;
 	doap:release [
+		doap:revision "1.1" ;
+		doap:created "2012-01-10" ;
+		dcs:blame <http://drobilla.net/drobilla#me> ;
+		dcs:changeset [
+			dcs:item [
+				rdfs:label "Make patch:Set a compact message for setting one property."
+			] , [
+				rdfs:label "Add patch:readable and patch:writable for describing available properties."
+			]
+		]
+	] , [
 		doap:revision "1.0" ;
 		doap:created "2012-04-17" ;
 		doap:file-release <http://lv2plug.in/spec/lv2-1.0.0.tar.bz2> ;
diff --git a/lv2/lv2plug.in/ns/ext/patch/manifest.ttl b/lv2/lv2plug.in/ns/ext/patch/manifest.ttl
index 38b93ae..1037a9c 100644
--- a/lv2/lv2plug.in/ns/ext/patch/manifest.ttl
+++ b/lv2/lv2plug.in/ns/ext/patch/manifest.ttl
@@ -4,5 +4,5 @@
 <http://lv2plug.in/ns/ext/patch>
 	a lv2:Specification ;
 	lv2:minorVersion 1 ;
-	lv2:microVersion 0 ;
+	lv2:microVersion 1 ;
 	rdfs:seeAlso <patch.ttl> .
diff --git a/lv2/lv2plug.in/ns/ext/patch/patch.h b/lv2/lv2plug.in/ns/ext/patch/patch.h
index d03cdae..1a7a893 100644
--- a/lv2/lv2plug.in/ns/ext/patch/patch.h
+++ b/lv2/lv2plug.in/ns/ext/patch/patch.h
@@ -43,9 +43,13 @@
 #define LV2_PATCH__add         LV2_PATCH_PREFIX "add"
 #define LV2_PATCH__body        LV2_PATCH_PREFIX "body"
 #define LV2_PATCH__destination LV2_PATCH_PREFIX "destination"
+#define LV2_PATCH__property    LV2_PATCH_PREFIX "property"
+#define LV2_PATCH__readable    LV2_PATCH_PREFIX "readable"
 #define LV2_PATCH__remove      LV2_PATCH_PREFIX "remove"
 #define LV2_PATCH__request     LV2_PATCH_PREFIX "request"
 #define LV2_PATCH__subject     LV2_PATCH_PREFIX "subject"
+#define LV2_PATCH__value       LV2_PATCH_PREFIX "value"
 #define LV2_PATCH__wildcard    LV2_PATCH_PREFIX "wildcard"
+#define LV2_PATCH__writable    LV2_PATCH_PREFIX "writable"
 
 #endif  /* LV2_PATCH_H */
diff --git a/lv2/lv2plug.in/ns/ext/patch/patch.ttl b/lv2/lv2plug.in/ns/ext/patch/patch.ttl
index 6267c71..ae1a0e3 100644
--- a/lv2/lv2plug.in/ns/ext/patch/patch.ttl
+++ b/lv2/lv2plug.in/ns/ext/patch/patch.ttl
@@ -231,42 +231,37 @@ patch:Set
 	[
 		a owl:Restriction ;
 		owl:cardinality 1 ;
-		owl:onProperty patch:body
+		owl:onProperty patch:property
+	] , [
+		a owl:Restriction ;
+		owl:cardinality 1 ;
+		owl:onProperty patch:value
 	] ;
 	lv2:documentation """
-<p>A method for setting properties of an object to unique values.</p>
+<p>A compact message for setting one property to a specific value.</p>
 
-<p>This is a simplified version of patch:Patch which only makes sense for
-properties which have at most one value.  This method always has at least one
-patch:subject, and exactly one patch:add property.  All the properties of the
-value of patch:add are set on the subject, with all old values for those
-properties removed.  For example:</p>
+<p>This is equivalent to a patch:Patch which removes <em>all</em> pre-existing
+values for the property before setting the new value.  For example:</p>
 
 <pre class="turtle-code">
 []
     a patch:Set ;
     patch:subject &lt;something&gt; ;
-    patch:body [
-        eg:name "New name" ;
-        eg:age 42 ;
-    ] .
+    patch:property eg:name ;
+    patch:value "New name" .
 </pre>
 
-<p>This method is equivalent to a patch:Patch where the patch:remove value has
-every property of patch:add but with wildcard values.  For example, the above
-patch is equivalent to:</p>
+<p>Which is equivalent to:</p>
 <pre class="turtle-code">
 []
     a patch:Patch ;
     patch:subject &lt;something&gt; ;
     patch:add [
         eg:name "New name" ;
-        eg:age 42 ;
     ] ;
     patch:remove [
         eg:name patch:wildcard ;
-        eg:age patch:wildcard ;
-    ] ;
+    ] .
 </pre>
 """ .
 
@@ -294,6 +289,29 @@ patch:destination
 		owl:FunctionalProperty ;
 	rdfs:domain patch:Message .
 
+patch:property
+	a rdf:Property ;
+	rdfs:label "property" ;
+	rdfs:range rdf:Property ;
+	lv2:documentation """
+<p>The property this message applies to.</p>
+""" .
+
+patch:readable
+	a rdf:Property ;
+	rdfs:label "readable" ;
+	rdfs:range rdf:Property ;
+	lv2:documentation """
+<p>Indicates that the subject may have a property that can be read via a
+patch:Get message.  See the similar property patch:writable for details.</p>
+""" .
+
+patch:remove
+	a rdf:Property ,
+		owl:ObjectProperty ,
+		owl:FunctionalProperty ;
+	rdfs:domain patch:Message .
+
 patch:request
 	a rdf:Property ,
 		owl:ObjectProperty ,
@@ -310,14 +328,40 @@ patch:subject
 		owl:FunctionalProperty ;
 	rdfs:domain patch:Message .
 
-patch:remove
-	a rdf:Property ,
-		owl:ObjectProperty ,
-		owl:FunctionalProperty ;
-	rdfs:domain patch:Message .
+patch:value
+	a rdf:Property ;
+	rdfs:label "value" ;
+	rdfs:range rdf:Property ;
+	lv2:documentation """
+<p>The value of a property in a patch:Set message.</p>
+""" .
 
 patch:wildcard
 	a rdfs:Resource ;
 	rdfs:comment """
 A wildcard which matches any resource.  This makes it possible to describe the removal of all values for a given property.
 """ .
+
+patch:writable
+	a rdf:Property ;
+	rdfs:label "writable" ;
+	rdfs:range rdf:Property ;
+	lv2:documentation """
+<p>Indicates that subject may have a property that can be written via a patch
+message.  This is used to list supported properties, e.g. so user interfaces
+can present appropriate controls.  For example:</p>
+
+<pre class="turtle-code">
+@prefix eg:   &lt;http://example.org/&gt; .
+@prefix rdf:  &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#&gt; .
+@prefix rdfs: &lt;http://www.w3.org/2000/01/rdf-schema#&gt; .
+
+eg:title
+    a rdf:Property ;
+    rdfs:label "title" ;
+    rdfs:range xsd:string .
+
+eg:plugin
+    patch:writable eg:title .
+</pre>
+""" .