aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2011-11-05 03:45:53 +0000
committerDavid Robillard <d@drobilla.net>2011-11-05 03:45:53 +0000
commit4ee818b680e6864e03d98aa945be1600471db578 (patch)
tree6de8cea2f54e561b9f5ace6eac018d85ea7f54a7
parent434a3c065b0b9ac73692bc445b01e91123554e50 (diff)
downloadlv2-4ee818b680e6864e03d98aa945be1600471db578.tar.xz
Mark event and uri-map as deprecated and point to their successors in documentation.
-rw-r--r--doc/style.css4
-rw-r--r--ext/event.lv2/event.ttl18
-rw-r--r--ext/event.lv2/manifest.ttl2
-rw-r--r--ext/uri-map.lv2/uri-map.ttl43
-rw-r--r--ext/urid.lv2/urid.ttl18
-rwxr-xr-xlv2specgen/lv2specgen.py6
6 files changed, 56 insertions, 35 deletions
diff --git a/doc/style.css b/doc/style.css
index 230353c..1a28ca9 100644
--- a/doc/style.css
+++ b/doc/style.css
@@ -499,6 +499,10 @@ code {
h1, h2, h3, h4, h5, h6, th {
text-align: left;
}
+.warning {
+ color: red;
+ font-weight: bold;
+}
/* Pygments Style */
.hll { background-color: #ffffcc }
diff --git a/ext/event.lv2/event.ttl b/ext/event.lv2/event.ttl
index 064e3eb..d207a7a 100644
--- a/ext/event.lv2/event.ttl
+++ b/ext/event.lv2/event.ttl
@@ -13,23 +13,25 @@
# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+@prefix doap: <http://usefulinc.com/ns/doap#> .
@prefix ev: <http://lv2plug.in/ns/ext/event#> .
+@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix lv2: <http://lv2plug.in/ns/lv2core#> .
@prefix lv2ev: <http://lv2plug.in/ns/ext/event#> .
+@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
-@prefix doap: <http://usefulinc.com/ns/doap#> .
-@prefix foaf: <http://xmlns.com/foaf/0.1/> .
<http://lv2plug.in/ns/ext/event>
a lv2:Specification ;
+ owl:deprecated true ;
doap:license <http://opensource.org/licenses/isc-license> ;
doap:name "LV2 Event" ;
doap:shortdesc "A port-based real-time generic event interface." ;
rdfs:seeAlso <event-helpers.h> ;
doap:release [
- doap:revision "1.2" ;
- doap:created "2011-05-26"
+ doap:revision "1.3" ;
+ doap:created "2011-11-23"
] ;
doap:maintainer [
a foaf:Person ;
@@ -41,10 +43,14 @@
foaf:name "Lars Luthman" ;
] ;
lv2:documentation """
-This extension defines a generic time-stamped event port type, which can be
+<p><span class="warning">This extension is deprecated.</span> New
+implementations should use <a href="http://lv2plug.in/ns/ext/atom">LV2 Atom</a>
+instead.</p>
+
+<p>This extension defines a generic time-stamped event port type, which can be
used to create plugins that read and write real-time events, such as MIDI,
OSC, or any other type of event payload. The type(s) of event supported by
-a port is defined in the data file for a plugin, for example:
+a port is defined in the data file for a plugin, for example:</p>
<pre class="turtle-code">
&lt;http://example.org/some-plugin&gt;
lv2:port [
diff --git a/ext/event.lv2/manifest.ttl b/ext/event.lv2/manifest.ttl
index bea8a13..2b1ff43 100644
--- a/ext/event.lv2/manifest.ttl
+++ b/ext/event.lv2/manifest.ttl
@@ -4,6 +4,6 @@
<http://lv2plug.in/ns/ext/event>
a lv2:Specification ;
lv2:minorVersion 1 ;
- lv2:microVersion 2 ;
+ lv2:microVersion 3 ;
rdfs:seeAlso <event.ttl> .
diff --git a/ext/uri-map.lv2/uri-map.ttl b/ext/uri-map.lv2/uri-map.ttl
index d7ec97b..b0a5399 100644
--- a/ext/uri-map.lv2/uri-map.ttl
+++ b/ext/uri-map.lv2/uri-map.ttl
@@ -13,23 +13,26 @@
# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-@prefix umap: <http://lv2plug.in/ns/ext/uri-map#> .
+@prefix doap: <http://usefulinc.com/ns/doap#> .
+@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix lv2: <http://lv2plug.in/ns/lv2core#> .
@prefix lv2ev: <http://lv2plug.in/ns/ext/event#> .
+@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
-@prefix doap: <http://usefulinc.com/ns/doap#> .
-@prefix foaf: <http://xmlns.com/foaf/0.1/> .
+@prefix umap: <http://lv2plug.in/ns/ext/uri-map#> .
<http://lv2plug.in/ns/ext/uri-map>
- a lv2:Specification , lv2:Feature ;
+ a lv2:Specification ,
+ lv2:Feature ;
+ owl:deprecated true ;
doap:license <http://opensource.org/licenses/isc-license> ;
doap:name "LV2 URI Map" ;
- doap:shortdesc "A feature for mapping URIs to integers." ;
- doap:release [
- doap:revision "1.2" ;
- doap:created "2011-05-26"
- ] ;
+ doap:shortdesc "A feature for mapping URIs to integers." ;
+ doap:release [
+ doap:revision "1.2" ;
+ doap:created "2011-05-26"
+ ] ;
doap:maintainer [
a foaf:Person ;
foaf:name "David Robillard" ;
@@ -37,14 +40,18 @@
rdfs:seeAlso <http://drobilla.net/drobilla.xrdf>
] , [
a foaf:Person ;
- foaf:name "Lars Luthman" ;
+ foaf:name "Lars Luthman"
] ;
- rdfs:comment """
-This extension defines a simple mechanism for plugins to map URIs to integers,
-usually for performance reasons (e.g. processing events typed by URIs in
-real time). The expected use case is for plugins to map URIs to integers for
-things they 'understand' at instantiation time, and store those values for
-use in the audio thread without doing any string comparison. This allows
-the extensibility of RDF with the performance of integers (or centrally
-defined enumerations).
+ lv2:documentation """
+<p><span class="warning">This extension is deprecated.</span> New
+implementations should use <a href="http://lv2plug.in/ns/ext/urid">LV2 URID</a>
+instead.</p>
+
+<p>This extension defines a simple mechanism for plugins to map URIs to
+integers, usually for performance reasons (e.g. processing events typed by URIs
+in real time). The expected use case is for plugins to map URIs to integers
+for things they 'understand' at instantiation time, and store those values for
+use in the audio thread without doing any string comparison. This allows the
+extensibility of RDF with the performance of integers (or centrally defined
+enumerations).</p>
""" .
diff --git a/ext/urid.lv2/urid.ttl b/ext/urid.lv2/urid.ttl
index 94b6863..d074724 100644
--- a/ext/urid.lv2/urid.ttl
+++ b/ext/urid.lv2/urid.ttl
@@ -25,16 +25,16 @@
doap:license <http://opensource.org/licenses/isc-license> ;
doap:name "LV2 URID" ;
doap:shortdesc "Features for mapping URIs to and from integers." ;
- doap:release [
- doap:revision "0.2" ;
- doap:created "2011-01-04"
- ] ;
+ doap:release [
+ doap:revision "0.2" ;
+ doap:created "2011-01-04"
+ ] ;
doap:developer [
a foaf:Person ;
foaf:name "Gabriel M. Beddingfield" ;
foaf:homepage <http://gabe.is-a-geek.org/>
] ;
- lv2:documentation """
+ lv2:documentation """
This extension defines a simple mechanism for plugins to map URIs to and from
integers, usually for performance reasons (e.g. processing events typed by URIs
in real time). Typically, plugins map URIs to integers for things they
@@ -48,8 +48,8 @@ This extension is intended as an improved and simpler replacement for the
""" .
urid:Mapper
- a lv2:Feature ;
- lv2:documentation """
+ a lv2:Feature ;
+ lv2:documentation """
A feature which is used to map URIs to integers. To support this feature, the
host must pass an LV2_Feature to LV2_Descriptor::instantiate() with
<em>URI</em> <q>http://lv2plug.in/ns/ext/urid#Mapper</q> and <em>data</em>
@@ -57,8 +57,8 @@ pointed to an instance of LV2_URID_Mapper.
""" .
urid:Unmapper
- a lv2:Feature ;
- lv2:documentation """
+ a lv2:Feature ;
+ lv2:documentation """
A feature which is used to unmap URIs previously mapped to integers by <a
href="#Mapper">Mapper</a>. To support this feature, the host must pass an
LV2_Feature to LV2_Descriptor::instantiate() with <em>URI</em>
diff --git a/lv2specgen/lv2specgen.py b/lv2specgen/lv2specgen.py
index 3293019..ce4ec22 100755
--- a/lv2specgen/lv2specgen.py
+++ b/lv2specgen/lv2specgen.py
@@ -973,7 +973,11 @@ def specgen(specloc, indir, docdir, style_uri, doc_base, doclinks, instances=Fal
version_string = "%s.%s (%s)" % (version[0], version[1], date_string)
if version[0] == 0 or version[1] % 2 == 1:
- version_string += ' <span style="color: red; font-weight: bold">EXPERIMENTAL</span>'
+ version_string += ' <span class="warning">EXPERIMENTAL</span>'
+
+ deprecated = findOne(m, rdflib.URIRef(spec_url), owl.deprecated, None)
+ if deprecated and str(deprecated[2]).find("true") > 0:
+ version_string += ' <span class="warning">DEPRECATED</span>'
template = template.replace('@REVISION@', version_string)