无法为 Boost C++ 库生成 PDF 文档

Question

我最近尝试为Boost 库生成PDF 文档。但我在Windows 10 和Fedora 28 上都失败了，错误消息如下（这是我的Fedora 28 上的错误消息）：

/home/krantz/soft/boost_1_67_0/libs/predef/check/../tools/check/predef.jam:46: Unescaped special character in argument $(language)::$(expression)
/home/krantz/soft/boost_1_67_0/libs/xpressive/doc/Jamfile.v2:49: Unescaped special character in argument <format>pdf:<xsl:param>boost.url.prefix=http://www.boost.org/doc/libs/release/doc/html
/home/krantz/soft/boost_1_67_0/libs/winapi/doc/Jamfile.v2:19: Unescaped special character in argument <format>pdf:<xsl:param>boost.url.prefix=http://www.boost.org/doc/libs/release/libs/winapi/doc/html
Building the variadic_macro_data docs with automatic index generation enabled.
/home/krantz/soft/boost_1_67_0/libs/variant/doc/Jamfile.v2:18: Unescaped special character in argument <format>pdf:<xsl:param>boost.url.prefix=http://www.boost.org/doc/libs/release/doc/html
/home/krantz/soft/boost_1_67_0/libs/utility/doc/Jamfile.v2:38: Unescaped special character in argument <format>pdf:<xsl:param>boost.url.prefix=http://www.boost.org/doc/libs/release/libs/utility/doc/html
/home/krantz/soft/boost_1_67_0/libs/unordered/doc/Jamfile.v2:61: Unescaped special character in argument <format>pdf:<xsl:param>boost.url.prefix=http://www.boost.org/doc/libs/release/libs/unordered/doc/html
/home/krantz/soft/boost_1_67_0/libs/units/doc/Jamfile.v2:213: Unescaped special character in argument <format>pdf:<xsl:param>boost.url.prefix=http://www.boost.org/doc/libs/release/doc/html
/home/krantz/soft/boost_1_67_0/libs/type_traits/doc/Jamfile.v2:61: Unescaped special character in argument <format>pdf:<xsl:param>boost.url.prefix=http://www.boost.org/doc/libs/release/libs/type_traits/doc/html
/home/krantz/soft/boost_1_67_0/libs/type_index/doc/Jamfile.v2:34: Unescaped special character in argument <xsl:param>boost.root=http://www.boost.org/doc/libs/1_53_0
/home/krantz/soft/boost_1_67_0/libs/type_index/doc/Jamfile.v2:36: Unescaped special character in argument <format>pdf:<xsl:param>boost.url.prefix=http://www.boost.org/doc/libs/release/doc/html
Building the tti docs with automatic index generation disabled. Try building with --enable-index.
/home/krantz/soft/boost_1_67_0/libs/test/doc/Jamfile.v2:143: Unescaped special character in argument <format>pdf:<xsl:param>boost.url.prefix=http://www.boost.org/doc/libs/release/libs/test/doc/html
/home/krantz/soft/boost_1_67_0/libs/static_assert/doc/Jamfile.v2:38: Unescaped special character in argument <format>pdf:<xsl:param>boost.url.prefix=http://www.boost.org/doc/libs/release/doc/html
/home/krantz/soft/boost_1_67_0/libs/stacktrace/doc/Jamfile.v2:42: Unescaped special character in argument <xsl:param>boost.root=http://www.boost.org/doc/libs/1_63_0
/home/krantz/soft/boost_1_67_0/libs/stacktrace/doc/Jamfile.v2:44: Unescaped special character in argument <format>pdf:<xsl:param>boost.url.prefix=http://www.boost.org/doc/libs/release/doc/html
/home/krantz/soft/boost_1_67_0/libs/spirit/doc/Jamfile:53: Unescaped special character in argument <format>pdf:<xsl:param>boost.url.prefix=http://www.boost.org/doc/libs/release/libs/spirit/doc/html
Building the Spirit docs with automatic index generation disabled.  Try building with --enable-index.
Building the Spreadsort docs with automatic index generation disabled. Try building with --enable-index.
/home/krantz/soft/boost_1_67_0/libs/sort/doc/Jamfile.v2:90: in modules.load
*** argument error
* rule doxygen ( target : sources + : requirements * : default-build * : usage-requirements * )
* called with: ( autodoc :  : <doxygen:param>PROJECT_NAME=Sort <doxygen:param>RECURSIVE=NO <doxygen:param>ENABLE_PREPROCESSING=YES <doxygen:param>EXPAND_ONLY_PREDEF=YES <doxygen:param>EXTRACT_ALL=NO <doxygen:param>EXTRACT_PRIVATE=NO <doxygen:param>HIDE_UNDOC_MEMBERS=YES <doxygen:param>MACRO_EXPANSION=YES <doxygen:param>SORT_MEMBER_DOCS=NO <doxygen:param>SHOW_INCLUDE_FILES=NO <doxygen:param>MAX_INITIALIZER_LINES=0 <doxygen:param>VERBATIM_HEADERS=NO <doxygen:param>WARNINGS=NO <doxygen:param>WARN_IF_UNDOCUMENTED=NO <doxygen:param>WARN_IF_DOC_ERROR=YES <doxygen:param>WARN_LOGFILE=AutoDoxywarnings.log <xsl:param>boost.doxygen.reftitle=Boost.Sort C++ Reference )
* missing argument sources
/home/krantz/soft/boost_1_67_0/tools/build/src/tools/doxygen.jam:627:see definition of rule 'doxygen' being called
/home/krantz/soft/boost_1_67_0/tools/build/src/build/project.jam:325: in load-jamfile
/home/krantz/soft/boost_1_67_0/tools/build/src/build/project.jam:64: in load
/home/krantz/soft/boost_1_67_0/tools/build/src/build/project.jam:145: in project.find
../Jamfile.v2:96: in modules.load
/home/krantz/soft/boost_1_67_0/tools/build/src/build/project.jam:325: in load-jamfile
/home/krantz/soft/boost_1_67_0/tools/build/src/build/project.jam:64: in load
/home/krantz/soft/boost_1_67_0/tools/build/src/build/project.jam:113: in load-parent
/home/krantz/soft/boost_1_67_0/tools/build/src/build/project.jam:464: in initialize
/home/krantz/soft/boost_1_67_0/tools/build/src/build/project.jam:306: in load-jamfile
/home/krantz/soft/boost_1_67_0/tools/build/src/build/project.jam:64: in load
/home/krantz/soft/boost_1_67_0/tools/build/src/build/project.jam:145: in project.find
/home/krantz/soft/boost_1_67_0/tools/build/src/build-system.jam:618: in load
/home/krantz/soft/boost_1_67_0/tools/build/src/kernel/modules.jam:295: in import
/home/krantz/soft/boost_1_67_0/tools/build/src/kernel/bootstrap.jam:139: in boost-build
/home/krantz/soft/boost_1_67_0/boost-build.jam:17: in module scope

当我在$BOOST_PATH/doc/pdf 中运行b2 pdf 时，会打印出此消息。

这样的错误是否可以修复，或者网上有预建的版本吗？我在 SourceForge 上找到了一个旧版本，但它从 2014 年开始就没有更新过，所以我想知道我是否可以获得1.64 或更高版本的版本。

Answer 1

看来这些可以修复by changing

import doxygen ;
import quickbook ;

到

using doxygen ;
using quickbook ;

和quoting the string containing a colon（例如<cxxflags>"/std:c++14"）在Jamfile.v2中。