From: Gbkng <guillaume.brooking@gmail.com>
Date: Thu, 11 Apr 2024 13:09:43 +0000 (+0200)
Subject: style: format comments
X-Git-Tag: V9_13_0a1~9
X-Git-Url: http://git.salome-platform.org/gitweb/?a=commitdiff_plain;h=3d6e29162cb5a1de978b3f620968bd511654b6f2;p=tools%2Fmedcoupling.git

style: format comments
---

diff --git a/doc/developer/doxygen/CMakeLists.txt b/doc/developer/doxygen/CMakeLists.txt
index d3ada12d8..de75aa735 100644
--- a/doc/developer/doxygen/CMakeLists.txt
+++ b/doc/developer/doxygen/CMakeLists.txt
@@ -33,10 +33,9 @@ configure_file(static/header.html.in static/header.html @ONLY)
 IF(MEDCOUPLING_ENABLE_PYTHON)
   INCLUDE(doxy2swig/doxy2swig.cmake)
 
-
-  # :TRICKY: For ease of maintenance, documentation for code examples is
-  # splitted in several files. We here splice to a single file before running
-  # Doxygen.
+  # >>>>>>>>>>>>>>>>
+  # For ease of maintenance, documentation for code examples is splitted in
+  # several files. We here splice to a single file before running Doxygen.
 
   SET(EXAMPLE_FILES # files to concatenate: order is important!
     doxfiles/examples/medcouplingexamplesheader.doxy
@@ -64,8 +63,8 @@ IF(MEDCOUPLING_ENABLE_PYTHON)
   ENDFOREACH()
   # Note: The reason for writing to a temporary is so the real target file only
   # gets updated if its content has changed.
+  # <<<<<<<<<<<<<<<<
 
-  # Here is the "standard" procedure, as if ${input} was hand-written.
   ADD_CUSTOM_TARGET(dev_docs ALL
     COMMAND ${PYTHON_EXECUTABLE} ${pythondocexamplesgenerator} ${input} ${output}
     COMMAND ${DOXYGEN_EXECUTABLE} Doxyfile
@@ -102,9 +101,7 @@ ELSE()
   )
 ENDIF()
 
-#INSTALL(CODE "EXECUTE_PROCESS(COMMAND \"${CMAKE_COMMAND}\" --build ${PROJECT_BINARY_DIR} --target dev_docs)")
 INSTALL(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/doc_ref_dev/html/ DESTINATION ${MEDCOUPLING_INSTALL_DOC}/developer)
-#INSTALL(FILES images/head.png DESTINATION ${MEDCOUPLING_INSTALL_DOC}/developer)
 
 SET(MAKE_CLEAN_FILES doc_ref_dev tmp)
 SET_DIRECTORY_PROPERTIES(PROPERTIES ADDITIONAL_MAKE_CLEAN_FILES "${MAKE_CLEAN_FILES}")
diff --git a/doc/user/CMakeLists.txt b/doc/user/CMakeLists.txt
index 3619a1420..ccb6f06d5 100644
--- a/doc/user/CMakeLists.txt
+++ b/doc/user/CMakeLists.txt
@@ -31,8 +31,6 @@ ELSE()
   ADD_MULTI_LANG_DOCUMENTATION(TARGET_NAME usr_doc MODULE html)
 ENDIF()
 
-#ADD_DEPENDENCIES(usr_doc dev_docs)
-
 INSTALL(CODE "EXECUTE_PROCESS(COMMAND \"${CMAKE_COMMAND}\" --build ${PROJECT_BINARY_DIR} --target usr_doc)")
 INSTALL(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html DESTINATION ${MEDCOUPLING_INSTALL_DOC}/user)
 IF(MEDCOUPLING_BUILD_FRENCH_DOC)