[PATCH] D86866: Add Option to sphinx-build for custom conf file location

Dibya Ranjan Mishra via Phabricator via llvm-commits llvm-commits at lists.llvm.org
Mon Aug 31 03:16:05 PDT 2020


dibya001 created this revision.
dibya001 added reviewers: mgorny, shankare, tstellar, labath, tatyana-krasnukha.
Herald added subscribers: llvm-commits, danielkiss.
Herald added a project: LLVM.
dibya001 requested review of this revision.

If custom conf file location not provided, then conf.py file will be searched in the source directory.


Repository:
  rG LLVM Github Monorepo

https://reviews.llvm.org/D86866

Files:
  llvm/cmake/modules/AddSphinxTarget.cmake


Index: llvm/cmake/modules/AddSphinxTarget.cmake
===================================================================
--- llvm/cmake/modules/AddSphinxTarget.cmake
+++ llvm/cmake/modules/AddSphinxTarget.cmake
@@ -18,7 +18,7 @@
 #
 # ``project`` should be the project name
 function (add_sphinx_target builder project)
-  cmake_parse_arguments(ARG "" "SOURCE_DIR" "" ${ARGN})
+  cmake_parse_arguments(ARG "" "SOURCE_DIR;CONF_FILE_DIR" "" ${ARGN})
   set(SPHINX_BUILD_DIR "${CMAKE_CURRENT_BINARY_DIR}/${builder}")
   set(SPHINX_DOC_TREE_DIR "${CMAKE_CURRENT_BINARY_DIR}/_doctrees-${project}-${builder}")
   set(SPHINX_TARGET_NAME docs-${project}-${builder})
@@ -33,9 +33,14 @@
     set(ARG_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}")
   endif()
 
+  if (NOT ARG_CONF_FILE_DIR)
+    set(ARG_CONF_FILE_DIR "${CMAKE_CURRENT_SOURCE_DIR}")
+  endif()
+
   add_custom_target(${SPHINX_TARGET_NAME}
                     COMMAND ${SPHINX_EXECUTABLE}
                             -b ${builder}
+                            -c ${ARG_CONF_FILE_DIR}
                             -d "${SPHINX_DOC_TREE_DIR}"
                             -q # Quiet: no output other than errors and warnings.
                             -t builder-${builder} # tag for builder


-------------- next part --------------
A non-text attachment was scrubbed...
Name: D86866.288908.patch
Type: text/x-patch
Size: 1239 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/llvm-commits/attachments/20200831/dd758fef/attachment.bin>


More information about the llvm-commits mailing list