Add configuration of libclang library path

doc/clang_doxygen.txt

@@ -66,6 +66,20 @@ comments, one of the supported snippet plugins has to be installed, see
 ==============================================================================
 4. Configuration				*clang_doxygen-configuration*
 
+					*'g:clang_doxygen_libclang_library_path'*
+'g:clang_doxygen_libclang_library_path'	string (default: unset)
+					global
+	If libClang can not be found automatically you have to set the path
+	where it can be found.  In most cases you should not need to set this
+	option.  If you however want to use a specific version of libClang or
+	your library is located in a non-standard location you can set the
+	path here.
+	This has to be set before using the clang doxygen plugin and can not
+	be changed after the plugin was loaded.
+	Example: If you are using LLVM 3.4 on Linux use: >
+		let g:clang_doxygen_libclang_library_path =
+		"/usr/lib/llvm-3.4/lib"
+
 					*'g:clang_doxygen_clang_args'*
 'g:clang_doxygen_clang_args'	list (default: [])
 				global

plugin/clang_doxygen.py

@@ -7,8 +7,8 @@
 # All rights reserved.
 
 import vim
-from clang.cindex import Index, SourceLocation, Cursor, File, CursorKind, TypeKind
 import re
+from clang.cindex import Index, SourceLocation, Cursor, File, CursorKind, TypeKind, Config, LibclangError
 
 # Generate doxygen comments for a class declaration.
 def handleClassDecl(c):
@@ -252,3 +252,19 @@ def generateDoxygen():
   vim.current.window.cursor = (insertLine, 0)
   # Call snippet plugin
   vim.command('call clang_doxygen_snippets#' + vim.eval("g:clang_doxygen_snippet_plugin") + '#trigger(\'' + "\n".join(doxygenLines).replace("\\", "\\\\") + '\')')
+
+# Try to find liblang. Set library path if necessary.
+def initialiseClangDoxygen():
+  conf = Config()
+
+  if vim.eval("exists(\"g:clang_doxygen_libclang_library_path\")") != "0":
+    Config.set_library_path(vim.eval("g:clang_doxygen_libclang_library_path"))
+    conf.set_library_path(vim.eval("g:clang_doxygen_libclang_library_path"))
+
+  try:
+    conf.get_cindex_library()
+  except LibclangError as e:
+    print "Error: " + str(e)
+    return
+
+  vim.command("let g:initialised_clang_doxygen = 1")

plugin/clang_doxygen.vim

@@ -80,9 +80,17 @@ else
 endif
 
 function! s:GenerateDoxygen()
-	python import sys
-	exe 'python sys.path = ["' . s:plugin_path . '"] + sys.path'
-	exe 'pyfile ' . s:plugin_path . '/clang_doxygen.py'
+  if !exists("g:initialised_clang_doxygen")
+    python import sys
+    exe 'python sys.path = ["' . s:plugin_path . '"] + sys.path'
+    exe 'pyfile ' . s:plugin_path . '/clang_doxygen.py'
+
+    python initialiseClangDoxygen()
+
+    if !exists("g:initialised_clang_doxygen")
+      return
+    endif
+  endif
 
   python generateDoxygen()
 endfunction