# LV2 Host Info Extension
# Copyright 2009-2012 David Robillard <d@drobilla.net>
#
# Permission to use, copy, modify, and/or distribute this software for any
# purpose with or without fee is hereby granted, provided that the above
# copyright notice and this permission notice appear in all copies.
#
# THIS SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
# 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 foaf: <http://xmlns.com/foaf/0.1/> .
@prefix hi:   <http://lv2plug.in/ns/ext/host-info#> .
@prefix lv2:  <http://lv2plug.in/ns/lv2core#> .
@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 xsd:  <http://www.w3.org/2001/XMLSchema#> .

<http://lv2plug.in/ns/ext/host-info>
	a lv2:Specification ;
	rdfs:seeAlso <../../meta/meta.ttl> ;
	doap:license <http://opensource.org/licenses/isc> ;
	doap:name "LV2 Host Info" ;
	doap:shortdesc "A format for describing LV2 hosts." ;
	doap:developer <http://drobilla.net/drobilla#me> ;
	lv2:documentation """
<p>This specification defines various properties to represent useful information
about LV2 hosts.  Currently, the primary use of this specification is to describe which
extensions are supported by a given host.</p>

<p>The extensions supported by a host can be described like this:</p>
<pre class="turtle-code">
@prefix hi: &lt;http://lv2plug.in/ns/ext/host-info#&gt; .

&lt;http://example.org/some-host&gt;
    a hi:Host ;
    doap:name "Foo Rack" ;
    hi:supportsExtension [
        hi:extension &lt;http://example.org/some-extension&gt; ;
        hi:sinceVersion "1.2.0"
    ] .
</pre>
""" .

hi:Host
	a rdfs:Class ;
	rdfs:label "LV2 Host" ;
	rdfs:subClassOf [
		a owl:Restriction ;
		owl:onProperty doap:name ;
		owl:someValuesFrom xsd:string ;
		owl:minCardinality 1 ;
		rdfs:comment "A hi:Host MUST have at least one string doap:name" ;
	] ;
	rdfs:comment """
An application that supports loading LV2 plugins, or performs other
LV2 related functionality.
""" .

hi:supportsExtension
	a rdf:Property ;
	rdfs:domain hi:Host ;
	rdfs:range hi:ExtensionSupport ;
	rdfs:label "supports extension" ;
	rdfs:comment "Relates a Host to its ExtensionSupport" .

hi:ExtensionSupport
	a rdfs:Class ;
	rdfs:label "Extension Support" ;
	rdfs:subClassOf [
		a owl:Restriction ;
		owl:onProperty hi:sinceVersion ;
		owl:someValuesFrom xsd:string ;
		owl:minCardinality 1 ;
		rdfs:comment """
A hi:ExtensionSupport MUST have at least one string hi:sinceVersion
""" ;
	] ;
	rdfs:comment "A description of the support for an extension by a Host" .

hi:extension
	a rdf:Property ;
	rdfs:domain hi:ExtensionSupport ;
	rdfs:range lv2:Specification ;
	rdfs:label "extension" ;
	rdfs:comment "Indicates the extension supported by a host." .

hi:sinceVersion
	a rdf:Property ;
	rdfs:domain hi:ExtensionSupport ;
	rdfs:range xsd:string ;
	rdfs:label "since version" ;
	rdfs:comment """
The initial version of a host which supported an extension.
This property MUST always be given
""" .

hi:untilVersion
	a rdf:Property ;
	rdfs:domain hi:ExtensionSupport ;
	rdfs:range xsd:string ;
	rdfs:label "until version" ;
	rdfs:comment """
The final version of a host which supported an extension.  This property can
be used if support for an extension was discontinued in a host for some reason.
""" .