summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTom Rondeau <tom@trondeau.com>2013-09-24 13:32:45 -0400
committerTom Rondeau <tom@trondeau.com>2013-09-24 13:32:45 -0400
commitbde3304844a9a30cc3ce7e91362adbf0f1abc3c2 (patch)
tree1d7ea84143b432814437bb635797c8bf0c8bcd15
parent72e8181b60c3762c7edbeeb71dee062a77f90e59 (diff)
parent0cad02d7f05c60762c8811bc6e05c9f5b49619c8 (diff)
Merge branch 'maint'
-rw-r--r--CMakeLists.txt5
-rw-r--r--cmake/Modules/GnuradioConfig.cmake2
-rw-r--r--docs/doxygen/other/main_page.dox50
3 files changed, 40 insertions, 17 deletions
diff --git a/CMakeLists.txt b/CMakeLists.txt
index ec2bec2d10..356ef0d4eb 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -312,11 +312,14 @@ SET(cmake_configs
)
if(NOT CMAKE_MODULES_DIR)
- set(CMAKE_MODULES_DIR lib/cmake/gnuradio)
+ set(CMAKE_MODULES_DIR lib${LIB_SUFFIX}/cmake/gnuradio)
endif(NOT CMAKE_MODULES_DIR)
# Install all other cmake files into same directory
file(GLOB cmake_others "cmake/Modules/*.cmake")
+list(REMOVE_ITEM cmake_others
+ "${CMAKE_SOURCE_DIR}/cmake/Modules/FindGnuradio.cmake"
+)
install(
FILES ${cmake_configs} ${cmake_others}
diff --git a/cmake/Modules/GnuradioConfig.cmake b/cmake/Modules/GnuradioConfig.cmake
index 6410dfa22b..eae9a4a4f8 100644
--- a/cmake/Modules/GnuradioConfig.cmake
+++ b/cmake/Modules/GnuradioConfig.cmake
@@ -120,4 +120,4 @@ GR_MODULE(UHD gnuradio-uhd gnuradio/uhd/api.h gnuradio-uhd)
GR_MODULE(VOCODER gnuradio-vocoder gnuradio/vocoder/api.h gnuradio-vocoder)
GR_MODULE(WAVELET gnuradio-wavelet gnuradio/wavelet/api.h gnuradio-wavelet)
GR_MODULE(WXGUI gnuradio-wxgui gnuradio/wxgui/api.h gnuradio-wxgui)
-GR_MODULE(PMT gnuradio-pmt pmt/pmt.h gnuradio-pmt)
+GR_MODULE(PMT gnuradio-runtime pmt/pmt.h gnuradio-pmt)
diff --git a/docs/doxygen/other/main_page.dox b/docs/doxygen/other/main_page.dox
index d6cc269f40..f96492c5cc 100644
--- a/docs/doxygen/other/main_page.dox
+++ b/docs/doxygen/other/main_page.dox
@@ -419,8 +419,8 @@ New as of 3.6.5.
Using gr_modtool, each package comes with the ability to easily locate
the gnuradio-runtime library using the 'find_package(GnuradioRuntime)'
-cmake command. This only locates that the library and include
-directories exist, which is enough for most simple projects.
+cmake command. This only locates the gnuradio-runtime library and
+include directory, which is enough for most simple projects.
As projects become more complicated and start needing to rely on other
GNU Radio components like gnuradio-blocks or gnuradio-filter, for
@@ -456,18 +456,38 @@ part of GNU Radio, the configuration will also fail.
\subsection oot_config_path_page Install Path
-Cmake has to know where to find these configuration files. They are
-installed into $prefix/lib/cmake/gnuradio. If $prefix is '/usr' or
-'/usr/local', then everything should work fine. If the GNU Radio
-install $prefix is something else, then Cmake must be told where to
-find it. This can be done in two ways. If you are installing the
-out-of-tree module into the same $prefix, then you would be setting
-'-DCMAKE_INSTALL_PREFIX' on the configuration command line. This is
-enough to tell Cmake where to look for the configuration files.
-
-The other way to do it is to set the CMAKE_PREFIX_PATH environmental
-variable to $prefix. You can then install your component anywhere
-you'd like and it will be able to find and configure against the
-installed GNU Radio.
+Cmake has to know where to find either the package config files or the
+GnuradioConfig.cmake script. The package config files are located in
+$prefix/lib/pkgconfig while all of the Cmake scripts from GNU Radio
+are installed into $prefix/lib/cmake/gnuradio.
+
+If the installed GNU Radio $prefix is '/usr' or '/usr/local', then
+everything should work fine. If the GNU Radio install $prefix is
+something else, then Cmake must be told where to find it. This can be
+done in a few ways:
+
+1. If you are installing the out-of-tree module into the same $prefix,
+then you would be setting '-DCMAKE_INSTALL_PREFIX' on the
+configuration command line. This is enough to tell Cmake where to look
+for the configuration files.
+
+2. Cmake will try to find the package config (*.pc) files. If it can,
+these files will instruct Cmake where to look for the rest of the
+configuration options. If this is not set, it can be set as:
+
+\code
+ export PKG_CONFIG_PATH=$prefix/lib/pkgconfg:$PKG_CONFIG_PATH
+\endcode
+
+3. Set the CMAKE_PREFIX_PATH environmental variable to $prefix.
+
+\code
+ export CMAKE_PREFIX_PATH=$prefix:$CMAKE_PREFIX_PATH
+\endcode
+
+
+With method 1, you will be installing your OOT project into the same
+$prefix as GNU Radio. With methods 2 and 3, you can install your
+component anywhere you like (using -DCMAKE_INSTALL_PREFIX).
*/