Failed to use SPHINX_HTML option in CMakeHelp sub-project
Problem Description
Recently, I tried to use the sub-project CMakeHelp
located in Utilities/Sphinx
directory to generate its documentation.
However, I met an error when running cmake --build .
command. The followings are the commands that I used in order:
git clone https://github.com/Kitware/CMake.git
cd CMake
cd Utilities
cd Sphinx
mkdir build
cd build
cmake .. -DSPHINX_HTML=ON
cmake --build .
And the following is the log output generated:
Click to expand details
D:\Repo\tmp>git clone https://github.com/Kitware/CMake.git
Cloning into 'CMake'...
remote: Enumerating objects: 385060, done.
remote: Counting objects: 100% (2312/2312), done.
remote: Compressing objects: 100% (1073/1073), done.
remote: Total 385060 (delta 1313), reused 2098 (delta 1201), pack-reused 382748
Receiving objects: 100% (385060/385060), 137.43 MiB | 5.78 MiB/s, done.
Resolving deltas: 100% (293094/293094), done.
Updating files: 100% (22796/22796), done.
D:\Repo\tmp>cd CMake
D:\Repo\tmp\CMake>cd Utilities
D:\Repo\tmp\CMake\Utilities>cd Sphinx
D:\Repo\tmp\CMake\Utilities\Sphinx>mkdir build
D:\Repo\tmp\CMake\Utilities\Sphinx>cd build
D:\Repo\tmp\CMake\Utilities\Sphinx\build>cmake .. -DSPHINX_HTML=ON
-- Building for: Visual Studio 17 2022
-- Selecting Windows SDK version 10.0.22000.0 to target Windows 10.0.22621.
-- Configuring done
-- Generating done
-- Build files have been written to: D:/Repo/tmp/CMake/Utilities/Sphinx/build
D:\Repo\tmp\CMake\Utilities\Sphinx\build>cmake --build .
MSBuild version 17.5.0+6f08c67f3 for .NET Framework
Checking Build System
sphinx-build html: see Utilities/Sphinx/build-html.log
CUSTOMBUILD : Encoding error : [D:\Repo\tmp\CMake\Utilities\Sphinx\build\documentation.vcxproj]
'cp950' codec can't decode byte 0xe2 in position 7847: illegal multibyte sequence
The full traceback has been saved in C:\Users\HWHSU1~1\AppData\Local\Temp\sphinx-err-2zxxgzqf.log, if you want to report the issue to the developers.
C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Microsoft\VC\v170\Microsoft.CppCommon.targets(247,5): error MSB8066: 'D:\Repo\tmp\CMake\Uti
lities\Sphinx\build\CMakeFiles\ae4ff6ca6403b33cd3a8f8e8cdc7262d\doc_format_html.rule;D:\Repo\tmp\CMake\Utilities\Sphinx\build\CMakeFiles\7bfa95f9495c06f1c4
9df967fc1d2335\documentation.rule;D:\Repo\tmp\CMake\Utilities\Sphinx\CMakeLists.txt' 的自訂建置已結束,代碼為 2。 [D:\Repo\tmp\CMake\Utilities\Sphinx\build\documentatio
n.vcxproj]
Is this a bug? If not, what do I miss and how to solve it?