Make doxygen log format configurable. Refs #6582

A slightly different style in Visual Studio makes its error parsers
understand the format.

Code/Mantid/Framework/Doxygen/CMakeLists.txt

@@ -30,6 +30,14 @@ if(DOXYGEN_FOUND)
     set ( GENERATE_QHELP YES )
   endif ( QHELP_EXECUTABLE )
 
+  # Put the warning format in something sensible for the generator we are using
+  if( MSVC )
+    # Allows Visual Studio to mark them as if they were compiler warnings and jump straight to them
+    set ( DOXY_WARN_FORMAT "\"$file($line): $text\"" CACHE STRING "Warning format for doxygen output, which must include surrounding double quotes" )
+  else()
+    set ( DOXY_WARN_FORMAT "\"$file:$line: $text \"" CACHE STRING "Warning format for doxygen output, which must include surrounding double quotes" )
+  endif()
+
   # configure doxygen
   add_custom_command ( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/../../doxygen/html/Mantid_Logo_Transparent.png
                        COMMAND ${CMAKE_COMMAND} ARGS -E copy_if_different  ${CMAKE_SOURCE_DIR}/Images/Mantid_Logo_Transparent.png ${CMAKE_CURRENT_BINARY_DIR}/../../doxygen/html/Mantid_Logo_Transparent.png

Code/Mantid/Framework/Doxygen/Mantid_template.doxyfile

@@ -71,7 +71,7 @@ WARNINGS               = YES
 WARN_IF_UNDOCUMENTED   = YES
 WARN_IF_DOC_ERROR      = YES
 WARN_NO_PARAMDOC       = YES
-WARN_FORMAT            = "$file:$line: $text "
+WARN_FORMAT            = @DOXY_WARN_FORMAT@
 WARN_LOGFILE           = 
 #---------------------------------------------------------------------------
 # configuration options related to the input files