Substantially reorganise sources to insulate

CMakeLists.txt

@@ -28,9 +28,12 @@ execute_process(
 )
 
 configure_file( "source/cath_tools_git_version.hpp.in"
-                "source/cath_tools_git_version.hpp"
+                "source/cath_tools_git_version/cath_tools_git_version.hpp"
                 )
 
+include_directories( $<BUILD_INTERFACE:${PROJECT_BINARY_DIR}/source/cath_tools_git_version> )
+
+
 SET( CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} "${CMAKE_SOURCE_DIR}/cmake/Modules/" )
 IF ( ${CMAKE_VERSION} VERSION_GREATER "3.5.0" )
 	SET( CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} "${CMAKE_SOURCE_DIR}/cmake/FindBoostModules_gt_3.5.0/" )
@@ -116,14 +119,12 @@ endif()
 include_directories( SYSTEM ${Boost_INCLUDE_DIR} )
 include_directories( SYSTEM ${GSL_INCLUDE_DIR}   )
 include_directories( SYSTEM rapidjson/include    )
-include_directories( source                      )
 
 # Define GSL_RANGE_CHECK_OFF in non-debug builds
 add_compile_options( $<$<NOT:$<CONFIG:DEBUG>>:-DGSL_RANGE_CHECK_OFF> )
 
 add_definitions( -DRAPIDJSON_HAS_STDSTRING=1 )
 
-SET( CMAKE_INCLUDE_CURRENT_DIR      ON )
 SET( CMAKE_RUNTIME_OUTPUT_DIRECTORY .. )
 
 if ( DEFINED ENV{BUILD_REVISION_NUMBER} )
@@ -133,4 +134,4 @@ if ( DEFINED ENV{BUILD_BRANCH_NAME} )
   add_definitions( -DBUILD_BRANCH_NAME=$ENV{BUILD_BRANCH_NAME} )
 endif ( DEFINED ENV{BUILD_BRANCH_NAME} )
 
-add_subdirectory   ( source )
+add_subdirectory( source )

source/README.md

@@ -0,0 +1,10 @@
+Layout:
+
+ * cath-superpose-multi-temp-script - Script to make it a bit easier to do multiple superpositions with cath-superpose
+ * cath_tools_git_version.hpp.in    - Template from which CMake can make a header in the build directory with the Git version details
+ * CMakeLists.txt                   - CMake configuration file for these sources
+ * src_*                            - Individual libraries in separate directories to prevent inappropriate #include-ing
+ * uni                              - A big mess of interdependent source code that should be separated out into libraries
+ * [anything else]                    - Library that isn't quite separated enough as yet to go into its own separate src_* directory
+
+Ideally, code should migrate from uni / [anything else] into src_*.