STEllAR-GROUP / hpxcl

This repository contains components that will support percolation via OpenCL and CUDA
Boost Software License 1.0
32 stars 17 forks source link

Publish doc automatically #32

Closed diehlpk closed 8 years ago

diehlpk commented 8 years ago

diehl@ossus:/home/diehl/git/hpxcl/build$ make docs VERBOSE=1 /mnt.auto/opt64/packages/cmake-3.3.0/bin/cmake -H/home/diehl/git/hpxcl -B/home/diehl/git/hpxcl/build --check-build-system CMakeFiles/Makefile.cmake 0 Re-run cmake, missing byproduct: docs/CMakeFiles/CMakeDirectoryInformation.cmake -- Using tcmalloc allocator. -- doxygen Creating /home/diehl/git/hpxcl/build/docs/hpxcl_autodoc.doxy -- Configuring done -- Generating done -- Build files have been written to: /home/diehl/git/hpxcl/build make -f CMakeFiles/Makefile2 docs make[1]: Entering directory /home/diehl/git/hpxcl/build' /mnt.auto/opt64/packages/cmake-3.3.0/bin/cmake -H/home/diehl/git/hpxcl -B/home/diehl/git/hpxcl/build --check-build-system CMakeFiles/Makefile.cmake 0 /mnt.auto/opt64/packages/cmake-3.3.0/bin/cmake -E cmake_progress_start /home/diehl/git/hpxcl/build/CMakeFiles 6 make -f CMakeFiles/Makefile2 docs/CMakeFiles/docs.dir/all make[2]: Entering directory/home/diehl/git/hpxcl/build' make -f docs/CMakeFiles/docs.dir/build.make docs/CMakeFiles/docs.dir/depend make[3]: Entering directory /home/diehl/git/hpxcl/build' cd /home/diehl/git/hpxcl/build && /mnt.auto/opt64/packages/cmake-3.3.0/bin/cmake -E cmake_depends "Unix Makefiles" /home/diehl/git/hpxcl /home/diehl/git/hpxcl/docs /home/diehl/git/hpxcl/build /home/diehl/git/hpxcl/build/docs /home/diehl/git/hpxcl/build/docs/CMakeFiles/docs.dir/DependInfo.cmake --color= Dependee "/home/diehl/git/hpxcl/build/docs/CMakeFiles/docs.dir/DependInfo.cmake" is newer than depender "/home/diehl/git/hpxcl/build/docs/CMakeFiles/docs.dir/depend.internal". Dependee "/home/diehl/git/hpxcl/build/docs/CMakeFiles/CMakeDirectoryInformation.cmake" is newer than depender "/home/diehl/git/hpxcl/build/docs/CMakeFiles/docs.dir/depend.internal". Scanning dependencies of target docs make[3]: Leaving directory/home/diehl/git/hpxcl/build' make -f docs/CMakeFiles/docs.dir/build.make docs/CMakeFiles/docs.dir/build make[3]: Entering directory /home/diehl/git/hpxcl/build' [ 16%] Generating Doxygen. cd /home/diehl/git/hpxcl/build/docs && /usr/bin/doxygen /home/diehl/git/hpxcl/build/docs/hpxcl_autodoc.doxy Notice: Output directory/home/diehl/git/hpxcl/build/docs/doxygen' does not exist. I have created it for you. Searching for include files... Searching for example files... Searching for files in directory /home/diehl/git/hpxcl/examples/cuda Searching for files in directory /home/diehl/git/hpxcl/examples/opencl Searching for images... Searching for dot files... Searching for msc files... Searching for files to exclude Searching for files to process... Reading and parsing tag files Preprocessing /home/diehl/git/hpxcl/cuda/buffer.hpp... Parsing file /home/diehl/git/hpxcl/cuda/buffer.hpp... Preprocessing /home/diehl/git/hpxcl/cuda/device.hpp... Parsing file /home/diehl/git/hpxcl/cuda/device.hpp... Preprocessing /home/diehl/git/hpxcl/cuda/get_devices.hpp... Parsing file /home/diehl/git/hpxcl/cuda/get_devices.hpp... Preprocessing /home/diehl/git/hpxcl/cuda/program.hpp... Parsing file /home/diehl/git/hpxcl/cuda/program.hpp... Preprocessing /home/diehl/git/hpxcl/hpxcl/cuda.hpp... Parsing file /home/diehl/git/hpxcl/hpxcl/cuda.hpp... Building group list... Building directory list... Building namespace list... Building file list... Building class list... Associating documentation with classes... Computing nesting relations for classes... Building example list... Searching for enumerations... Searching for documented typedefs... Searching for members imported via using declarations... Searching for included using directives... Searching for documented variables... Building member list... Searching for friends... Searching for documented defines... Computing class inheritance relations... Computing class usage relations... Flushing cached template relations that have become invalid... Creating members for template instances... Computing class relations... Add enum values to enums... Searching for member function documentation... Building page list... Search for main page... Computing page relations... Determining the scope of groups... Sorting lists... Freeing entry tree Determining which enums are documented Computing member relations... Building full member lists recursively... Adding members to member groups. Computing member references... Inheriting documentation... Generating disk names... Adding source references... Adding xrefitems... Sorting member lists... Generating citations page... Counting data structures... Resolving user defined references... Finding anchors and sections in the documentation... Combining using relations... Adding members to index pages... Generating style sheet... Generating search indices... Generating example documentation... Generating docs for example build_kernel.cpp... Generating docs for example build_kernel_from_file.cpp... Generating docs for example cuda_list_devices.cpp... Generating docs for example streams.cpp... Generating file sources... Generating code for file /home/diehl/git/hpxcl/cuda/buffer.hpp... Generating code for file /home/diehl/git/hpxcl/cuda/device.hpp... Generating code for file /home/diehl/git/hpxcl/cuda/get_devices.hpp... Generating code for file /home/diehl/git/hpxcl/cuda/program.hpp... Generating code for file /home/diehl/git/hpxcl/hpxcl/cuda.hpp... Generating file documentation... Generating page documentation... Generating group documentation... Generating class documentation... Generating namespace index... Generating docs for compound hpx::cuda::buffer... /home/diehl/git/hpxcl/cuda/buffer.hpp:29: warning: Member buffer(hpx::future< hpx::naming::id_type > &&gid) (function) of class hpx::cuda::buffer is not documented. /home/diehl/git/hpxcl/cuda/buffer.hpp:46: warning: Member size_sync() (function) of class hpx::cuda::buffer is not documented. /home/diehl/git/hpxcl/cuda/buffer.hpp:66: warning: Member set_size_sync(size_t size) (function) of class hpx::cuda::buffer is not documented. Generating docs for compound hpx::cuda::device... /home/diehl/git/hpxcl/cuda/device.hpp:29: warning: Member device(hpx::naming::id_type const &there, int dev) (function) of class hpx::cuda::device is not documented. /home/diehl/git/hpxcl/cuda/device.hpp:33: warning: Member device(hpx::future< hpx::naming::id_type > &&gid) (function) of class hpx::cuda::device is not documented. /home/diehl/git/hpxcl/cuda/device.hpp:95: warning: Member set_device(int dev) (function) of class hpx::cuda::device is not documented. /home/diehl/git/hpxcl/cuda/device.hpp:101: warning: Member get_device_id() (function) of class hpx::cuda::device is not documented. /home/diehl/git/hpxcl/cuda/device.hpp:107: warning: Member get_device_id_sync() (function) of class hpx::cuda::device is not documented. /home/diehl/git/hpxcl/cuda/device.hpp:112: warning: Member get_context() (function) of class hpx::cuda::device is not documented. /home/diehl/git/hpxcl/cuda/device.hpp:118: warning: Member get_context_sync() (function) of class hpx::cuda::device is not documented. /home/diehl/git/hpxcl/cuda/device.hpp:123: warning: Member wait() (function) of class hpx::cuda::device is not documented. /home/diehl/git/hpxcl/cuda/device.hpp:152: warning: argument 'source' of command @param is not found in the argument list of hpx::cuda::device::create_program_with_file(std::string file) /home/diehl/git/hpxcl/cuda/device.hpp:152: warning: The following parameters of hpx::cuda::device::create_program_with_file(std::string file) are not documented: parameter 'file' Generating docs for compound hpx::cuda::program... /home/diehl/git/hpxcl/cuda/program.hpp:37: warning: Member program(hpx::future< hpx::naming::id_type > &&gid) (function) of class hpx::cuda::program is not documented. /home/diehl/git/hpxcl/cuda/program.hpp:77: warning: Member build(std::vector< std::string > compilerFlags, std::string modulename, unsigned int debug=0) (function) of class hpx::cuda::program is not documented. /home/diehl/git/hpxcl/cuda/program.hpp:185: warning: Member run(std::vector< hpx::cuda::buffer > args, std::string modulename, hpx::cuda::server::program::Dim3 grid, hpx::cuda::server::program::Dim3 block, hpx::cuda::buffer dependency, int stream=-1) (function) of class hpx::cuda::program is not documented. /home/diehl/git/hpxcl/cuda/program.hpp:40: warning: argument 'modulename' of command @param is not found in the argument list of hpx::cuda::program::build(std::vector< std::string > compilerFlags, std::vector< std::string > modulenames, unsigned int debug=0) /home/diehl/git/hpxcl/cuda/program.hpp:40: warning: The following parameters of hpx::cuda::program::build(std::vector< std::string > compilerFlags, std::vector< std::string > modulenames, unsigned int debug=0) are not documented: parameter 'modulenames' Generating graph info page... Generating index page... Generating page index... Generating module index... Generating namespace index... Generating namespace member index... Generating annotated compound index... Generating alphabetical compound index... Generating hierarchical class index... Generating member index... Generating file index... Generating file member index... Generating example index... finalizing index lists... Generating XML output... Generating XML output for class hpx::cuda::buffer Generating XML output for class hpx::cuda::device /home/diehl/git/hpxcl/cuda/device.hpp:152: warning: argument 'source' of command @param is not found in the argument list of hpx::cuda::device::create_program_with_file(std::string file) /home/diehl/git/hpxcl/cuda/device.hpp:152: warning: The following parameters of hpx::cuda::device::create_program_with_file(std::string file) are not documented: parameter 'file' Generating XML output for class hpx::cuda::program /home/diehl/git/hpxcl/cuda/program.hpp:40: warning: argument 'modulename' of command @param is not found in the argument list of hpx::cuda::program::build(std::vector< std::string > compilerFlags, std::vector< std::string > modulenames, unsigned int debug=0) /home/diehl/git/hpxcl/cuda/program.hpp:40: warning: The following parameters of hpx::cuda::program::build(std::vector< std::string > compilerFlags, std::vector< std::string > modulenames, unsigned int debug=0) are not documented: parameter 'modulenames' Generating XML output for namespace hpx Generating XML output for namespace hpx::cuda Generating XML output for file buffer.hpp Generating XML output for file device.hpp Generating XML output for file get_devices.hpp Generating XML output for file program.hpp Generating XML output for file cuda.hpp Generate XML output for dir /home/diehl/git/hpxcl/cuda/ Generate XML output for dir /home/diehl/git/hpxcl/hpxcl/ Generating XML output for example build_kernel.cpp Generating XML output for example build_kernel_from_file.cpp Generating XML output for example cuda_list_devices.cpp Generating XML output for example streams.cpp symbol cache used 48/65536 hits=1964 misses=48 lookup cache used 103/65536 hits=532 misses=103 finished... [ 33%] Generating hpxcl_autodoc.doxygen.xml cd /home/diehl/git/hpxcl/build/docs && /mnt.auto/opt64/packages/cmake-3.3.0/bin/cmake -DXSLTPROC=/usr/bin/xsltproc -P /home/diehl/git/hpxcl/build/docs/hpxcl_autodoc_doxygen_xml.cmake [ 50%] Generating hpxcl_autodoc.xml cd /home/diehl/git/hpxcl/build/docs && /mnt.auto/opt64/packages/cmake-3.3.0/bin/cmake -DXSLTPROC=/usr/bin/xsltproc -P /home/diehl/git/hpxcl/build/docs/hpxcl_autodoc_xml.cmake [ 66%] Generating BoostBook XML file hpxcl.xml from hpxcl.qbk. [ 83%] Generating hpxcl.dbk cd /home/diehl/git/hpxcl/build/docs && /mnt.auto/opt64/packages/cmake-3.3.0/bin/cmake -DXSLTPROC=/usr/bin/xsltproc -P /home/diehl/git/hpxcl/build/docs/hpxcl_dbk.cmake warning: failed to load external entity "hpxcl.xml" unable to parse hpxcl.xml CMake Error at hpxcl_dbk.cmake:17 (message): xsltproc returned 6

make[3]: * [docs/hpxcl.dbk] Error 1 make[3]: Leaving directory /home/diehl/git/hpxcl/build' make[2]: *** [docs/CMakeFiles/docs.dir/all] Error 2 make[2]: Leaving directory/home/diehl/git/hpxcl/build' make[1]: *\ [docs/CMakeFiles/docs.dir/rule] Error 2 make[1]: Leaving directory `/home/diehl/git/hpxcl/build' make: * [docs] Error 2

diehlpk commented 8 years ago

Where is this warning coming from warning: failed to load external entity "hpxcl.xml"?

Where should hpxcl.xml be generated?

diehlpk commented 8 years ago

After including find_package(BoostAutoIndex) and specifying the path to auto_index following error appears

CMake Error at /home/diehl/git/hpx/cmake/FindXSLTPROC.cmake:100 (list): list index: 1 out of range (-1, 0) Call Stack (most recent call first): /home/diehl/git/hpx/cmake/HPX_Documentation.cmake:138 (xsltproc) /home/diehl/git/hpx/cmake/HPX_Documentation.cmake:258 (hpx_boostbook_to_docbook) docs/CMakeLists.txt:113 (hpx_quickbook_to_html)

CMake Error at /home/diehl/git/hpx/cmake/FindXSLTPROC.cmake:100 (list): list index: 1 out of range (-1, 0) Call Stack (most recent call first): /home/diehl/git/hpx/cmake/HPX_Documentation.cmake:138 (xsltproc) /home/diehl/git/hpx/cmake/HPX_Documentation.cmake:258 (hpx_boostbook_to_docbook) docs/CMakeLists.txt:113 (hpx_quickbook_to_html)

CMake Error at /home/diehl/git/hpx/cmake/FindXSLTPROC.cmake:100 (list): list index: 1 out of range (-1, 0) Call Stack (most recent call first): /home/diehl/git/hpx/cmake/HPX_Documentation.cmake:138 (xsltproc) /home/diehl/git/hpx/cmake/HPX_Documentation.cmake:258 (hpx_boostbook_to_docbook) docs/CMakeLists.txt:113 (hpx_quickbook_to_html)

diehlpk commented 8 years ago

Removing find_package(BoostAutoIndex) delievers the first error message.

diehlpk commented 8 years ago

Bug was because of too old versions for the tools for building the documentation

diehlpk commented 8 years ago

Minimal documentation is generated for HPXCL.