Merge pull request #119 from kljohann/cmake.docs

convert doc/Makefile to CMake

CMakeLists.txt

@@ -1,6 +1,6 @@
 cmake_minimum_required(VERSION 2.8.5)
 
-project(Ledger)
+PROJECT(ledger)
 
 set(Ledger_VERSION_MAJOR 3)
 set(Ledger_VERSION_MINOR 0)
@@ -18,7 +18,8 @@ option(DISABLE_ASSERTS "Build without any internal consistency checks" OFF)
 option(BUILD_DEBUG "Build support for runtime debugging" OFF)
 
 option(BUILD_LIBRARY "Build and install Ledger as a library" ON)
-option(BUILD_DOCS "Build and install documentation" OFF)
+option(BUILD_DOCS "Build and install documentation" ON)
+option(BUILD_WEB_DOCS "Build version of documentation suitable for viewing online" OFF)
 option(BUILD_EMACSLISP "Build and install ledger-mode for Emacs" OFF)
 
 if(BUILD_DEBUG)

doc/CMakeLists.txt

@@ -0,0 +1,73 @@
+set(info_files ledger.texi ledger3.texi)
+
+find_program(MAKEINFO makeinfo)
+find_program(TEXI2PDF texi2pdf)
+find_program(MAN2HTML man2html)
+
+########################################################################
+
+foreach(file ${info_files})
+  get_filename_component(file_base ${file} NAME_WE)
+  if(BUILD_WEB_DOCS)
+    if(NOT MAKEINFO)
+      message(FATAL_ERROR "Could not find makeinfo. HTML version of documentation cannot be built.")
+    endif()
+
+    add_custom_command(OUTPUT ${file_base}.html
+      COMMAND makeinfo --force --html --no-split -o ${file_base}.html ${file}
+      DEPENDS ${file}
+      VERBATIM)
+    list(APPEND ledger_doc_files ${file_base}.html)
+  endif(BUILD_WEB_DOCS)
+
+  if(NOT TEXI2PDF)
+    mesage(WARNING "Could not find texi2pdf. PDF version of documentation will not be built.")
+  else()
+    get_filename_component(file_base ${file} NAME_WE)
+    add_custom_command(OUTPUT ${file_base}.pdf
+      COMMAND texi2pdf -b -q ${file}
+      COMMAND rm -f ${file_base}.aux ${file_base}.cp ${file_base}.fn ${file_base}.ky ${file_base}.log ${file_base}.pg ${file_base}.toc ${file_base}.tp ${file_base}.vr
+      DEPENDS ${file}
+      VERBATIM)
+    list(APPEND ledger_doc_files ${file_base}.pdf)
+  endif()
+endforeach()
+
+########################################################################
+
+if(BUILD_WEB_DOCS)
+  include(FindUnixCommands)
+  if(NOT BASH)
+    message(FATAL_ERROR "Could not find bash. Unable to build documentation.")
+  endif()
+  if(NOT MAN2HTML)
+    message(FATAL_ERROR "Could not find man2html. HTML version of man page cannot be built.")
+  endif()
+
+  add_custom_command(OUTPUT ledger.1.html
+    COMMAND ${BASH} -c "man2html ledger.1 | tail -n+3 > ledger.1.html"
+    DEPENDS ledger.1
+    VERBATIM)
+  list(APPEND ledger_doc_files ledger.1.html)
+endif(BUILD_WEB_DOCS)
+
+########################################################################
+
+add_custom_target(doc ALL DEPENDS ${ledger_doc_files})
+
+########################################################################
+
+include(GNUInstallDirs)
+
+if(CMAKE_INSTALL_MANDIR)
+  install(FILES ledger.1
+    DESTINATION ${CMAKE_INSTALL_MANDIR}/man1 COMPONENT doc)
+endif(CMAKE_INSTALL_MANDIR)
+
+if(CMAKE_INSTALL_DOCDIR)
+  foreach(file ${info_files})
+    get_filename_component(file_base ${file} NAME_WE)
+    install(FILES ${file_base}.pdf
+      DESTINATION ${CMAKE_INSTALL_DOCDIR} COMPONENT doc OPTIONAL)
+  endforeach()
+endif(CMAKE_INSTALL_DOCDIR)

doc/Makefile

@@ -1,17 +0,0 @@
-# quick doc-building makefile used by website
-# requires: man2html, texinfo
-
-docs: ledger.1.html ledger.html ledger.pdf ledger3.html ledger3.pdf
-
-%.1.html: %.1
-	-man2html $< | tail -n+3 >$@
-
-%.html: %.texi
-	-makeinfo --force --html --no-split -o $@ $<
-
-%.pdf: %.texi
-	-texi2pdf -b -q $<
-	rm -f $*.aux $*.cp $*.fn $*.ky $*.log $*.pg $*.toc $*.tp $*.vr
-
-clean:
-	rm -rf ledger.1.html ledger.html ledger3.html ledger.pdf ledger3.pdf