LaTeX-ify the manual

.gitignore

@@ -46,5 +46,17 @@ Makefile
 *.cbp
 *.user
 
+# Documentation
+*.cpt
+*.aux
+*.toc
+*.fls
+*.fdb_latexmk
+*.pyg
+*.pdf
+doc/doc/*
+doc/_minted*
+# ^ All files are copied to a directory when compiling the manual; don't wanna commit these!
+
 # Misc.
 *.log

CMakeLists.txt

@@ -16,6 +16,21 @@ enable_testing()
 
 add_definitions(-D_CRT_SECURE_NO_WARNINGS)
 
+option(GLM_BUILD_MANUAL_ENABLE "Build GLM manual (requires LaTeX, Python, and Pygments)" OFF)
+if(GLM_BUILD_MANUAL_ENABLE)
+  set(LATEX_OUTPUT_PATH "doc") # Where the pdf will ultimately be spit out
+
+  include(UseLATEX) # For compiling the manual
+  find_package(PythonInterp REQUIRED) # For LaTeX's minted package, needed for source highlighting
+  include(FindPythonModule) # For minted, which uses pygments
+  find_python_module(pygments REQUIRED)
+
+  if(LATEX_COMPILER AND PYTHONINTERP_FOUND AND PY_PYGMENTS)
+    add_latex_document("doc/glm.tex" TARGET_NAME manual)
+    message(STATUS "To build the GLM manual by itself, rather than as part of the default target, run the 'manual' target")
+  endif()
+endif()
+
 option(GLM_STATIC_LIBRARY_ENABLE "GLM static library" OFF)
 if(GLM_STATIC_LIBRARY_ENABLE)
 	message(STATUS "GLM is a header only library, no need to build it. Set the option GLM_STATIC_LIBRARY_ENABLE with ON to build an optional static library")

cmake/FindPythonModule.cmake

@@ -0,0 +1,25 @@
+# Find if a Python module is installed
+# Found at http://www.cmake.org/pipermail/cmake/2011-January/041666.html
+# To use do: find_python_module(PyQt4 REQUIRED)
+function(find_python_module module)
+	string(TOUPPER ${module} module_upper)
+	if(NOT PY_${module_upper})
+		if(ARGC GREATER 1 AND ARGV1 STREQUAL "REQUIRED")
+			set(${module}_FIND_REQUIRED TRUE)
+		endif()
+		# A module's location is usually a directory, but for binary modules
+		# it's a .so file.
+		execute_process(COMMAND "${PYTHON_EXECUTABLE}" "-c" 
+			"import re, ${module}; print(re.compile('/__init__.py.*').sub('',${module}.__file__))"
+			RESULT_VARIABLE _${module}_status 
+			OUTPUT_VARIABLE _${module}_location
+			ERROR_QUIET 
+			OUTPUT_STRIP_TRAILING_WHITESPACE)
+		if(NOT _${module}_status)
+			set(PY_${module_upper} ${_${module}_location} CACHE STRING 
+				"Location of Python module ${module}")
+		endif(NOT _${module}_status)
+	endif(NOT PY_${module_upper})
+	find_package_handle_standard_args(PY_${module} DEFAULT_MSG PY_${module_upper})
+endfunction(find_python_module)
+