From 66d5e28a5704deb3fd15d2e4d2cb9f1b30f983ba Mon Sep 17 00:00:00 2001 From: David Robillard Date: Fri, 30 Nov 2007 22:00:00 +0000 Subject: Build/install man pages. git-svn-id: http://svn.drobilla.net/lad/slv2@928 a436a847-0d15-0410-975c-d299462d15a1 --- slv2/plugin.h | 6 +++--- slv2/pluginclass.h | 2 +- slv2/pluginclasses.h | 2 +- slv2/plugininstance.h | 28 +++++++++++++--------------- slv2/plugins.h | 2 +- slv2/pluginui.h | 2 +- slv2/pluginuiinstance.h | 13 +++++-------- slv2/pluginuis.h | 2 +- slv2/port.h | 2 +- slv2/util.h | 2 +- slv2/value.h | 2 +- slv2/values.h | 2 +- slv2/world.h | 2 +- 13 files changed, 31 insertions(+), 36 deletions(-) (limited to 'slv2') diff --git a/slv2/plugin.h b/slv2/plugin.h index c22fda5..b7a436e 100644 --- a/slv2/plugin.h +++ b/slv2/plugin.h @@ -29,10 +29,10 @@ extern "C" { #include #include -/** \defgroup data Plugin data access +/** \defgroup slv2_data Plugin data access * - * These functions work exclusively with the plugin's RDF data. - * They do not load or access the plugin dynamic library in any way. + * These functions work exclusively with the plugin's RDF data, + * they do not access the plugin's shared library in any way. * * An SLV2Plugin contains an in-memory cache of the plugin data, loaded * on demand. Duplicating plugins should be avoided when possible for diff --git a/slv2/pluginclass.h b/slv2/pluginclass.h index 3dacfd7..14449ab 100644 --- a/slv2/pluginclass.h +++ b/slv2/pluginclass.h @@ -25,7 +25,7 @@ extern "C" { #include -/** \addtogroup data +/** \addtogroup slv2_data * @{ */ diff --git a/slv2/pluginclasses.h b/slv2/pluginclasses.h index e95710b..b4cd08d 100644 --- a/slv2/pluginclasses.h +++ b/slv2/pluginclasses.h @@ -25,7 +25,7 @@ extern "C" { #endif -/** \addtogroup collections +/** \addtogroup slv2_collections * @{ */ diff --git a/slv2/plugininstance.h b/slv2/plugininstance.h index a78b644..c960e86 100644 --- a/slv2/plugininstance.h +++ b/slv2/plugininstance.h @@ -28,33 +28,31 @@ extern "C" { #include #include -/** \defgroup lib Plugin library access - * - * An SLV2Instance is an instantiated SLV2Plugin (ie a loaded dynamic - * library). These functions interact with the binary library code only, - * they do not read data files in any way. - * - * @{ - */ - - typedef struct _InstanceImpl* SLV2InstanceImpl; - -/** Instance of a plugin. +/* Instance of a plugin. * * The LV2 descriptor and handle of this are exposed to allow inlining of * performance critical functions like slv2_instance_run (which are exposed - * in lv2.h anyway). The remaining implementation details are - * in the opaque pimpl member. + * in lv2.h anyway). This is for performance only, this struct is not + * documented and should not be used directly. The remaining implementation + * details are in the opaque pimpl member. */ -typedef struct _Instance { +typedef struct { const LV2_Descriptor* lv2_descriptor; LV2_Handle lv2_handle; SLV2InstanceImpl pimpl; ///< Private implementation }* SLV2Instance; +/** \defgroup slv2_library Plugin library access + * + * An SLV2Instance is an instantiated SLV2Plugin (ie a loaded dynamic + * library). These functions interact with the binary library code only, + * they do not read data files in any way. + * + * @{ + */ /** Instantiate a plugin. * diff --git a/slv2/plugins.h b/slv2/plugins.h index 1ca4cc7..6b8eead 100644 --- a/slv2/plugins.h +++ b/slv2/plugins.h @@ -26,7 +26,7 @@ extern "C" { #endif -/** \addtogroup collections +/** \addtogroup slv2_collections * @{ */ diff --git a/slv2/pluginui.h b/slv2/pluginui.h index cd5fd3a..7de54aa 100644 --- a/slv2/pluginui.h +++ b/slv2/pluginui.h @@ -23,7 +23,7 @@ extern "C" { #endif -/** \addtogroup data +/** \addtogroup slv2_data * @{ */ diff --git a/slv2/pluginuiinstance.h b/slv2/pluginuiinstance.h index ba2ada6..2723585 100644 --- a/slv2/pluginuiinstance.h +++ b/slv2/pluginuiinstance.h @@ -28,16 +28,9 @@ extern "C" { #include #include -/** \addtogroup lib - * @{ - */ - - typedef struct _SLV2UIInstanceImpl* SLV2UIInstanceImpl; - - -/** Instance of a plugin UI. +/* Instance of a plugin UI. * * All details are in hidden in the pimpl member to avoid making the * implementation a part of the ABI. @@ -47,6 +40,10 @@ typedef struct _SLV2UIInstance { }* SLV2UIInstance; +/** \addtogroup slv2_library + * @{ + */ + /** Instantiate a plugin UI. * diff --git a/slv2/pluginuis.h b/slv2/pluginuis.h index f3eb699..b14e61a 100644 --- a/slv2/pluginuis.h +++ b/slv2/pluginuis.h @@ -26,7 +26,7 @@ extern "C" { #endif -/** \addtogroup collections +/** \addtogroup slv2_collections * * @{ */ diff --git a/slv2/port.h b/slv2/port.h index dc477cd..2cf0e30 100644 --- a/slv2/port.h +++ b/slv2/port.h @@ -28,7 +28,7 @@ extern "C" { #include #include -/** \addtogroup data +/** \addtogroup slv2_data * @{ */ diff --git a/slv2/util.h b/slv2/util.h index 1bd2847..0313f6e 100644 --- a/slv2/util.h +++ b/slv2/util.h @@ -25,7 +25,7 @@ extern "C" { #endif -/** \defgroup util Utility functions +/** \defgroup slv2_util Utility functions * * @{ */ diff --git a/slv2/value.h b/slv2/value.h index 0d8f9dc..00cd39a 100644 --- a/slv2/value.h +++ b/slv2/value.h @@ -26,7 +26,7 @@ extern "C" { #include #include -/** \addtogroup data +/** \addtogroup slv2_data * @{ */ diff --git a/slv2/values.h b/slv2/values.h index 2535bdd..9d6c717 100644 --- a/slv2/values.h +++ b/slv2/values.h @@ -26,7 +26,7 @@ extern "C" { #endif -/** \defgroup collections Collections of values/objects +/** \defgroup slv2_collections Collections of values/objects * * Ordered collections of typed values which are fast for random * access by index (i.e. a fancy array). diff --git a/slv2/world.h b/slv2/world.h index 01e671c..610d830 100644 --- a/slv2/world.h +++ b/slv2/world.h @@ -27,7 +27,7 @@ extern "C" { #endif -/** \defgroup world Global library state +/** \defgroup slv2_world Global library state * * The "world" represents all library state, and the data found in bundles' * manifest.ttl (ie it is an in-memory index of all things LV2 found). -- cgit v1.2.1