Browse Source

doc: better info about debug/release plugin dirs.

Someone should already tell me that all my writing sucks and the
documentation is incomprehensible wall of text. Thanks in advance.
pull/85/head
Vladimír Vondruš 12 years ago
parent
commit
926740961d
  1. 14
      doc/plugins.dox

14
doc/plugins.dox

@ -98,10 +98,11 @@ to these:
In case you are using multi-configuration build system (such as Visual Studio In case you are using multi-configuration build system (such as Visual Studio
or XCode), CMake cannot provide separate plugin directory for debug and release or XCode), CMake cannot provide separate plugin directory for debug and release
build and you have to do it on your own in preprocessing step using build and you have to select between `MAGNUM_PLUGINS_*_DIR` and
@ref corrade-cmake "CORRADE_IS_DEBUG_BUILD" variable. This will ensure that you `MAGNUM_PLUGINS_*_DEBUG_DIR` based on @ref corrade-cmake "CORRADE_IS_DEBUG_BUILD"
use debug plugin directory for debug build on multi-configuration build sytems preprocessor variable. This will ensure that you use debug plugin directory for
and fall back to autodetection for the rest: debug build on multi-configuration build sytems and fall back to autodetection
for the rest:
@code @code
#ifdef CORRADE_IS_DEBUG_BUILD #ifdef CORRADE_IS_DEBUG_BUILD
#define MAGNUM_PLUGINS_IMPORTER_DIR "${MAGNUM_PLUGINS_IMPORTER_DEBUG_DIR}" #define MAGNUM_PLUGINS_IMPORTER_DIR "${MAGNUM_PLUGINS_IMPORTER_DEBUG_DIR}"
@ -110,6 +111,11 @@ and fall back to autodetection for the rest:
#endif #endif
@endcode @endcode
However, if you want to use only one (debug/release) plugin version for both
debug and release configurations of the application, you need to edit
`MAGNUM_PLUGINS_DIR` or `MAGNUM_PLUGINS_DEBUG_DIR` using CMake and point them
to directory containing desired plugin version.
Then process the file in your `CMakeLists.txt`. The result Then process the file in your `CMakeLists.txt`. The result
(`${MAGNUM_PLUGINS_IMPORTER_DIR}` / `${MAGNUM_PLUGINS_IMPORTER_DEBUG_DIR}` gets (`${MAGNUM_PLUGINS_IMPORTER_DIR}` / `${MAGNUM_PLUGINS_IMPORTER_DEBUG_DIR}` gets
replaced with the actual value) is put into build directory, so don't forget to replaced with the actual value) is put into build directory, so don't forget to

Loading…
Cancel
Save