[llvm-bugs] [Bug 44944] New: error when following instructions to build the documentation

[via llvm-bugs]

https://bugs.llvm.org/show_bug.cgi?id=44944

            Bug ID: 44944
           Summary: error when following instructions to build the
                    documentation
           Product: Documentation
           Version: trunk
          Hardware: Macintosh
                OS: MacOS X
            Status: NEW
          Severity: enhancement
          Priority: P
         Component: General docs
          Assignee: unassignedbugs at nondot.org
          Reporter: jean.christophe.helary at traduction-libre.org
                CC: llvm-bugs at lists.llvm.org

The llvm-project/llvm/docs/README.txt file reads:



If you instead would like to generate and view the HTML locally, install
Sphinx <http://sphinx-doc.org/> and then do:

   cd <build-dir>
   cmake -DLLVM_ENABLE_SPHINX=true -DSPHINX_OUTPUT_HTML=true <src-dir>
   make -j3 docs-llvm-html
   $BROWSER <build-dir>/docs//html/index.html



When I follow the instructions (macos) I get the following output:


===================================================
➜  llvm git:(master) mkdir html;cd html
➜  html git:(master) cmake -DLLVM_ENABLE_SPHINX=true -DSPHINX_OUTPUT_HTML=true
cmake /Users/suzume/Documents/Code/llvm-project/llvm/docs/
===================================================
CMake Warning (dev) in CMakeLists.txt:
 No project() command is present.  The top-level CMakeLists.txt file must
 contain a literal, direct call to the project() command.  Add a line of
 code such as

   project(ProjectName)

 near the top of the file, but after cmake_minimum_required().

 CMake is pretending there is a "project(Project)" command on the first
 line.
This warning is for project developers.  Use -Wno-dev to suppress it.

-- The C compiler identification is AppleClang 11.0.0.11000033
-- The CXX compiler identification is AppleClang 11.0.0.11000033
-- Check for working C compiler:
/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/cc
-- Check for working C compiler:
/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/cc
-- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Check for working CXX compiler:
/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/c++
-- Check for working CXX compiler:
/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/c++
-- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
CMake Error at CMakeLists.txt:106 (include):
 include could not find load file:

   AddSphinxTarget


CMake Warning (dev) in CMakeLists.txt:
 No cmake_minimum_required command is present.  A line of code such as

   cmake_minimum_required(VERSION 3.16)

 should be added at the top of the file.  The version specified may be lower
 if you wish to support older CMake versions for this project.  For more
 information run "cmake --help-policy CMP0000".
This warning is for project developers.  Use -Wno-dev to suppress it.

-- Configuring incomplete, errors occurred!
See also
"/Users/suzume/Documents/Code/llvm-project/llvm/html/CMakeFiles/CMakeOutput.log".

===================================================

So maybe there is something missing in the documentation.

-- 
You are receiving this mail because:
You are on the CC list for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/llvm-bugs/attachments/20200218/453963b1/attachment-0001.html>