Merge branch 'master' into different-output-folders

Author: Atari2

.gitignore

@@ -52,3 +52,6 @@ CMakeCache.txt
 tests_tmp_dll/
 tests_tmp_app/
 *.aps
+
+# Just because I like building into /bin...
+/bin

README.md

@@ -14,11 +14,18 @@ If you'd rather not build from source, check out the [Releases](https://github.c
 Asar can also be built as a DLL. This makes it easier and faster to use in other programs (such as a sprite insertion tool). You can find documentation on the DLL API in the respective bindings (asardll.h, asar.cs, asar.py).
 
 ## Asar as a static library
-Asar can also be build as a static library. All "out-facing" functions are in interface-lib.h. This is useful for embedding Asar in other programs which don't want to use DLLs. The easiest way to add asar as a static library to your project, assuming you are using CMake (at least 3.11), is to use [FetchContent](https://cmake.org/cmake/help/latest/module/FetchContent.html) to fetch the source code, then add the following to your CMakeLists.txt:
+Asar can also be built as a static library. All "out-facing" functions are in interface-lib.h. This is useful for embedding Asar in other programs which don't want to use DLLs. The easiest way to add asar as a static library to your project is to add it as a git submodule 
+
+`git submodule add https://github.com/RPGHacker/asar <path-to-subdir>`
+
+then add the following to your CMakeLists.txt:
 ```CMake
-target_include_directories(YourTarget PUBLIC ${asar_SOURCE_DIR}/src)
+add_subdirectory(<path-to-subdir>/src)
+get_target_property(ASAR_INCLUDE_DIR asar-static INCLUDE_DIRECTORIES)
+include_directories(${ASAR_INCLUDE_DIR})
+target_link_libraries(YourTarget PUBLIC asar-static)
 ```
-to be able to include the header files. It is also recommended to add `set(ASAR_TESTING_DISABLED TRUE)` to your CMakeLists.txt to disable building tests.
+to be able to include the header files. It is also recommended to turn off every build in target in asar except the static one using the appropriate CMake options. You will need to make sure that your project has an Asar compatible license.
 
 ## Folder layout
 * `docs` contains the source of the manual and changelog.

src/asar/CMakeLists.txt

@@ -235,14 +235,16 @@ if(ASAR_GEN_EXE)
 		target_compile_options(asar-standalone PRIVATE -fprofile-arcs -ftest-coverage)
 		SET(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -lgcov --coverage -fprofile-arcs")
 	endif()
-
+  
 	set_target_properties(asar-standalone
 		PROPERTIES
 		OUTPUT_NAME "asar"
 		ARCHIVE_OUTPUT_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/bin"
 		LIBRARY_OUTPUT_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/bin"
 		RUNTIME_OUTPUT_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/bin"
 	)
+
+	install(TARGETS asar-standalone)
 endif(ASAR_GEN_EXE)
 
 
@@ -260,6 +262,7 @@ if(ASAR_GEN_DLL)
 		${ASAR_SHARED_SOURCE_FILES}
 		${ASAR_LIB_RESOURCE_FILES}
 	)
+
 	target_compile_definitions(asar PRIVATE "ASAR_SHARED")
 	set_asar_shared_properties(asar "T" TRUE)
 
@@ -269,6 +272,9 @@ if(ASAR_GEN_DLL)
 		LIBRARY_OUTPUT_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/lib"
 		RUNTIME_OUTPUT_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/lib"
 	)
+
+	install(TARGETS asar)
+
 endif(ASAR_GEN_DLL)
 
 
@@ -288,6 +294,8 @@ if (ASAR_GEN_LIB)
 	target_compile_definitions(asar-static PRIVATE "ASAR_STATIC")
 	set_asar_shared_properties(asar-static "D" FALSE)
 
+	install(TARGETS asar-static)
+
 	# there's no need to set the PDB name since static libraries don't produce PDBs
 	set_target_properties(asar-static
 		PROPERTIES