Trying to comply with entry three here http://voices.canonical.com/jussi.pakkanen/2013/03/26/a-list-of-common-cmake-antipatterns/

Author: Roberto Di Remigio

CMakeLists.txt

@@ -24,10 +24,10 @@ set(CMAKE_MODULE_PATH
     ${CMAKE_SOURCE_DIR}/cmake
     ${CMAKE_SOURCE_DIR}/cmake/compilers
     ${CMAKE_SOURCE_DIR}/cmake/math
-    ${CMAKE_SOURCE_DIR}/cmake/testing
-    )
+    ${CMAKE_SOURCE_DIR}/cmake/testing)
 
 set(LIBS)
+set(header_dir_list)
 set(libs_to_merge)
 
 include(ConfigVersion)
@@ -45,6 +45,7 @@ FortranCInterface_HEADER(include/FCMangle.hpp)
 include(MergeStaticLibs)
 
 find_package(PythonInterp REQUIRED)
+find_package(ZLIB REQUIRED) 
 
 set(Boost_USE_STATIC_LIBS   ON)
 if(ENABLE_TESTS)
@@ -163,6 +164,7 @@ file(COPY ${PROJECT_BINARY_DIR}/update_gh-pages.py
 include_directories(${EIGEN3_INCLUDE_DIR}
 	            ${Boost_INCLUDE_DIRS}
 		    ${Boost_QUADRATURE}
+		    ${ZLIB_INCLUDE_DIRS}
 		    ${PROJECT_SOURCE_DIR}
 		    ${PROJECT_SOURCE_DIR}/external
 		    ${PROJECT_BINARY_DIR}/include
@@ -195,8 +197,10 @@ install(FILES
 if(ENABLE_TESTS)
 	include(ConfigFramework)
 	include(TestingMacros)
+	
+	find_package(Threads REQUIRED)
 
-        set(LIBS pthread z ${LIBS})
+	list(APPEND LIBS ${CMAKE_THREAD_LIBS_INIT} ${ZLIB_LIBRARIES})
 
 	setup_boosttest()
 
@@ -211,7 +215,5 @@ endif()
 # Merge static libs from subfolders into one static lib: libpcm.a
 # This is the very last thing we do, i.e. DO NOT add anything depending on this target!!!
 merge_static_libs(pcm
-		  "${libs_to_merge}"
-		 )
+		  "${libs_to_merge}")
 install(TARGETS pcm ARCHIVE DESTINATION lib)
-

doc/Building.dox

@@ -42,7 +42,7 @@ that you have a sane build, you will have to run the unit test suite.
  + Eigen libraries version 3.0.0 and higher;
 \note Version 3.2.0 of Eigen libraries is shipped with the module and resides in the `external` subdirectory.
 Unless you want to use another version of Eigen, you should not worry about satisfying this dependency.
- + `libzip` (unit test suite only);
+ + [zlib](http://www.zlib.net/) (unit test suite only);
  + Pthread (unit test suite only);
  + Doxygen version 1.7.6 and higher (documentation only)
 

doc/CMakeUsage.dox

@@ -120,4 +120,17 @@ CMakeLists.txt in the project tree. This is achieved by using the touch_cmakelis
 script found in build/bin (build is the name chosen for the build directory)
 If you add new files *before* configuring the project there is no need to invoke touch_cmakelists
 prior to building.
+
+### Searching for libraries
+In general, the use of the [find_package](http://www.cmake.org/cmake/help/v3.0/command/find_package.html) macro is to be preferred, 
+as it is standardized and ensured to work on any platform.
+Use of `find_package` requires that the package/library you want to use has already a module inside the CMake distribution.
+If that's not the case, you should *never* use the following construct for third-party libraries:
+	
+	target_link_libraries(myexe -lsomesystemlib)
+
+If the library does not exist, the end result is a cryptic linker error. See also [this Jussi Pakkanen's blog entry](http://voices.canonical.com/jussi.pakkanen/2013/03/26/a-list-of-common-cmake-antipatterns/)
+You will first need to find the library, using the macro [find_library](http://www.cmake.org/cmake/help/v3.0/command/find_library.html), and then use
+the `target_link_libraries` command.
+
 */

src/CMakeLists.txt

@@ -10,8 +10,7 @@ set(header_dir_list
 	${CMAKE_CURRENT_SOURCE_DIR}/solver
 	${CMAKE_CURRENT_SOURCE_DIR}/utils
 	${CMAKE_CURRENT_SOURCE_DIR}/wavcav
-	${CMAKE_CURRENT_SOURCE_DIR}/wem
-   )
+	${CMAKE_CURRENT_SOURCE_DIR}/wem)
 include_directories(${header_dir_list})
 
 # Initialize Includer.hpp header