add man to html doc

.gitignore

@@ -17,6 +17,5 @@ install_manifest.txt
 Makefile
 build/
 
-html/
 Doxyfile
 doxygen_sqlite3.db

CI/travis/before_install_linux

@@ -14,6 +14,11 @@ install_sphinx() {
 }
 
 handle_centos() {
+	# needed for man2html and a few other popular tools
+	yum search epel-release
+	yum info epel-release
+	yum -y install epel-release
+
 	# FIXME: see about adding `libserialport-dev` from EPEL ; maybe libusb-1.0.0-devel...
 	yum -y groupinstall 'Development Tools'
 	yum -y install cmake libxml2-devel libusb1-devel libaio-devel \
@@ -31,7 +36,7 @@ handle_centos() {
 
 	# CENTOS 6 will has issues with sphinx
 	if is_centos_at_least_ver "7" ; then
-		yum -y install doxygen
+		yum -y install doxygen man2html
 		install_sphinx
 	fi
 
@@ -54,7 +59,7 @@ handle_default() {
 		bzip2 gzip flex bison git lsb-release python3-pip
 
 	if [ -n "${GH_DOC_TOKEN}" ] ; then
-		sudo apt-get install -y doxygen
+		sudo apt-get install -y doxygen man2html
 		install_sphinx
 	fi
 	if [ `sudo apt-cache search libserialport-dev | wc -l` -gt 0 ] ; then

CI/travis/make_linux

@@ -9,10 +9,10 @@ handle_default() {
 	mkdir -p build
 	cd build
 
-	echo "### cmake -DENABLE_PACKAGING=ON -DDEB_DETECT_DEPENDENCIES=ON"
-	echo "          -DPYTHON_BINDINGS=ON"
-	cmake -DENABLE_PACKAGING=ON -DDEB_DETECT_DEPENDENCIES=ON \
-		-DPYTHON_BINDINGS=ON ..
+	FLAGS="-DENABLE_PACKAGING=ON -DDEB_DETECT_DEPENDENCIES=ON -DPYTHON_BINDINGS=ON"
+
+	echo "### cmake ${FLAGS}"
+	cmake ${FLAGS} ..
 
 	echo "### make"
 	make
@@ -27,9 +27,9 @@ handle_default() {
 	if command_exists sphinx-build ; then
 		# to build the python doc, libiio and py-iio need to be installed
 		# so we need to re-do some minor things now that they are
-		echo "### enable -DWITH_DOC=ON"
-		cmake -DENABLE_PACKAGING=ON -DDEB_DETECT_DEPENDENCIES=ON \
-			-DPYTHON_BINDINGS=ON -DWITH_DOC=ON ..
+		FLAGS="${FLAGS} -DWITH_DOC=ON -DWITH_MAN=ON"
+		echo "### cmake ${FLAGS}"
+		cmake ${FLAGS} ..
 		echo "### make"
 		make
 	fi

CMakeLists.txt

@@ -393,15 +393,25 @@ if(WITH_DOC)
 	configure_file(
 		${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile.in
 		${CMAKE_CURRENT_BINARY_DIR}/Doxyfile @ONLY)
+	configure_file(
+		${CMAKE_CURRENT_SOURCE_DIR}/bindings/csharp/Doxyfile.in
+		${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_csharp @ONLY)
 	configure_file(
 		${CMAKE_CURRENT_SOURCE_DIR}/CI/travis/generateDocumentationAndDeploy.sh.in
 		${CMAKE_CURRENT_BINARY_DIR}/generateDocumentationAndDeploy.sh @ONLY)
-	file(COPY ${CMAKE_CURRENT_SOURCE_DIR}/doc DESTINATION ${CMAKE_HTML_DEST_DIR}/${CMAKE_API_DEST_DIR})
+	file(COPY ${CMAKE_CURRENT_SOURCE_DIR}/doc
+		DESTINATION ${CMAKE_HTML_DEST_DIR}/${CMAKE_API_DEST_DIR}
+		FILES_MATCHING PATTERN "*.svg")
+	file(COPY ${CMAKE_CURRENT_SOURCE_DIR}/doc/html/ DESTINATION ${CMAKE_HTML_DEST_DIR})
 
 	add_custom_command(TARGET iio POST_BUILD
 		COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile
 		WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
 		COMMENT "Generating API documentation with Doxygen" VERBATIM)
+	add_custom_command(TARGET iio POST_BUILD
+		COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_csharp
+		WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+		COMMENT "Generating C# documentation with Doxygen" VERBATIM)
 
 	if(NOT SKIP_INSTALL_ALL)
 		install(DIRECTORY ${HTML_DEST_DIR}

Doxyfile.in

@@ -616,7 +616,7 @@ WARN_FORMAT            = "$file:$line: $text"
 # messages should be written. If left blank the output is written to standard
 # error (stderr).
 
-WARN_LOGFILE           =
+WARN_LOGFILE           = @CMAKE_BINARY_DIR@/Dox_output_@PROJECT_NAME@
 
 #---------------------------------------------------------------------------
 # Configuration options related to the input files

bindings/csharp/Context.cs

@@ -100,6 +100,7 @@ private static extern IntPtr iio_create_context_from_uri(
 
         /// <summary>Retrieve a human-readable information string about the current context.</summary>
         public readonly string description;
+        /// <summary>Retrieve a information about the version context.</summary>
         public readonly Version library_version, backend_version;
 
         /// <summary>A <c>List</c> of all the IIO devices present on the current context.</summary>