comparison README.compat @ 265:03c7167e1f30

* Use _VAMP_PLUGIN_IN_HOST_NAMESPACE rather than omitting plugin namespace completely in host context * Doc and build warning updates
author cannam
date Thu, 20 Nov 2008 20:16:05 +0000
parents 4454843ff384
children 53b0e7557c52
comparison
equal deleted inserted replaced
264:91ac8f5e52ea 265:03c7167e1f30
84 circumstances, and neither plugin nor host authors will normally need 84 circumstances, and neither plugin nor host authors will normally need
85 to care about it. 85 to care about it.
86 86
87 However, hosts that directly incorporate code from plugins, for 87 However, hosts that directly incorporate code from plugins, for
88 example to provide functionality that is the same as those plugins 88 example to provide functionality that is the same as those plugins
89 without having to explicitly load them, may find that they can no 89 without having to explicitly load them, will find that they cannot
90 longer resolve plugin functions at link time because of this namespace 90 resolve plugin symbols at link time because of this namespace
91 mismatch. To avoid this, the host build process should define the 91 mismatch. To avoid this, you may define the preprocessor symbol
92 preprocessor flag _VAMP_NO_PLUGIN_NAMESPACE when compiling the plugin 92 _VAMP_PLUGIN_IN_HOST_NAMESPACE when compiling the plugin code in the
93 code to ensure that both host and plugin code exist at the same level 93 context of the host, to ensure that both host and plugin code exist
94 of namespace. Note that the corresponding _VAMP_NO_HOST_NAMESPACE is 94 within the same namespace.
95 also available.
96 95
97 (If your host does this, why not make it load the plugins dynamically 96 (If your host does this, why not make it load the plugins dynamically
98 instead using the normal Vamp plugin loader method? There are many 97 instead using the normal Vamp plugin loader method? There are many
99 advantages to that.) 98 advantages to that.)
100 99