Re: [Boost-build] Ticket #2232: Documentation build needs to detect missing prerequisites

From: Beman Dawes (bdawes_at_[hidden])
Date: 2008-08-20 13:59:29

Vladimir Prus wrote:
> Beman Dawes wrote:
>>> Can you explain how exactly can I get "partial documentation" built?
>> 1) Temporarily rename /usr/share/docbook-xsl and
>> /usr/share/xml/docbook/4.2 something else so they won't be found.
> 
> Well, I've changed paths in 'using boostbook' to something wrong, as
> I don't have system-wide docbook.
> 
>> 2) On a recent trunk checkout, delete bin.v2 and libs/mpi/doc/html if
>> they exist.
>>
>> 3) cd boost-root/libs/mpi/doc
>>     bjam >log
>>
>> 4) Note that while boost-root/libs/mpi/doc/html was created, it doesn't
>> contain anything.
>>
>> 5) Note that log doesn't clearly identify the missing component, or even
>> clearly say that there was a serious problem.
> 
> I get this:
> 
> xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/lib/lib.xsl
> 
>     XML_CATALOG_FILES=../../../bin.v2/boostbook_catalog.xml
> export XML_CATALOG_FILES
>  "xsltproc" --stringparam
> manifest "standalone_HTML.manifest" --xinclude -o "html/" "/home/ghost/Work/Boost/boost-svn/tools/boostbook/xs..failed
> xslt-xsltproc-dir html/standalone_HTML.manifest...
> ...failed updating 1 target...
> 
> which seems like a serious problem report to me. Do you get different output? If yes, what system
> are you doing this on and do you have a log handy?

Windows XP SP3. All tools as supplied by Cygwin.

See attached log.

Daniel James was able to reproduce the problem, but I'm unsure of the 
details.

> 
> Of course, producing an error right away, and in a clear wording is better, so I'll look at #2232,
> but we also need to figure what's different between our setups and causes silent error for you.

Thanks,

--Beman

warning: Graph library does not contain optional GraphML reader.
note: to enable GraphML support, set EXPAT_INCLUDE and EXPAT_LIBPATH to the
note: directories containing the Expat headers and libraries, respectively.
warning: skipping optional Message Passing Interface (MPI) library.
note: to enable MPI support, add "using mpi ;" to user-config.jam.
note: to suppress this message, pass "--without-mpi" to bjam.
note: otherwise, you can safely ignore this message.
WARNING: No python installation configured and autoconfiguration
         failed.  See http://www.boost.org/libs/python/doc/building.html
         for configuration instructions or pass --without-python to
         suppress this message and silently skip all Boost.Python targets
Building Boost.Regex with the optional Unicode/ICU support disabled.
Please refer to the Boost.Regex documentation for more information
(don't panic: this is a strictly optional feature).
warning: No toolsets are configured.
warning: Configuring default toolset "gcc".
warning: If the default is wrong, your build may not work correctly.
warning: Use the "--toolset=xxxxx" option to override our guess.
warning: For more configuration options, please consult
warning: http://boost.org/boost-build2/doc/html/bbv2/advanced/configuration.html
warn: Unable to construct ./standalone
...patience...
...found 1249 targets...
...updating 56 targets...
MkDir1-quick-fix-for-unix ../../../bin.v2
MkDir1-quick-fix-for-unix ../../../bin.v2/libs
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/mpi
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/mpi/doc
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/mpi/doc/gcc-3.4.4
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/mpi/doc/gcc-3.4.4/debug
MkDir1-quick-fix-for-unix ../../../bin.v2/tools
MkDir1-quick-fix-for-unix ../../../bin.v2/tools/quickbook
MkDir1-quick-fix-for-unix ../../../bin.v2/tools/quickbook/gcc-3.4.4
MkDir1-quick-fix-for-unix ../../../bin.v2/tools/quickbook/gcc-3.4.4/debug
MkDir1-quick-fix-for-unix ../../../bin.v2/tools/quickbook/gcc-3.4.4/debug/link-static
gcc.compile.c++ ../../../bin.v2/tools/quickbook/gcc-3.4.4/debug/link-static/quickbook.o
gcc.compile.c++ ../../../bin.v2/tools/quickbook/gcc-3.4.4/debug/link-static/actions.o
d:\boost\trunk\tools\quickbook\detail\actions.cpp: In function `std::pair<bool, __gnu_cxx::__normal_iterator<const std::string*, std::vector<std::string, std::allocator<std::string> > > > quickbook::<unnamed>::get_arguments(std::vector<std::string, std::allocator<std::string> >&, const std::vector<std::string, std::allocator<std::string> >&, const boost::spirit::file_position&, quickbook::actions&)':
d:\boost\trunk\tools\quickbook\detail\actions.cpp:558: warning: unused variable 'p'
gcc.compile.c++ ../../../bin.v2/tools/quickbook/gcc-3.4.4/debug/link-static/actions_class.o
gcc.compile.c++ ../../../bin.v2/tools/quickbook/gcc-3.4.4/debug/link-static/utils.o
gcc.compile.c++ ../../../bin.v2/tools/quickbook/gcc-3.4.4/debug/link-static/post_process.o
gcc.compile.c++ ../../../bin.v2/tools/quickbook/gcc-3.4.4/debug/link-static/collector.o
gcc.compile.c++ ../../../bin.v2/tools/quickbook/gcc-3.4.4/debug/link-static/template_stack.o
d:\boost\trunk\tools\quickbook\detail\/./template_stack.hpp: In constructor `quickbook::template_stack::template_stack()':
d:\boost\trunk\tools\quickbook\detail\/./template_stack.hpp:86: warning: `quickbook::template_stack::scopes' will be initialized after
d:\boost\trunk\tools\quickbook\detail\/./template_stack.hpp:81: warning:   `boost::spirit::functor_parser<quickbook::template_stack::parser> quickbook::template_stack::scope'
d:\boost\trunk\tools\quickbook\detail\template_stack.cpp:20: warning:   when initialized here
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/filesystem
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/filesystem/build
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/filesystem/build/gcc-3.4.4
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/filesystem/build/gcc-3.4.4/debug
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/filesystem/build/gcc-3.4.4/debug/link-static
gcc.compile.c++ ../../../bin.v2/libs/filesystem/build/gcc-3.4.4/debug/link-static/operations.o
gcc.compile.c++ ../../../bin.v2/libs/filesystem/build/gcc-3.4.4/debug/link-static/path.o
gcc.compile.c++ ../../../bin.v2/libs/filesystem/build/gcc-3.4.4/debug/link-static/portability.o
gcc.compile.c++ ../../../bin.v2/libs/filesystem/build/gcc-3.4.4/debug/link-static/utf8_codecvt_facet.o
gcc.archive ../../../bin.v2/libs/filesystem/build/gcc-3.4.4/debug/link-static/libboost_filesystem-gcc34-d-1_37.a
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/system
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/system/build
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/system/build/gcc-3.4.4
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/system/build/gcc-3.4.4/debug
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/system/build/gcc-3.4.4/debug/link-static
gcc.compile.c++ ../../../bin.v2/libs/system/build/gcc-3.4.4/debug/link-static/error_code.o
gcc.archive ../../../bin.v2/libs/system/build/gcc-3.4.4/debug/link-static/libboost_system-gcc34-d-1_37.a
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/program_options
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/program_options/build
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/program_options/build/gcc-3.4.4
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/program_options/build/gcc-3.4.4/debug
MkDir1-quick-fix-for-unix ../../../bin.v2/libs/program_options/build/gcc-3.4.4/debug/link-static
gcc.compile.c++ ../../../bin.v2/libs/program_options/build/gcc-3.4.4/debug/link-static/cmdline.o
gcc.compile.c++ ../../../bin.v2/libs/program_options/build/gcc-3.4.4/debug/link-static/config_file.o
gcc.compile.c++ ../../../bin.v2/libs/program_options/build/gcc-3.4.4/debug/link-static/options_description.o
gcc.compile.c++ ../../../bin.v2/libs/program_options/build/gcc-3.4.4/debug/link-static/parsers.o
gcc.compile.c++ ../../../bin.v2/libs/program_options/build/gcc-3.4.4/debug/link-static/variables_map.o
gcc.compile.c++ ../../../bin.v2/libs/program_options/build/gcc-3.4.4/debug/link-static/value_semantic.o
gcc.compile.c++ ../../../bin.v2/libs/program_options/build/gcc-3.4.4/debug/link-static/positional_options.o
gcc.compile.c++ ../../../bin.v2/libs/program_options/build/gcc-3.4.4/debug/link-static/utf8_codecvt_facet.o
gcc.compile.c++ ../../../bin.v2/libs/program_options/build/gcc-3.4.4/debug/link-static/convert.o
gcc.compile.c++ ../../../bin.v2/libs/program_options/build/gcc-3.4.4/debug/link-static/winmain.o
gcc.archive ../../../bin.v2/libs/program_options/build/gcc-3.4.4/debug/link-static/libboost_program_options-gcc34-d-1_37.a
gcc.link ../../../bin.v2/tools/quickbook/gcc-3.4.4/debug/link-static/quickbook.exe
quickbook.quickbook-to-boostbook ../../../bin.v2/libs/mpi/doc/gcc-3.4.4/debug/mpi.xml
Generating Output File: ../../../bin.v2/libs/mpi/doc/gcc-3.4.4/debug/mpi.xml
D:\boost\trunk\libs\mpi\doc\mpi.qbk:1: warning: Warning: Quickbook version undefined. Version 1.1 is assumed
...updated 56 targets...