Created libraries from commonly used functions. Moved official/debug-helpers.lua into lib/dtutils/debug.lua. Created a logging library to provide various levels of logging. Documented all libraries and functions. Created tools to extract documentation in text, man page, and pdf formats.

tools/get_libdoc.lua

@@ -0,0 +1,46 @@
+--[[
+  get_libdoc.lua - retrieve the included library documentation and output it
+
+  Copyright (c) 2016, Bill Ferguson
+]]
+
+local dt = require "darktable"
+
+dt.configuration.check_version(...,{3,0,0})
+
+local function output_doc(d)
+  for _,section in pairs(d.Sections) do
+    if d[section] then
+      print(string.upper(string.gsub(section, "_", " ")))
+      print("\t" .. d[section] .. "\n")
+    end
+  end
+  print("\f")
+end
+
+-- find the libraries
+
+local output = io.popen("cd "..dt.configuration.config_dir.."/lua/lib ;find . -name \\*.lua -print | sort")
+
+-- loop through the libraries
+
+for line in output:lines() do
+  line = string.gsub(line, "/", ".")
+  local lib_name = line:sub(3,-5)
+  if lib_name:len() > 2 then
+    lib_name = "lib/" .. lib_name
+    local lib = require(lib_name)
+
+    -- print the documentation for the library
+    if lib.libdoc then
+      local doc = lib.libdoc
+      output_doc(doc)
+      for _,fdoc in pairs(doc.functions) do
+
+        -- print the documentation for each of the functions
+        output_doc(fdoc)
+      end
+    end
+  end
+end
+